【入門編】【初心者向け】表の特定の列に連番を振る際、結合セルを無視して正しくカウントするロジック – Word VBA解析バイブル

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

【Word VBA】結合セルの罠を突破せよ:連番を正しく振るための「例外処理」という武器

こんにちは。自動化の世界へようこそ。

「マクロの記録」を使って、一歩ずつ着実にステップアップしているあなた。素晴らしい姿勢です。でも、いざ自分でコードを書き始めると、必ずと言っていいほどぶち当たる「壁」がありますよね。

その壁の名は、「結合されたセル」。

表の中にセルを結合した箇所があると、昨日まで動いていたループ処理が突然「実行時エラー」を吐いて止まってしまう……。これには、私も駆け出しの頃、何度も頭を抱えたものです。

今日は、その壁を軽々と飛び越え、プロのエンジニアが実践している「結合セルを無視して、正しく連番を振るロジック」を伝授します。ここをクリアすれば、あなたのWord VBAスキルは「記録レベル」から「設計レベル」へと一段階引き上げられますよ。

1. なぜ「結合セル」があるとエラーになるのか?

まず、敵(エラーの原因)の正体を知ることから始めましょう。

通常の表は、綺麗な格子状のグリッドになっています。`Rows(i).Cells(j)` と指定すれば、必ずそこにセルが存在します。しかし、セルを結合すると、Word内部の「構造」が変わります。

例えば、1行目と2行目のセルを縦に結合したとしましょう。
このとき、プログラムから見ると、「2行目の1列目には、独立したセルが存在しない(1行目のセルの一部として扱われている)」という状態になるのです。

ここで、単純に `For i = 1 To Rows.Count` とループを回して、各行のセルにアクセスしようとすると、Wordはこう叫びます。
「そんなセル、どこにも存在しませんよ!(実行時エラー:指定したメンバが見つかりません)」

これが、結合セルによるエラーの正体です。

2. 解決策:エラーを「無視」して「判定」に使う

プロのエンジニアは、エラーを「怖いもの」として避けるのではなく、「状態を知るためのシグナル」として利用します。

今回使うテクニックは、VBAの「例外処理(Error Handling)」です。
「セルにアクセスしてみて、エラーが出たら『あ、ここは結合セルの一部だな』と判断してスキップする」というロジックを組みます。

実装のロジック図解

1. ループ開始: 表の行を1行ずつ見ていく。
2. アクセス試行: `On Error Resume Next` を使い、エラーが出ても止まらないようにしてセルに触れてみる。
3. 判定:

  • 成功した場合(`Err.Number = 0`) $\rightarrow$ 新しいセルが見つかった! $\rightarrow$ 連番を書き込む。
  • 失敗した場合(`Err.Number <> 0`) $\rightarrow$ 結合セルの一部だ! $\rightarrow$ 何もしない。

4. リセット: 次の行のためにエラー状態をクリアする。

3. 実践!連番付与のマスターコード

それでは、実際に動くコードを見てみましょう。このままコピーして、Wordの標準モジュールに貼り付けて試してみてください。

Sub AssignSequentialNumbersToTable()
    ' 変数の宣言(型を明示するのはプロの基本です)
    Dim tbl As Table
    Dim r As Long
    Dim targetCol As Integer
    Dim count As Long
    Dim targetCell As Cell
    
    ' --- 設定エリア ---
    targetCol = 1      ' 連番を振りたい列番号(1列目)
    count = 1          ' 開始番号
    ' ------------------

    ' 文書内の最初の表を対象にする
    If ActiveDocument.Tables.Count = 0 Then
        MsgBox "表が見つかりません。", vbExclamation
        Exit Sub
    End If
    Set tbl = ActiveDocument.Tables(1)

    ' 処理中の画面更新を止めてパフォーマンスを向上させる(お作法)
    Application.ScreenUpdating = False

    ' 表の行数分だけループ
    For r = 1 To tbl.Rows.Count
        
        ' 【重要】エラーが発生しても次の行へ進むように指示
        On Error Resume Next
        
        ' ターゲットとなるセルにアクセスを試みる
        ' 結合セルによって「存在しない」と判定されると、ここでエラーが発生する
        Set targetCell = tbl.Cell(r, targetCol)
        
        ' エラー判定
        If Err.Number = 0 Then
            ' --- ケースA: セルが正常に取得できた場合 ---
            ' つまり、ここは結合セルの「起点」となるセルです
            
            targetCell.Range.Text = count & "" ' 連番を書き込み
            count = count + 1                  ' カウントアップ
            
        Else
            ' --- ケースB: エラーが発生した場合 ---
            ' つまり、ここは結合セルによって「存在しない」扱いになっているセルです
            ' 何もしないことで、結合セルを無視して次の行へ進みます
            
        End If
        
        ' エラー情報をクリアして、次のループに備える(これを忘れるとバグの元!)
        Err.Clear
        On Error GoTo 0 ' エラー制御を通常の状態に戻す
        
    Next r

    ' 画面更新を再開
    Application.ScreenUpdating = True
    
    MsgBox "連番の付与が完了しました!", vbInformation
End Sub

4. ここがプロの視点!コードの解説

このコードには、初心者が卒業するために必要な「3つのエッセンス」が詰まっています。

① `On Error Resume Next` と `Err.Clear` のコンビネーション

単に `On Error Resume Next` を書くだけでは不十分です。エラーが発生したあと、そのエラー情報を `Err.Clear` で掃除(リセット)しないと、次の行で「正常なのにエラー扱い」になってしまうことがあります。「エラーを使い、使い終わったら捨てる」。これが鉄則です。

② `On Error GoTo 0` によるガード

`On Error Resume Next` は強力すぎる武器です。もしコードの他の部分で本当に重大なミス(タイポなど)があった場合、それすらも無視して進んでしまい、原因不明のバグを生みます。「必要な箇所だけで使い、終わったらすぐに `GoTo 0` で解除する」。これが、堅牢なプログラムを作るための作法です。

③ パフォーマンスへの配慮 (`ScreenUpdating`)

表の行数が多い場合、セルに書き込むたびに画面がチカチカ動くと非常に遅くなります。`Application.ScreenUpdating = False` を使うことで、処理中の描画を止め、実行速度を劇的に向上させています。

最後に:一歩先へ進むあなたへ

「結合セルがあるから、自動化は諦めよう……」
そう思う必要は全くありません。今回学んだ「エラーを制御して、オブジェクトの振る舞いを読み解く」という考え方は、Word VBAだけでなく、Excel VBAや他のプログラミング言語でも共通する、極めて重要な概念です。

エラーは、プログラムからの「教えてあげるよ」というメッセージです。
それを正しく受け取れるようになれば、あなたはもう「マクロの記録」の枠を完全に超えています。

ここをクリアすれば、Word VBAの基本はバッチリですよ。
自信を持って、次の自動化に挑戦してくださいね!応援しています。

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