【テクニカル・上級編】セクションごとのページ番号のフォント・サイズを一括変更する – Word VBA解析バイブル

スポンサーリンク
スポンサーリンク

ページ番号という「動的フィールド」を支配する:Word COMオブジェクトのライフサイクルと精密制御

文書自動化の現場において、多くの開発者が「Word VBAは制御が難しい」という言葉を口にする。その正体は、Wordが単なるテキストエディタではなく、極めて複雑なCOM(Component Object Model)オブジェクトの階層構造によって構築されている点にある。

特に、セクションごとに独立したヘッダー・フッター、そしてその中に潜む「ページ番号」というField(フィールド)オブジェクトの操作は、初学者が必ずと言っていいほど躓くポイントだ。単に `Selection.Font.Size` を書き換えても、ページ番号は動的な計算結果(Field Code)であるため、書式が反映されない、あるいは予期せぬセクションまで書き換わってしまうといった事象が発生する。

本稿では、シニアエンジニアが実戦で直面する「セクションごとのページ番号書式の一括制御」をテーマに、メモリ管理、オブジェクトのライフサイクル、そして確実に書式を注入するためのアーキテクチャを解説する。

1. Wordの階層構造における「ページ番号」の正体

ページ番号は、テキストではない。それは `wdFieldPage` という型を持つ Fieldオブジェクト である。
このフィールドは、`Section` → `HeaderFooter` → `Range` という階層の中に格納されている。

多くのエンジニアが犯すミスは、`ActiveDocument.Sections(i).Headers(wdHeaderFooterPrimary).Range.Font.Size = 12` と記述することだ。これでは、ヘッダー内の「全てのテキスト」に影響を与えてしまい、ページ番号だけを狙い撃つことができない。

我々が目指すべきは、「特定のセクションの、特定のヘッダー/フッター内にある、PAGEフィールドのみを特定し、そのRangeに対して書式プロパティを適用する」という極めて精密な操作である。

2. メモリリークを防ぐオブジェクトのライフサイクル管理

Word VBAをサーバーサイド(あるいはバックグラウンドプロセス)で動作させる場合、最も恐ろしいのはゾンビプロセス(残存したWinword.exe)である。

COMオブジェクトをループ内で大量に生成すると、参照カウントが適切に減少しず、メモリ上にオブジェクトが残留する。これを防ぐためには、以下の原則を徹底しなければならない。

1. 明示的な解放: `Set obj = Nothing` を、オブジェクトのスコープが終了する直前に必ず実行する。
2. 最小限の参照範囲: `Document` や `Section` オブジェクトをグローバル変数に保持せず、メソッドのローカル変数として扱い、使い終わったら即座に破棄する。
3. エラーハンドリングの徹底: エラー発生時に制御が脱出した際も、確実に解放処理を通る `On Error GoTo CleanUp` パターンを採用する。

3. 実装:セクション別ページ番号書式制御エンジン

以下に、プロフェッショナルな現場でそのまま投入可能な、堅牢な実装例を示す。このコードは、単なるループではなく、各ストーリーレンジ(StoryRanges)を走査し、フィールドの型を判定するロジックを組み込んでいる。

Option Explicit

''' <summary>
''' セクションごとにページ番号の書式を一括制御する
''' </summary>
''' <param name="targetDoc">対象となるDocumentオブジェクト</param>
''' <param name="fontSize">適用するフォントサイズ</param>
''' <param name="fontName">適用するフォント名</param>
Public Sub ApplySectionalPageNumberFormat(ByRef targetDoc As Document, _
                                         ByVal fontSize As Single, _
                                         ByVal fontName As String)
    
    Dim sec As Section
    Dim hf As HeaderFooter
    Dim fld As Field
    Dim rng As Range
    
    ' パフォーマンス最適化: 画面更新と再計算を停止
    ' これにより、大規模文書における描画コストを劇的に削減する
    On Error GoTo ErrorHandler
    Application.ScreenUpdating = False
    
    ' 各セクションを走査
    For Each sec In targetDoc.Sections
        
        ' ヘッダーとフッターの両方を走査(wdHeaderFooterPrimary, wdHeaderFooterEvenPages, etc.)
        ' セクションの設定(奇数/偶数ページ別など)に依存するため、全てのHeaderFooterを対象とする
        For Each hf In sec.Headers
            Call ProcessHeaderFooter(hf, fontSize, fontName)
        Next hf
        
        For Each hf In sec.Footers
            Call ProcessHeaderFooter(hf, fontSize, fontName)
        Next hf
        
    Next sec

