【入門編】ヘッダー・フッター内のテキストを多言語対応(翻訳)するVBA – Word VBA解析バイブル

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

「Word VBAの壁」を越える:セクションを跨いだヘッダー・フッターの多言語自動翻訳術

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

「マクロの記録」を使って、なんとかボタン一つで文字の色を変えたり、特定の単語を置換したり……。そんな小さな成功を積み重ねてきたあなた。素晴らしい一歩です。でも、もしあなたが「世界中の拠点に送る、多言語対応の報告書を自動で作りたい」と考え始めたなら、今こそ「記録」のフェーズを卒業し、「設計(アーキテクチャ)」のフェーズへ進む時です。

今日扱うテーマは、Word VBAの中でも非常に「クセが強く」、そして「強力」な領域。
セクション、ヘッダー、フッター、そして外部APIとの連携です。

ここをマスターすれば、あなたは単なる「マクロ使い」ではなく、ビジネスプロセスを再定義する「自動化エンジニア」へと進化できるはずですよ。さあ、一緒に深淵を覗いてみましょう。

1. なぜ「マクロの記録」ではヘッダーを制御できないのか?

多くの初心者が最初につまずくのが、「ヘッダーを書き換えるマクロを記録したのに、なぜか一部のページしか変わらない!」という現象です。

これには、Wordというアプリケーションが持つ「階層構造(オブジェクトモデル)」の秘密が隠されています。

Wordの「階層構造」を理解しよう

Wordの文書は、単なる「ページの集まり」ではありません。エンジニアの視点では、以下のようなツリー構造として捉える必要があります。

Document (文書全体)
  └── Sections (セクション:章や節の区切り)
        ├── Headers (ヘッダーの集合)
        │     ├── Primary (標準のヘッダー)
        │     ├── FirstPage (最初のページのヘッダー)
        │     └── EvenPages (奇数/偶数ページのヘッダー)
        └── Footers (フッターの集合)
              ├── Primary
              ├── FirstPage
              └── EvenPages

「マクロの記録」は、あなたが「今、目の前で見ているもの」しか記録しません。
しかし、文書が「セクションごとに異なるヘッダーを持つ設定」になっていたり、「奇数ページと偶数ページでヘッダーを分ける設定」になっていたりする場合、記録されたコードは、それ以外の「隠れたヘッダー」を完全に見落としてしまうのです。

「全てのヘッダーを翻訳する」ためには、この階層を一つずつ、確実に降りていくコードを書く必要があるのです。

2. 実践:ヘッダー・フッター多言語翻訳エンジン

では、実際に「文書内のすべてのヘッダー・フッターを抽出し、翻訳して書き戻す」ためのコードを見ていきましょう。

今回は、実際のAPI(DeepLやGoogle Translateなど)を呼び出すための「枠組み」を、読みやすい形で実装します。

Option Explicit

