ページ番号の「書式」を制御せよ:セクションを跨ぐ動的コントロールの設計思想
業務自動化の現場で、クライアントから最も頻繁に、かつ最も厄介な要求として飛んでくるものの一つが「文書の構造(セクション)に応じて、ページ番号の見た目を制御したい」という要望だ。
「セクション1はArialの10pt、セクション2はMS明朝の12pt、セクション3はページ番号なし」といった指示。これに対し、初心者は「全ページをループして、ページ番号を探して、フォントを変える」という、極めて非効率で壊れやすいコードを書き始める。
断言する。それは「設計」ではなく、単なる「力技」だ。
Wordのオブジェクトモデルにおける「ページ番号」の正体は、単なる数字ではない。それは、ヘッダーやフッターという特定の`StoryRange`内に埋め込まれた、`Field`オブジェクト(`wdFieldPage`)である。このオブジェクトのライフサイクルと、セクション間の「リンク(LinkToPrevious)」という概念を理解していない限り、君が書いたコードは、予期せぬ箇所を書き換え、あるいは書き換えに失敗して、顧客の信頼を失うことになるだろう。
本稿では、プロフェッショナルとして、堅牢かつ高速にセクションごとのページ番号書式を一括制御するための、極限の設計手法を伝授する。
1. 失敗する設計と、勝利する設計の境界線
なぜ、単純なループ処理は失敗するのか。理由は大きく分けて3つある。
① StoryRangeの多層構造を無視している
Wordの文書は、本文(MainText)だけでなく、ヘッダー、フッター、テキストボックスといった複数の「ストーリー」で構成されている。ページ番号は「フッター」というストーリーの中に存在しており、セクションごとにそのストーリーの構成(初頁のみ別、奇数/偶数ページ別)が異なる。これを無視して本文の範囲だけで探そうとしても、ページ番号には一生辿り着けない。
② 「前と同じ」という罠(LinkToPrevious)
これが最大のバグ要因だ。セクションが「前のセクションとリンク」している場合、あるセクションのヘッダーを操作したつもりが、前のセクションまで書き換わってしまう。あるいは、リンクを解除(`LinkToPrevious = False`)するタイミングを誤ると、書式が意図しないセクションまで伝播する。
③ 計算量の爆発
ページごとにループを回す設計は、$O(Pages)$ の計算量になる。数千ページの文書では、画面更新の停止(`ScreenUpdating = False`)だけでは不十分だ。我々が狙うべきは、セクション単位、つまり $O(Sections)$ の操作である。
2. プロダクション・アーキテクチャ:設計指針
堅牢なツールを作るための設計原則を定義する。
1. 設定の分離 (Separation of Concerns): 書式情報(フォント名、サイズ、色)をロジックの中にハードコードしない。外部ファイルや、構造体(Type)として定義し、ロジックを「指示」から「実行」へと分離せよ。
2. 冪等性 (Idempotency) の確保: 何度実行しても、同じ状態になるように設計せよ。
3. エラーハンドリングの徹底: セクションが存在しない、あるいはフィールドが見つからないといった例外に対して、プログラムをクラッシュさせるのではなく、適切にスキップまたは通知する仕組みを持たせよ。
3. 実装:セクション別ページ番号制御エンジン
以下に、実務でそのまま利用可能な、極めて堅牢な設計のコードを示す。ここでは、セクションごとの書式設定を管理するためのカスタム型(`Type`)を導入している。
Option Explicit
' ==============================================================================
' 構成定義: セクションごとの書式設定を保持する構造体
' プロダクション環境では、これをExcelやJSONから読み込むように拡張すべきである。
' ==============================================================================
Private Type SectionFormat
TargetSection As Integer ' 対象セクション番号
FontName As String ' フォント名
FontSize As Single ' フォントサイズ
ShowPageNumber As Boolean ' ページ番号を表示するかどうか
End Type
' ==============================================================================
' メインルーチン: セクションごとのページ番号書式を一括適用する
' ==============================================================================
Public Sub ApplySectionBasedPageNumbering()
Dim doc As Document
Set doc = ActiveDocument
' 1. 設定の初期化 (本来は外部からロードする)
Dim configs() As SectionFormat
ReDim configs(1 To 2) ' 例として2セクション分
' セクション1の設定
configs(1).TargetSection = 1
configs(1).FontName = "Arial"
configs(1).FontSize = 10
configs(1).ShowPageNumber = True
' セクション2の設定
configs(2).TargetSection = 2
configs(2).FontName = "MS Mincho"
configs(2).FontSize = 14
configs(2).ShowPageNumber = True
' 2. パフォーマンス最適化の開始
On Error GoTo ErrorHandler
Application.ScreenUpdating = False
Application.Calculation = xlCalculationAutomatic ' Excel連携時などの考慮
Dim i As Integer
Dim secIdx As Integer
Dim currentConfig As SectionFormat
' 3. セクションごとのループ処理
' 計算量は O(Sections) であり、極めて高速
For i = 1 To doc.Sections.Count
' 現在のセクションに対応する設定があるか確認
currentConfig = GetConfigForSection(i, configs)
' セクションの制御実行
ProcessSectionPageNumber doc.Sections(i), currentConfig
Next i
MsgBox "書式設定が完了しました。", vbInformation
CleanUp:
Application.ScreenUpdating = True
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
' ==============================================================================
' 内部ロジック: 特定のセクションのヘッダー・フッターを精密に操作する
' ==============================================================================
Private Sub ProcessSection(sec As Section, cfg As SectionFormat)
Dim hf As HeaderFooter
Dim fld As Field
Dim targetRange As Range
' ヘッダー・フッターの全種類(Primary, FirstPage, EvenPages)を走査
' セクション内のすべての「ストーリー」を網羅することが重要
For Each hf In sec.Headers
' リンク解除の判断:
' 意図的に前のセクションと切り離す必要がある場合はここで制御する
' ただし、既存の構造を壊さないよう慎重に行うこと
' hf.LinkToPrevious = False
ApplyFormatToFooterField hf, cfg
Next hf
For Each hf In sec.Footers
ApplyFormatToFooterField hf, cfg
Next hf
End Sub
' ==============================================================================
' 内部ロジック: ヘッダー/フッター内のフィールドを特定し、書式を適用する
' ==============================================================================
Private Sub ApplyFormatToFooterField(hf As HeaderFooter, cfg As SectionFormat)
Dim fld As Field
' ページ番号(wdFieldPage)のみを対象とする
' 他のフィールド(日付やファイル名など)を破壊しないためのガード
For Each fld In hf.Range.Fields
If fld.Type = wdFieldPage Then
If cfg.ShowPageNumber Then
' フィールドの範囲(Range)に対して直接書式を適用
With fld.Result.Font
.Name = cfg.FontName
.Size = cfg.FontSize
End With
Else
' 表示しない場合は、フィールドをクリアするか、非表示にする
' ここでは安全のため、テキストをクリアする手法をとる
fld.Result.Text = ""
End If
End If
Next fld
End Sub
' ==============================================================================
' ヘルパー関数: 設定リストから該当セクションの設定を取得
' ==============================================================================
Private Function GetConfigForSection(secIdx As Integer, configs() As SectionFormat) As SectionFormat
Dim c As Variant
' デフォルト値の設定
Dim defaultConfig As SectionFormat
defaultConfig.TargetSection = secIdx
defaultConfig.FontName = "Calibri"
defaultConfig.FontSize = 11
defaultConfig.ShowPageNumber = True
' 設定リストを検索
Dim i As Integer
For i = LBound(configs) To UBound(configs)
If configs(i).TargetSection = secIdx Then
GetConfigForSection = configs(i)
Exit Function
End If
Next i
GetConfigForSection = defaultConfig
End Function
4. アーキテクトの視点:データベース・外部ファイル連携における注意点
このコードをさらに大規模な業務システムへと昇華させる場合、設定値(`SectionFormat`)をどこに置くかが鍵となる。
Excel/CSV連携の設計
大量のテンプレートを扱う場合、設定をExcelシートに集約するのが定石だ。
- 注意点: Excelから値を取得する際、セクション番号が「存在しない番号」を指していないか、フォント名が「システムにインストールされているか」を、Word側で実行する前にバリデーション(検証)するレイヤーを設けること。
データベース(SQL Server/Access)連携
エンタープライズ用途では、設定をDBで管理する。
- 注意点: API経由で設定を取得する場合、ネットワーク遅延がループ内に入り込まないようにせよ。「DBから全設定を一括取得 $\rightarrow$ メモリ上のコレクション(Array/Dictionary)に格納 $\rightarrow$ Word操作」という順序を徹底すること。ループの中でSQLを叩くような真似は、パフォーマンスの自殺行為だ。
結論
Word VBAにおけるセクション操作は、一見すると単純な「見た目の変更」に見える。しかし、その裏側にはオブジェクトの階層構造、ストーリーの分離、そしてセクション間のリンクという、複雑な仕様が隠されている。
「動けばいい」コードを書く者は、バグの温床となる。
「構造を理解し、例外を制御し、計算量を最適化する」コードを書く者こそが、真の自動化エンジニアである。
この設計思想を、君の武器にせよ。
