【入門編】セクションごとに異なるヘッダーの「前と同じ」状態をVBAで一括可視化する監査レポート作成術 – Word VBA解析バイブル

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

見えない「繋がり」を可視化する:Word VBAで実現するヘッダー監査レポート作成術

「ヘッダーを修正したはずなのに、なぜか特定のページだけ変わっていない……」
「セクション区切りを入れた瞬間、文書全体のレイアウトが崩れてしまった……」

Wordで大規模な文書を作成していると、必ずと言っていいほど直面するこの問題。その正体は、セクションごとに設定されている「前と同じ(Link to Previous)」という、目に見えない「リンク状態」の複雑な絡み合いにあります。

マクロの記録機能だけでは、この「構造的な繋がり」を制御することはできません。今回は、文書の設計図を読み解くように、全セクションのヘッダー状態を一括で抽出し、Excelへ出力する「監査レポート作成ツール」の開発を通じて、Word VBAの真髄へと足を踏み入れてみましょう。

ここをクリアすれば、Word VBAのオブジェクトモデルの理解は、格段に深まるはずですよ。

1. なぜ「リンク状態」の確認が難しいのか?

Wordの文書構造は、単なる「ページの集まり」ではありません。正確には、「セクション」という入れ物の中に、「ヘッダー・フッター」という属性が格納されているという階層構造を持っています。

特に厄介なのが、一つのセクション内には以下の3種類のヘッダーが存在し得る点です。

1. Primary(主ヘッダー): 通常のページ用
2. First Page(先頭ページ用): 章の始まりなど、特別なヘッダー
3. Even Page(奇数/偶数ページ用): 見開き印刷用

「前と同じ」の設定は、これら一つひとつに対して独立して存在します。人間が目で一つずつ確認するのは限界がありますし、見落としは致命的なミスに繋がります。だからこそ、「プログラムに構造をスキャンさせる」という考え方が必要なのです。

2. 武器となるコード:ヘッダー監査エンジン

それでは、実際に動くコードを見てみましょう。このコードは、WordからExcelを自動操作し、文書内の全セクションと、各ヘッダーのリンク状態を一覧表にします。

Option Explicit

''' <summary>
''' 文書内の全セクションのヘッダーリンク状態をExcelに書き出す監査ツール
''' </summary>
Sub ExportHeaderLinkStatusReport()
    Dim doc As Document
    Dim sec As Section
    Dim hf As HeaderFooter
    Dim xlApp As Object ' Excel.Application
    Dim xlWB As Object  ' Excel.Workbook
    Dim xlSheet As Object ' Excel.Worksheet
    Dim row As Long
    
    Set doc = ActiveDocument
    
    ' --- 1. Excelの準備 ---
    On Error Resume Next
    Set xlApp = GetObject(Class:="Excel.Application")
    If xlApp Is Nothing Then
        Set xlApp = CreateObject("Excel.Application")
    End If
    On Error GoTo 0
    
    xlApp.Visible = True
    Set xlWB = xlApp.Workbooks.Add
    Set xlSheet = xlWB.Sheets(1)
    
    ' --- 2. ヘッダー(見出し)の作成 ---
    With xlSheet
        .Cells(1, 1).Value = "セクション番号"
        .Cells(1, 2).Value = "ヘッダーの種類"
        .Cells(1, 3).Value = "前と同じ (LinkToPrevious)"
        .Cells(1, 4).Value = "ヘッダーの内容(抜粋)"
        ' 見出しを太字にする
        .Range("A1:D1").Font.Bold = True
    End With
    
    row = 2
    
    ' --- 3. 文書の巡回(ここがエンジニアの腕の見せ所) ---
    ' 画面更新を停止してパフォーマンスを向上させる
    Application.ScreenUpdating = False
    
    For Each sec In doc.Sections
        ' 各セクション内のヘッダーをループ
        ' wdHeaderFooterPrimary (1), wdHeaderFooterFirstPage (2), wdHeaderFooterEvenPages (3)
        For Each hf In sec.Headers
            
            ' Excelへ情報を書き出し
            xlSheet.Cells(row, 1).Value = "Section " & sec.Index
            xlSheet.Cells(row, 2).Value = GetHeaderTypeName(hf.Type)
            
            ' 【重要】LinkToPrevious プロパティの取得
            ' これが True なら「前と同じ」、False なら「独立している」
            xlSheet.Cells(row, 3).Value = hf.LinkToPrevious
            
            ' ヘッダーの中身が空でない場合にテキストを一部抽出
            If hf.Exists Then
                xlSheet.Cells(row, 4).Value = Left(hf.Range.Text, 30) ' 最初の30文字
            Else
                xlSheet.Cells(row, 4).Value = "(空)"
            End If
            
            row = row + 1
        Next hf
    Next sec
    
    ' --- 4. 後処理 ---
    Application.ScreenUpdating = True
    xlSheet.Columns("A:D").AutoFit ' 列幅の自動調整
    
    MsgBox "監査レポートの作成が完了しました!", vbInformation, "完了"
    
    ' オブジェクトの解放
    Set xlSheet = Nothing
    Set xlWB = Nothing
    Set xlApp = Nothing
End Sub

''' <summary>
''' ヘッダー種別を分かりやすい文字列に変換するヘルパー関数
''' </summary>
Private Function GetHeaderTypeName(headerType As Long) As String
    Select Case headerType
        Case 1: GetHeaderTypeName = "主ヘッダー"
        Case 2: GetHeaderTypeName = "先頭ページ用"
        Case 3: GetHeaderTypeName = "奇数/偶数ページ用"
        Case Else: GetHeaderTypeName = "不明"
    End Select