CleanUp:
    ' リソースの解放と設定の復元
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    ' 実運用環境では、ここでログ出力やWindows Event Logへの書き込みを行う
    Debug.Print "Error in ApplySectionalPageNumberFormat: " & Err.Description
    Resume CleanUp
End Sub

''' <summary>
''' ヘッダー/フッター内のPAGEフィールドを特定し、書式を適用する内部メソッド
''' </summary>
Private Sub ProcessHeaderFooter(ByRef hf As HeaderFooter, _
                               ByVal fSize As Single, _
                               ByVal fName As String)
    Dim fld As Field
    
    ' ヘッダー/フッター内のフィールドを走査
    ' Rangeオブジェクトを直接操作するのではなく、Fieldsコレクションを介するのが定石
    For Each fld In hf.Range.Fields
        ' フィールドの型が PAGE (wdFieldPage) であることを厳密に判定
        If fld.Type = wdFieldPage Then
            With fld.Result.Font
                .Size = fSize
                .Name = fName
                ' 必要に応じて太字設定などもここで制御
            End With
        End If
    Next fld
    
    ' メモリ管理: 参照を明示的に解除
    Set fld = Nothing
End Sub

アーキテクトの視点:なぜ `fld.Result.Font` なのか?

ここで `fld.Code.Font` ではなく `fld.Result.Font` を使用している点に注目してほしい。
`Code` は `{ PAGE }` というフィールドコードそのものを指し、`Result` は実際に文書上に表示されている「1」や「2」といった計算結果を指す。書式を適用すべきなのは、ユーザーの目に触れる「結果」のレイヤーである。

4. システム間連携とレガシー環境への配慮

このロジックを、VB.NET や C# から COM Automation 経由で呼び出す場合、さらに注意が必要となる。

1. STA (Single Threaded Apartment) モデル: WordはSTAモデルで動作する。外部プロセスから操作する場合、スレッドモデルが不一致だとデッドロックや `RPC_E_WRONG_THREAD` エラーが発生する。
2. Windows API による強制終了の回避:
VBA側で `Set obj = Nothing` を忘れた場合、プロセスが残る。これを防ぐために、外部の管理プログラム(C#等)からは、`Process.GetProcessesByName(“WINWORD”)` を監視し、一定時間内に終了しないプロセスを `Kill()` する仕組みを併用するのが、インフラレベルでの「防衛策」となる。

// C# からのプロセス管理イメージ(概念)
var processes = Process.GetProcessesByName("WINWORD");
foreach (var proc in processes) {
    if (proc.StartTime < DateTime.Now.AddMinutes(-5)) {
        proc.Kill(); // 5分以上滞留しているゾンビプロセスを強制排除
    }
}

結論

Word VBAにおける高度な自動化は、単なる「操作の記録」の延長線上にはない。それは、オブジェクトの階層構造を理解し、メモリのライフサイクルを制御し、COMの挙動を予測するという、極めて低レイヤーに近い思考を要求する。

ページ番号一つを書き換えるにしても、それが「フィールド」という動的な存在であることを認識し、適切なRangeに対して操作を仕掛ける。この「精密さ」こそが、プロフェッショナルなエンジニアと、単なるスクリプト作成者を分かつ境界線である。

タイトルとURLをコピーしました