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

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

表面的なループを捨て、真の「検索」を実装せよ:Word表操作における計算量とオブジェクト管理の極意

「特定のキーワードが含まれる行をハイライトする」

一見すると、プログラミングの初学者が最初に躓く、極めて単純なタスクに見えるだろう。しかし、我々のようなアーキテクトがこの要件を見たとき、真っ先に想起するのは「実装の容易さ」ではなく、「その実装が大規模なドキュメントにおいて、どれほどの計算量とメモリ負荷を強いるか」という、スケーラビリティの懸念だ。

多くの開発者は、`For Each Cell In Table.Range.Cells` という、直感的ではあるが極めて非効率な二重ループを書き、そのまま納品する。しかし、数千行、数万セルに及ぶレガシーな業務文書において、そのコードはシステムをフリーズさせる「時限爆弾」へと変貌する。

本稿では、単なる「動くコード」ではなく、プロフェッショナルが現場に投入する「堅牢で、高速で、メモリに優しい」実装の真髄を解説する。

1. 素人が陥る「全セル走査」という罠

初心者が書くコードの典型は以下の通りだ。

' 【アンチパターン:決して真似してはならない】
For Each cell In myTable.Range.Cells
    If InStr(cell.Text, "検索語") > 0 Then
        cell.Row.Shading.BackgroundPatternColor = wdColorYellow
    End If
Next cell

このコードには、致命的な問題が3点ある。

1. 計算量の爆発: セル一つひとつに対して `InStr` を実行し、さらに `cell.Row` というオブジェクトプロパティへアクセスする。これは、WordのCOMオブジェクトモデルに対して膨大なプロパティ・アクセス・オーバーヘッドを発生させる。
2. 結合セルの脆弱性: Wordの表において「セルの結合」は、オブジェクト構造を破壊する。`Table.Rows` や `Cell.Row` の挙動は、結合状態によって非決定的な挙動(エラー)を示すことが多々ある。
3. UIスレッドの占有: `ScreenUpdating` を制御していないため、実行中に画面が激しくちらつき、ユーザーの作業を妨げる。

2. アーキテクトの解法:`Find` オブジェクトの活用

真のエンジニアは、セルを一つずつ調べるなどという「力技」は使わない。Wordが内部的に最適化している `Range.Find` メソッド を利用する。

`Find` は、Wordの検索エンジン(ネイティブ実装)を直接叩く。これにより、VBAレベルでのループ回数を劇的に減らし、検索対象の `Range` を直接特定することができる。特定した `Range` から、その親である `Row` を取得する。これが最短経路だ。

3. 実装:プロフェッショナル・グレードのコード

以下に、メモリ管理、エラーハンドリング、およびパフォーマンス最適化を組み込んだ、実戦的なコードを示す。

Option Explicit

