【脱・マクロ記録】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シートに書き出す……なんて応用にも挑戦してみてください。
あなたのプログラミングの旅が、より豊かで刺激的なものになることを願っています。応援していますよ!
