「動く」コードではなく「戦える」コードを。Word VBA 表操作における設計思想と実戦的実装
現場のエンジニアが最初に直面する壁は、「コードが動かないこと」ではない。「動いてはいるが、データが増えた瞬間に激重になり、予期せぬエラーで止まる」という、設計の脆弱性だ。
今回扱うテーマは、Word文書内の表を走査し、特定のキーワードを含む行をハイライトするという、一見シンプルに見えるタスクだ。しかし、この「シンプルに見える処理」の中にこそ、プロフェッショナルとアマチュアを分かつ、オブジェクトモデルの理解と計算量の意識が凝縮されている。
単なるコピペで終わらせるな。なぜこの書き方をするのか、その「思想」を血肉にせよ。
1. 初心者が陥る「セル走査」の罠
多くの初学者は、表の全セルを走査しようとする際、次のような論理構成を組み立てる。
1. 表の中のすべての `Cell` を `For Each` で回す。
2. 各セルのテキストを確認する。
3. キーワードが見つかったら、そのセルの親である `Row` をハイライトする。
一見、理にかなっている。しかし、これは非効率な設計だ。
なぜこの設計は「脆い」のか?
- 計算量の無駄(冗長性): 1つの行にキーワードを含むセルが3つあった場合、同じ行に対して3回「ハイライト処理」が走る。UIの更新(背景色の変更)は、VBAにおいて非常にコストの高い処理だ。
- オブジェクトのオーバーヘッド: `Cell` オブジェクトは `Row` オブジェクトよりも粒度が細かく、膨大な数のセルが存在する巨大な表では、オブジェクトの生成と破棄だけでメモリと時間を浪費する。
- エンドセルマーカーの誤認: Wordのセル内テキストには、目に見えない「セル区切り文字(`Chr(13) & Chr(7)`)」が含まれている。これを考慮せずに文字列比較を行うと、判定ミスを誘発する。
プロフェッショナルは、「セル単位」ではなく「行単位」で思考をシフトさせる。
2. プロダクション・アーキテクチャ:行主導の走査
我々が採用すべき設計は、「行(Row)を主軸とした走査」だ。
1. 表の `Rows` コレクションをループする。
2. 各行の `Range` 内にキーワードが存在するかを、`Find` オブジェクトまたは `InStr` 関数で高速に判定する。
3. キーワードが見つかった瞬間、その行をハイライトし、即座にその行の走査を終了して次の行へ移る(Exit For)。
これにより、重複した描画処理を排除し、計算量を最小限に抑えることができる。
3. 実戦的実装:堅牢なハイライト・マクロ
以下に、実務でそのまま投入できるレベルのコードを示す。単なる機能実装ではなく、エラーハンドリングとオブジェクトの解放までを組み込んだ、保守性の高い設計だ。
Option Explicit
''' <summary>
''' 表内の特定キーワードを含む行をハイライトする。
''' 設計思想: 行単位の走査による高速化と、重複処理の排除。
''' </summary>
Public Sub HighlightRowsByKeyword()
' --- 設定領域 ---
Const TARGET_KEYWORD As String = "重要" ' 検索するキーワード
Const HIGHLIGHT_COLOR As Long = wdColorYellow ' ハイライト色
' ----------------
Dim doc As Document
Dim tbl As Table
Dim i As Long
Dim targetRow As Row
Dim rowText As String
Dim foundMatch As Boolean
' オブジェクト参照の初期化
Set doc = ActiveDocument
' 1. 文書内に表が存在するかチェック(ガード節)
If doc.Tables.Count = 0 Then
MsgBox "文書内に表が見つかりません。", vbExclamation, "エラー"
Exit Sub
End If
' 高速化のための設定:画面更新を停止
Application.ScreenUpdating = False
On Error GoTo ErrorHandler
' 2. 全ての表を走査(複数の表がある場合にも対応)
For Each tbl In doc.Tables
' 表内の各行をループ
For i = 1 To tbl.Rows.Count
Set targetRow = tbl.Rows(i)
' 行全体のテキストを取得(セル区切り文字が含まれるため注意)
' ここでは InStr を用いて、行内のどこかにキーワードがあるか判定する
rowText = targetRow.Range.Text
' 3. キーワード判定
If InStr(1, rowText, TARGET_KEYWORD, vbTextCompare) > 0 Then
' キーワードが見つかった場合、行全体の背景色を変更
' 既に色が塗られている場合の重複処理を防ぐため、条件分岐を入れるのが理想的
If targetRow.Range.Shading.BackgroundPatternColor <> HIGHLIGHT_COLOR Then
targetRow.Range.Shading.BackgroundPatternColor = HIGHLIGHT_COLOR
End If
' 【重要】この行に対する処理は完了したので、次の行へスキップ
' これにより、1行に複数キーワードがあっても、描画処理は1回で済む
End If
Next i
Next tbl
' 正常終了時のメッセージ
MsgBox "処理が完了しました。", vbInformation, "完了"
CleanUp:
' 4. 後処理:画面更新を再開し、オブジェクトを解放
Application.ScreenUpdating = True
Set targetRow = Nothing
Set tbl = Nothing
Set doc = Nothing
Exit Sub
ErrorHandler:
' エラー発生時の処理
MsgBox "予期せぬエラーが発生しました:" & vbCrLf & Err.Description, vbCritical, "実行エラー"
Resume CleanUp
End Sub
4. アーキテクトの視点:さらに高みを目指すために
このコードをベースに、実務での要件はさらに複雑化していく。以下の3点を意識せよ。
① データの外部連携(DB/Excel)
キーワードをコード内に `Const` でハードコードするのは、小規模なツール限定だ。実務では、Excelのセルから検索条件を読み込む、あるいは外部のCSVからマスターリストを取得する設計が求められる。その際、「検索条件のバリデーション(空文字チェックや型チェック)」を忘れてはならない。
② セル区切り文字の罠
`targetRow.Range.Text` で取得できる文字列には、セルの末尾に必ず `Chr(13) & Chr(7)` が含まれる。これを知らずに `If rowText = “キーワード” Then` と完全一致比較を行うと、絶対にヒットしない。必ず `InStr` を使うか、文字列操作で末尾を除去する習慣をつけろ。
③ パフォーマンスの極限
もし対象の表が数千行に及ぶ場合、`Application.ScreenUpdating = False` だけでは足りない。Wordの `Find` オブジェクトを `Range` に対して直接実行する手法への切り替えを検討せよ。`Find` は内部的にC++レベルで最適化された検索エンジンであり、VBAのループで文字列を比較するよりも遥かに高速だ。
結びに
プログラミングにおいて、「動くこと」は最低条件に過ぎない。
「メンテナンスしやすいか」「データ量が増えても耐えうるか」「エラー時にシステムを壊さないか」。
これらの問いに答えられる設計こそが、真の自動化エンジニアが提供すべき価値である。
今日学んだ「行主導の思考」を、次回の開発に必ず活かせ。