''' <summary>
''' 表内の特定のキーワードを含む行をハイライトする。
''' 結合セルの存在を考慮し、Findオブジェクトによる高速走査を行う。
''' </summary>
''' <param name="targetTable">操作対象のWord.Tableオブジェクト</param>
''' <param name="keyword">検索対象の文字列</param>
''' <param name="highlightColor">ハイライトする色 (wdColor系)</param>
Public Sub HighlightRowsOptimized(ByRef targetTable As Object, ByVal keyword As String, Optional ByVal highlightColor As Long = 65535)
    ' オブジェクトの参照を明示的に宣言
    Dim searchRange As Object ' Word.Range
    Dim foundCell As Object   ' Word.Cell
    Dim currentRow As Object  ' Word.Row
    Dim isFound As Boolean
    
    ' エラーハンドリングの構築
    On Error GoTo ErrorHandler

    ' パフォーマンス最適化:画面更新の停止
    Application.ScreenUpdating = False

    ' 検索範囲の初期化(テーブル全体のRange)
    Set searchRange = targetTable.Range

    ' Findオブジェクトの設定
    With searchRange.Find
        .ClearFormatting
        .Text = keyword
        .Forward = True
        .Wrap = 0 ' wdFindStop: 見つかったら停止
        .Format = False
        .MatchCase = False
        .MatchWholeWord = False
        .MatchWildcards = False
        .MatchSoundsLike = False
        .MatchAllWordForms = False
    End With

    ' 検索ループ
    ' Find.Execute は見つかった場合に True を返す
    Do While searchRange.Find.Execute
        ' 見つかったRangeから、そのセルを特定
        ' 注意: Findで見つかるのはテキストのRangeであり、Cellではない
        ' そのため、そのRangeを含む親のCellオブジェクトを取得する
        On Error Resume Next
        Set foundCell = searchRange.Cells(1)
        On Error GoTo ErrorHandler
        
        If Not foundCell Is Nothing Then
            ' 行オブジェクトの取得
            Set currentRow = foundCell.Row
            
            ' 行全体に色を塗る
            ' 結合セルがある場合、Rowオブジェクトへのアクセスは慎重に行う必要がある
            If Not currentRow Is Nothing Then
                currentRow.Shading.BackgroundPatternColor = highlightColor
            End If
        End If

        ' 次の検索のために、見つかった範囲の直後から検索を再開する
        ' これを怠ると無限ループに陥る
        searchRange.Collapse 0 ' wdCollapseEnd
        
        ' テーブルの終端に達したらループを抜ける
        If searchRange.End >= targetTable.Range.End Then Exit Do
    Loop

CleanUp:
    ' メモリの明示的な解放(重要:COMオブジェクトのライフサイクル管理)
    ' 大規模な自動化処理において、これを行わないとメモリリークの原因となる
    Set foundCell = Nothing
    Set currentRow = Nothing
    Set searchRange = Nothing
    Set targetTable = Nothing
    
    ' 画面更新の再開
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical, "Architect Error"
    Resume CleanUp
End Sub

''' <summary>
''' エントリポイント(テスト用)
''' </summary>
Sub Main()
    Dim doc As Document
    Dim tbl As Table
    
    Set doc = ActiveDocument
    
    ' 文書内に表が存在するか確認
    If doc.Tables.Count = 0 Then
        MsgBox "対象となる表が見つかりません。"
        Exit Sub
    End If
    
    ' 最初の表を対象とする
    Set tbl = doc.Tables(1)
    
    ' 実行
    HighlightRowsOptimized tbl, "重要", 16776960 ' wdColorYellow相当
    
    MsgBox "処理が完了しました。"
End Sub

4. アーキテクトによる技術深掘り

4.1. メモリ管理とCOMオブジェクトのライフサイクル

VBAは、内部的にWindowsのCOM(Component Object Model)を利用している。`Set obj = Nothing` を書くことは、単なる作法ではない。特に、Wordをバックグラウンド(`Visible = False`)で動作させ、大量のドキュメントを連続処理するサーバーサイド的な自動化において、オブジェクトの解放漏れはメモリ使用量の指数関数的な増大を招き、最終的に `Out of Memory` エラーを引き起こす。

4.2. `Find.Execute` の計算量

前述の通り、`For Each Cell` が $O(N \times M)$ ($N$行 $\times M$列)の走査を強いるのに対し、`Find` はWordのインデックス構造を利用するため、平均的な計算量は大幅に低減される。これは、単に「速い」だけでなく、「リソースの競合を最小限に抑える」という設計思想に基づいている。

4.3. 結合セルという「非構造化データ」への対処

Wordの表は、Excelのような厳密なグリッド構造を持たない。セルが結合されている場合、`Table.Rows(i)` というインデックス指定は、内部的なインデックスの不整合により実行時エラーを吐く。
本実装では、`searchRange.Cells(1)` を介して、見つかったテキストが属する「セル」を起点に、その「親(Row)」へと遡るアプローチを取っている。これにより、結合セルの複雑なトポロジーに惑わされることなく、確実にターゲットの行へアクセスできる。

結論

「動く」コードを書くのは容易だ。しかし、「運用に耐えうる」コードを書くには、オブジェクトの挙動、計算量、そしてメモリの挙動に対する深い洞察が不可欠である。

君が書いているそのループは、本当に最適か?
次にそのマクロを動かすユーザーが、フリーズした画面の前で数分間待たされることにならないか?

技術の真髄は、常にその「先」にある。

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