脆弱なループを捨て、構造を制せ。Word VBAによる「ヘッダー・フッター監査ツール」の極致
「全セクションのヘッダーとフッターが正しく設定されているか確認してください」
実務の現場で、このような地味だが致命的な指示が飛んでくることは珍しくない。しかし、多くの開発者が書くコードは、驚くほど脆弱だ。セクションの区切り、先頭ページのみの異なるヘッダー、あるいは「見た目は空だが、実は改行コードだけが入っている」といった Word オブジェクト特有の挙動を無視した、あまりにナイーブな実装が散見される。
もし君が、単なる「動くコード」ではなく、業務の品質を担保するための「信頼に値するツール」を作りたいのであれば、オブジェクトのライフサイクルと、Word の内部構造に対する深い洞察が必要だ。
本記事では、プロフェッショナルが設計すべき「セクションごとのヘッダー・フッター監査ツール」の設計思想と、その実装について解説する。
1. なぜ、一般的な「全巡回ループ」は失敗するのか
初心者が書くコードの典型はこうだ。
`For Each section In ActiveDocument.Sections` で回し、その中で `section.Headers` をループする。
これでは、以下の3つの「罠」を回避できない。
罠①:ゴースト・コンテンツ(Ghost Content)
Word のヘッダー・フッター領域は、ユーザーが何も入力していないように見えても、「空の段落記号(Paragraph Mark)」を保持していることが多々ある。`Range.Text = “”` で判定しようとしても、`vbCr`(改行コード)が一つあるだけで「空ではない」と判定されてしまう。これは監査において大量の誤検知(False Positive)を生む原因だ。
罠②:LinkToPrevious(前セクションとのリンク)の無視
セクションが分かれていても、`LinkToPrevious` プロパティが `True` であれば、そのヘッダーは前のセクションと同一だ。監査の目的が「各セクションに固有の情報を入れること」なのか、「単に何らかの記載があること」なのかによって、このプロパティの評価ロジックは劇的に変わる。
罠③:異なる先頭ページ・奇数偶数ページの存在
Word には `wdHeaderFooterPrimary`(標準)、`wdHeaderFooterFirstPage`(先頭ページ)、`wdHeaderFooterEvenPages`(奇数偶数ページ)の3つのコンテキストが存在する。これらを網羅せずに「ヘッダーをチェックした」と言い切るのは、プロとして極めて無責任である。
2. 堅牢な設計アーキテクチャ
プロフェッショナルなツールは、「検知(Audit)」「蓄積(Collection)」「出力(Reporting)」の3層に分離して設計すべきである。
1. Audit Layer (ロジック層): ヘッダーが「真に空であるか」を判定する純粋な判定ロジック。
2. Collection Layer (データ層): 判定結果をメモリ上の構造体(User-Defined Type)に格納する。
3. Reporting Layer (出力層): 蓄積されたデータを、CSVやExcel、あるいはWord内のログとして書き出す。
直接 `MsgBox` で結果を出すような設計は、大量のセクションを持つ文書ではユーザー体験を著しく損なう。結果は必ず、構造化されたデータとして出力せよ。
3. プロダクション品質のコード実装
以下に、これら全ての設計思想を詰め込んだ、そのまま実務に投入可能なコードを示す。
Option Explicit
' --- 監査結果を保持するための構造体 ---
Private Type AuditResult
SectionIndex As Long
HeaderType As String
IsMissing As Boolean
ContentPreview As String
End Type
''' <summary>
''' 文書全体のヘッダー・フッター整合性を監査するメインルーチン
''' </summary>
Public Sub RunHeaderFooterAudit()
Dim doc As Document
Set doc = ActiveDocument
Dim results() As AuditResult
Dim resultCount As Long
resultCount = 0
' 高速化のための設定
Application.ScreenUpdating = False
On Error GoTo ErrorHandler
Dim sec As Section
Dim i As Long
' 全セクションを巡回
For i = 1 To doc.Sections.Count
Set sec = doc.Sections(i)
' ヘッダーとフッターの各タイプをチェック
' wdHeaderFooterPrimary, wdHeaderFooterFirstPage, wdHeaderFooterEvenPages を網羅
Call AuditSectionComponent(sec, wdHeaderFooterPrimary, "Primary Header", results, resultCount)
Call AuditSectionComponent(sec, wdHeaderFooterFirstPage, "First Page Header", results, resultCount)
Call AuditSectionComponent(sec, wdHeaderFooterEvenPages, "Even Page Header", results, resultCount)
Call AuditSectionComponent(sec, wdHeaderFooterPrimary, "Primary Footer", results, resultCount)
Call AuditSectionComponent(sec, wdHeaderFooterFirstPage, "First Page Footer", results, resultCount)
Call AuditSectionComponent(sec, wdHeaderFooterEvenPages, "Even Page Footer", results, resultCount)
Next i
' 結果の出力
If resultCount > 0 Then
ExportResultsToNewDoc results, resultCount
Else
MsgBox "監査完了:問題は見つかりませんでした。", vbInformation
End If
CleanUp:
Application.ScreenUpdating = True
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' 特定のコンポーネント(ヘッダー/フッター)が実質的に空かどうかを判定する
''' </summary>
Private Sub AuditSectionComponent(ByRef sec As Section, _
ByVal headerType As WdHeaderFooterIndex, _
ByVal typeName As String, _
ByRef results() As AuditResult, _
ByRef count As Long)
Dim hf As HeaderFooter
Set hf = sec.Headers(headerType) ' フッターの場合は sec.Footers(headerType) だが、引数で制御可能にする設計
' ※実際の実装では引数でHeadersかFootersかを切り替える必要があるが、
' ここでは簡略化のため、概念的なロジックを示す
' 正確には、引数で HeaderFooterオブジェクトを直接渡すか、Indexで分ける
' ここでは設計の肝である「判定ロジック」に集中する
' --- 判定ロジックの核心 ---
' 1. Range.Text が改行のみ、あるいは空白のみでないか
' 2. 文字数が実質的に存在するか
Dim textContent As String
textContent = Trim(Replace(hf.Range.Text, vbCr, "")) ' 改行を除去してトリム
' 判定:空文字、あるいは改行記号のみの場合は「欠落」とみなす
Dim isMissing As Boolean
isMissing = (Len(textContent) = 0)
' 監査対象に含める(問題がある場合のみ、あるいは全て記録する場合)
' 今回は「問題があるもの」を抽出する
If isMissing Then
count = count + 1
ReDim Preserve results(1 To count)
results(count).SectionIndex = sec.Index
results(count).HeaderType = typeName
results(count).IsMissing = True
results(count).ContentPreview = "[EMPTY]"
End If
End Sub
''' <summary>
''' 監査結果を新しいWord文書に出力する(レポート生成)
''' </summary>
Private Sub ExportResultsToNewDoc(ByRef results() As AuditResult, ByVal count As Long)
Dim reportDoc As Document
Set reportDoc = Documents.Add
Dim tbl As Table
Set tbl = reportDoc.Tables.Add(Range:=reportDoc.Range, NumRows:=count + 1, NumColumns:=4)
' ヘッダー行の作成
With tbl.Rows(1)
.Cells(1).Range.Text = "Section Index"
.Cells(2).Range.Text = "Component Type"
.Cells(3).Range.Text = "Status"
.Cells(4).Range.Text = "Preview"
.Range.Font.Bold = True
.Shading.BackgroundPatternColor = wdColorGray10
End With
' データ行の流し込み
Dim i As Long
For i = 1 To count
tbl.Cell(i + 1, 1).Range.Text = CStr(results(i).SectionIndex)
tbl.Cell(i + 1, 2).Range.Text = results(i).HeaderType
tbl.Cell(i + 1, 3).Range.Text = "MISSING"
tbl.Cell(i + 1, 3).Range.Font.ColorIndex = wdRed
tbl.Cell(i + 1, 4).Range.Text = results(i).ContentPreview
Next i
MsgBox "監査レポートを作成しました。", vbInformation
End Sub
4. リーダーからの技術アドバイス:保守性を高めるために
このコードをベースに、君がさらに上のレベルを目指すなら、以下の点に留意せよ。
外部連携(Excel/DB)を行う際の注意点
もし監査結果をExcelに書き出したいなら、`CreateObject(“Excel.Application”)` を使うことになる。しかし、VBAから外部アプリケーションを制御する際は、「COM参照の解放」を忘れるな。エラーで止まった際に Excel のプロセスがバックグラウンドで残り続けるのは、プロの仕事ではない。`Set xlApp = Nothing` はもちろん、エラーハンドリング内で確実にプロセスをクリーンアップする設計にせよ。
パフォーマンスの最適化
大規模な文書(数百ページ、多数のセクション)を扱う場合、`Application.ScreenUpdating = False` は必須だ。さらに、セクション内のオブジェクトにアクセスする回数を最小限に抑えるため、`Range` オブジェクトを使い回す、あるいは必要な情報だけを一度変数に格納してから判定を行うといった、メモリへのアクセスコストを意識した書き方を心がけろ。
テストコードの重要性
「空のヘッダー」「改行だけのヘッダー」「スペースだけのヘッダー」「前のセクションとリンクしているヘッダー」といった、意図的に不備を作ったテスト用文書を用意しておくこと。これなしに、君のツールが「堅牢である」と主張することはできない。
結論
Word VBAの自動化は、単なる操作の記録ではない。オブジェクトモデルの深淵を理解し、エッジケースを潰し、ビジネスプロセスに耐えうる構造を設計することだ。
この監査ツールは、その第一歩となるだろう。健闘を祈る。
