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

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

【脱・マクロ記録】Word VBAで表を操る:特定の単語を見つけて行をハイライトする技術

「マクロの記録」を使って、なんとか自動化の第一歩を踏み出したあなたへ。
おめでとうございます。あなたは今、プログラミングという広大な海へ漕ぎ出したばかりの冒険家です。

しかし、こんな壁にぶつかっていませんか?
「記録したマクロは、特定の場所でしか動かない……」
「条件によって処理を変えたいけれど、どう書けばいいのか分からない……」

大丈夫、安心してください。その壁は、「オブジェクトの概念」と「ループ(繰り返し)処理」を理解することで、鮮やかに乗り越えることができます。

今日は、Word VBAの真髄の一つである「表(Table)の操作」に焦点を当てます。特定のキーワードを探し出し、その行全体をパッと色付けする。この技術をマスターすれば、膨大なデータの中から必要な情報を視覚的にあぶり出す「自分専用の検索ツール」が作れるようになります。

さあ、一緒にコードの深淵を覗いてみましょう。

1. Word VBAの世界の「地図」を知る

コードを書く前に、まずはWordがどのようにデータを捉えているか、その「地図(オブジェクトモデル)」を頭に叩き込みましょう。ここを理解していないと、迷子になってしまいます。

Wordにおける表の構造は、入れ子構造(階層構造)になっています。

  • Document(文書全体)
  • Tables(文書内のすべての表の集合体)
  • Table(個別の表)
  • Rows(表の中の行の集合体)
  • Cells(行の中のセルの集合体)
  • Range(セル内のテキストなどの範囲)

私たちがやりたいことは、「Table(表)の中の各Row(行)を順番に見ていき、その中のCell(セル)に特定の文字が入っていたら、そのRow(行)の色を変える」というミッションです。

2. 実践:行全体をハイライトする魔法のコード

それでは、実際に動くコードを見てみましょう。以下のコードは、文書内の最初の表を対象に、指定したキーワードが含まれる行を探して、背景色を黄色にするものです。

Sub HighlightRowsByKeyword()
    ' --- 変数の宣言 ---
    ' どのオブジェクトを扱うかをあらかじめ定義します(これがプロの作法です)
    Dim targetTable As Table
    Dim targetRow As Row
    Dim targetCell As Cell
    Dim keyword As String
    Dim isFound As Boolean
    
    ' --- 設定エリア ---
    ' 探したいキーワードをここで指定します
    keyword = "重要"
    
    ' --- 前準備 ---
    ' 文書内に表が存在するかチェックします
    If ActiveDocument.Tables.Count = 0 Then
        MsgBox "文書内に表が見つかりませんでした。", vbExclamation
        Exit Sub
    End If
    
    ' 最初の表をターゲットにします
    Set targetTable = ActiveDocument.Tables(1)
    
    ' 一旦、表全体の背景色を「なし」にリセット(前回の色が残らないように)
    targetTable.Range.Shading.BackgroundPatternColor = wdColorAutomatic
    
    ' --- メイン処理:行のループ ---
    ' 表の行を一つずつ順番に見ていきます
    For Each targetRow In targetTable.Rows
        
        ' その行の中にキーワードがあるか判定するためのフラグをリセット
        isFound = False
        
        ' --- セルのループ ---
        ' 行の中のセルを一つずつ見ていきます
        For Each targetCell In targetRow.Cells
            
            ' 【重要】セルのテキストを判定します
            ' セルの中には「見えない文字」が含まれているため、InStr関数を使って
            ' 「キーワードが含まれているか」を判定するのがスマートです
            If InStr(targetCell.Range.Text, keyword) > 0 Then
                isFound = True
                Exit For ' キーワードが見つかったら、その行の他のセルを見る必要はないので抜けます
            End If
            
        Next targetCell
        
        ' --- 結果の適用 ---
        ' もしその行のどこかのセルにキーワードが見つかっていたら、行の色を変える
        If isFound Then
            targetRow.Shading.BackgroundPatternColor = wdColorYellow
        End If
        
    Next targetRow

    MsgBox "検索とハイライトが完了しました!", vbInformation
End Sub

3. ここがプロの視点!コードの解説と「落とし穴」

コードをただコピペするだけでは、あなたの成長は止まってしまいます。なぜこのような書き方をするのか、エンジニアの思考回路を解説します。

① なぜ `For Each` を使うのか?

初心者の方は `For i = 1 To 10` のような数字を使ったループを使いがちです。もちろん間違いではありませんが、VBAにおいて「集合体(RowsやCells)」を扱うときは、`For Each` を使うのが最もエレガントで、読みやすく、ミスが少ない方法です。
「行の集合体(Rows)から、一つひとつの行(targetRow)を取り出す」という直感的な記述が可能になります。

② 「見えない文字」の罠(最重要!)

ここが、多くの初学者が最初につまずく最大の落とし穴です。
Wordのセルの `.Text` プロパティには、見た目には見えない 「セル区切り文字(End of Cell Marker)」 という特殊なコード(`Chr(13) & Chr(7)`)が含まれています。

もし、次のように書いてしまうと、正しく判定できません。
`If targetCell.Range.Text = “重要” Then` ← これは絶対に失敗します!

なぜなら、実際のデータは `”重要” & [見えない文字]` となっているからです。
そこで、今回のコードでは `InStr` 関数を使いました。これは「指定した文字列が、ターゲットの中に含まれているか」を判定する関数です。これを使うことで、見えない文字に惑わされずに検索ができるのです。

③ `Exit For` によるパフォーマンス向上

キーワードが見つかった瞬間に `Exit For` でセルのループを抜ける。これは小さな表では誤差ですが、数千行あるような巨大な表を扱うとき、この「無駄な計算をしない」という一工夫が、処理速度に劇的な差を生みます。

4. さらなる高みへ:エラーを防ぐための心得

マクロを運用する上で、以下の2点を意識しておくと、「デキるエンジニア」に一歩近づけます。

1. 存在チェックを怠らない
今回のコードでは `If ActiveDocument.Tables.Count = 0` と書いて、表がない場合にエラーで止まらないよう配慮しています。プログラムは「想定外の事態」が起きたときに止まるものです。それを防ぐのが設計の基本です。
2. Select を使わない
マクロの記録を使うと、必ず `Selection.Select` というコードが出てきます。しかし、プロのコードでは `Select` は極力使いません。画面をあちこち動かす(Selectする)のは非常に動作が重く、画面がチラつく原因になります。今回のように `targetRow.Shading…` と、オブジェクトを直接指定して操作するのが、高速で安定したコードへの近道です。

まとめ

今回の学びを振り返りましょう。

  • オブジェクトモデル(Document > Table > Row > Cell)を意識する。
  • `For Each` を使って、集合体をスマートに走査する。
  • `InStr` を使い、セルの「見えない文字」の罠を回避する。
  • `Select` を避けて、オブジェクトを直接操作する。

ここをクリアすれば、Word VBAの基本はバッチリですよ。
次は、このハイライトした行のデータを、別のExcelシートに書き出す……なんて応用にも挑戦してみてください。

あなたのプログラミングの旅が、より豊かで刺激的なものになることを願っています。応援していますよ!

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