End Function

3. コードの深層解剖:プロの視点

このコードには、単なる「記録マクロ」にはない、設計上の重要なポイントが3つ含まれています。

① オブジェクトの階層を辿る(Traversing)

`For Each sec In doc.Sections` の中に、さらに `For Each hf In sec.Headers` という二重のループを配置しています。これは、Wordのデータ構造が「文書 > セクション > ヘッダー」という親子関係になっているからです。この階層を一つずつ丁寧に降りていくことで、漏れのないスキャンが可能になります。

② `LinkToPrevious` プロパティの正体

今回の主役である `hf.LinkToPrevious`。これはBoolean型(True/False)のプロパティです。

  • True: 「前のセクションの設定を引き継ぐ」というフラグが立っている状態。
  • False: 「ここから新しい設定を開始する」という独立した状態。

これをExcelに書き出すことで、「意図せずリンクが切れている箇所」や「逆にリンクが残っていて修正が反映されない箇所」を一目で特定できるのです。

③ Late Binding(遅延結合)による柔軟性

Excelを操作する際、`CreateObject(“Excel.Application”)` を使用しています。これは「Late Binding」と呼ばれる手法です。これを使うことで、実行するPCにインストールされているExcelのバージョンが何であっても、エラーを起こさずに動作させることができます。実務レベルのツール開発では必須のテクニックです。

4. 陥りやすいエラーと回避策

このツールを使う際、あるいは自分で改造する際に注意すべき「落とし穴」を教えておきましょう。

  • 「ヘッダーが存在しない」エラー:

セクションによっては、ヘッダーが全く設定されていない(存在しない)場合があります。その状態で `.Range.Text` にアクセスしようとするとエラーになります。コード内の `If hf.Exists Then` というチェックが、このエラーを防ぐ防波堤になっています。

  • Excelの参照設定:

上記のコードは「Late Binding」を使っているため、特別な設定なしで動きますが、もし `Dim xlApp As Excel.Application` と書きたい場合は、VBA画面の「ツール」→「参照設定」から `Microsoft Excel Object Library` にチェックを入れる必要があります。初心者のうちは、まずは上記のように `Object` 型を使う方がトラブルが少なくて済みますよ。

5. まとめ:次は「制御」のフェーズへ

いかがでしたか?
「前と同じ」という、目には見えない設定をExcelに書き出す。たったこれだけのことで、複雑な文書の整合性を保つ強力な武器が手に入りました。

マクロの記録から一歩踏み出し、今回のように「オブジェクトの構造を理解し、ループで巡回する」という考え方が身につけば、Word VBAの習得率は飛躍的に向上します。

「このプロパティを書き換えたら、文書はどう変わるだろう?」
そんな好奇心を持って、ぜひコードを書き換えて試してみてください。その試行錯誤こそが、あなたを伝説的なエンジニアへと導く唯一の道なのです。

応援していますよ!

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