【実務・中級編】【初心者向け】Word表の全セルを走査し、特定のキーワードが含まれる行全体をハイライトするマクロ – Word VBA解析バイブル

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

「動く」コードではなく「戦える」コードを。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のループで文字列を比較するよりも遥かに高速だ。

結びに

プログラミングにおいて、「動くこと」は最低条件に過ぎない。
「メンテナンスしやすいか」「データ量が増えても耐えうるか」「エラー時にシステムを壊さないか」。
これらの問いに答えられる設計こそが、真の自動化エンジニアが提供すべき価値である。

今日学んだ「行主導の思考」を、次回の開発に必ず活かせ。

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