''' <summary>
''' 文書内のすべてのヘッダー・フッターを走査し、翻訳を実行するメインルーチン
''' </summary>
Sub TranslateAllHeadersAndFooters()
    Dim doc As Document
    Dim sec As Section
    Dim hdr As HeaderFooter
    Dim ftr As HeaderFooter
    Dim targetText As String
    Dim translatedText As String
    
    Set doc = ActiveDocument
    
    ' パフォーマンス向上のため、画面更新を停止
    Application.ScreenUpdating = False
    
    On Error GoTo ErrorHandler
    
    Debug.Print "--- 翻訳プロセス開始 ---"

    ' 1. セクションを一つずつループ(ここが重要!)
    For Each sec In doc.Sections
        
        ' 2. ヘッダーの走査
        ' sec.Headers には、Primary, FirstPage, EvenPages のすべてが含まれる
        For Each hdr In sec.Headers
            ' ヘッダーが使用されており、かつテキストが存在する場合のみ処理
            If hdr.Exists And Len(hdr.Range.Text) > 1 Then
                targetText = CleanText(hdr.Range.Text) ' 改行コードなどを除去
                
                If targetText <> "" Then
                    ' 3. 翻訳処理の呼び出し
                    translatedText = CallTranslationAPI(targetText, "EN") ' 例: 英語へ
                    
                    ' 4. 結果を書き戻す
                    hdr.Range.Text = translatedText
                    Debug.Print "Header Translated: " & targetText & " -> " & translatedText
                End If
            End If
        Next hdr
        
        ' 3. フッターの走査
        For Each ftr In sec.Footers
            If ftr.Exists And Len(ftr.Range.Text) > 1 Then
                targetText = CleanText(ftr.Range.Text)
                
                If targetText <> "" Then
                    translatedText = CallTranslationAPI(targetText, "EN")
                    ftr.Range.Text = translatedText
                    Debug.Print "Footer Translated: " & targetText & " -> " & translatedText
                End If
            End If
        Next ftr
        
    Next sec

    Application.ScreenUpdating = True
    MsgBox "すべてのヘッダー・フッターの翻訳が完了しました!", vbInformation
    Exit Sub

ErrorHandler:
    Application.ScreenUpdating = True
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 翻訳APIを呼び出す(モック関数)
''' 本来はここで HTTPリクエストを送り、APIのレスポンスを受け取る
''' </summary>
Function CallTranslationAPI(ByVal text As String, ByVal targetLang As String) As String
    ' --- 実務的なアドバイス ---
    ' 本来は MSXML2.XMLHTTP を使用して APIへ POSTリクエストを送ります。
    ' ここでは、学習のために「[EN] 」を接頭辞としてつける擬似的な処理を行います。
    
    Dim dummyResult As String
    dummyResult = "[EN] " & text ' 擬似的な翻訳結果
    
    ' 実際のAPI連携を行う場合は、ここに通信ロジックを記述します
    CallTranslationAPI = dummyResult
End Function

''' <summary>
''' Word特有の改行コードやゴミを取り除くユーティリティ
''' </summary>
Function CleanText(ByVal txt As String) As String
    Dim cleaned As String
    cleaned = txt
    ' WordのRange.Textには末尾に必ず改行文字が含まれるため、それを除去
    cleaned = Replace(cleaned, vbCr, "")
    cleaned = Replace(cleaned, vbLf, "")
    cleaned = Trim(cleaned)
    CleanText = cleaned
End Function

3. プロの視点:ここが「ハマりどころ」だ!

コードを読み解けましたか? ここで、現場のエンジニアが必ず直面する「落とし穴」を3つ伝授します。これを知っているだけで、あなたのデバッグ時間は半分になります。

① `Range.Text` の末尾にある「見えない文字」

Wordのオブジェクト(Rangeなど)からテキストを取得すると、末尾に必ず `vbCr`(キャリッジリターン)が含まれます。これをそのまま翻訳APIに送ると、API側で「余計な改行が含まれている」としてエラーになったり、翻訳結果に不自然な空白が入ったりします。
上記のコードで `CleanText` 関数を用意したのは、そのためです。「取得したデータは、必ず掃除してから使う」。これが鉄則です。

② `Exists` プロパティの確認

セクションによっては、ヘッダーが定義されていない(存在しない)場合があります。存在しないオブジェクトの `Range` にアクセスしようとすると、`Object Required` エラーでマクロが止まります。`If hdr.Exists Then` という一言を添えるだけで、コードの堅牢性は劇的に向上します。

③ パフォーマンスの重み(`ScreenUpdating`)

大規模な文書(100ページ超など)で、ループの中で何度も画面を書き換えると、処理速度は極端に低下します。`Application.ScreenUpdating = False` は、単なるおまじないではなく、「ユーザーの待ち時間を減らすための必須の作法」です。

4. 次のステップへ:APIとの本当の対話

上記のコード内の `CallTranslationAPI` は、現在は「擬似的な翻訳」を行っています。
あなたが次に挑戦すべきは、`MSXML2.XMLHTTP` オブジェクトを使用して、実際に DeepL API や Google Cloud Translation API へ JSON 形式でリクエストを送ることです。

「HTTPリクエスト」「JSONのパース(解析)」……。
これらはVBAの範疇を超えた、Webエンジニアリングの領域です。しかし、恐れることはありません。Word VBAは、それらの技術を「文書作成」という強力な武器に結びつけるための、最高のインターフェースなのです。

まとめ

今日学んだことを振り返りましょう。

1. 階層を意識せよ:Document > Section > Header > Range の構造を理解する。
2. 全方位をカバーせよ:`For Each` を使い、すべてのセクションとヘッダーの種類を走査する。
3. データを浄化せよ:取得したテキストの改行や空白を適切に処理する。

ここをクリアすれば、Word VBAの基本はバッチリですよ。
さあ、次はあなた自身の手で、世界を繋ぐ自動化ツールを書き上げてください。応援しています!

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