【入門編】Word VBAでヘッダー内の図形(Shape)を座標指定で整列させる – Word VBA解析バイブル

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

隠れたレイヤーを支配せよ:Word VBAでヘッダー内の図形を座標指定で操る極意

こんにちは。コードの海を渡る準備はできていますか?

「マクロの記録」を使って、一生懸命に自動化の第一歩を踏み出したあなた。素晴らしい挑戦です。でも、ふとした瞬間に壁にぶつかったことはありませんか?

「ヘッダーにあるロゴの位置を、セクションごとに少しだけ変えたいのに、マクロの記録ではヘッダーの中身を触ってくれない……」
「図形を動かそうとしたら、『指定したオブジェクトが見つかりません』と怒られてしまう……」

もしあなたが今、そんな感覚に陥っているなら、おめでとうございます。あなたは今、「単なる操作の記録」から「オブジェクトの構造を理解するエンジニア」へと進化する境界線に立っています。

今日は、Word VBAの中でも特に難解で、かつ使いこなせると一気にプロフェッショナルへと昇格できる「ヘッダー内の図形(Shape)の動的コントロール」について、その設計思想から実装方法までをじっくりとお話ししましょう。

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

まず、最も重要な「概念」から整理しましょう。ここを理解していないと、どんなにコードを書き換えても迷宮を彷徨うことになります。

Wordという文書は、私たちが目にしている「本文」のレイヤーだけではありません。実は、「ストーリー(StoryRanges)」と呼ばれる、複数の独立したレイヤーで構成されています。

  • Main Text Story: 私たちが普段書いている本文
  • Header Story: ヘッダー領域
  • Footer Story: フッター領域
  • Text Box Story: テキストボックスの中身

「マクロの記録」は、基本的に「今、カーソルがある場所(Main Text)」の操作を記録します。しかし、ヘッダーは本文とは全く別の「物語(Story)」の中に存在しているのです。

つまり、ヘッダー内の図形を操作するには、本文の図形を探すのではなく、ヘッダーという「別世界」にアクセスする命令を書かなければならないのです。

2. 座標指定の鉄則:`CentimetersToPoints` を使いこなす

図形を「右から5cm、上から2cmの位置に置きたい」と思ったとき、VBAのプロパティに直接 `5` や `2` を入れてはいけません。

Wordの内部では、位置はすべて 「ポイント(Point)」 という単位で管理されています。1cmは約28.35ポイントです。この計算を自分で行うと、環境によってズレが生じる原因になります。

プロのエンジニアは必ず、Wordが用意してくれている変換関数を使います。
`Application.CentimetersToPoints(5)`

これを使うことで、人間が理解しやすい「センチメートル」を、Wordが理解できる「ポイント」へと正確に翻訳できるのです。

3. 実戦コード:セクションごとにヘッダー図形を整列させる

それでは、具体的なコードを見ていきましょう。
このコードのシナリオはこうです。「文書内のすべてのセクションを巡回し、ヘッダー内にある『Logo』という名前の図形を探して、指定した座標へ正確に配置する」。

Option Explicit

''' <summary>
''' 各セクションのヘッダー内にある特定の図形を、指定した座標に移動させる
''' </summary>
''' <param name="shapeName">操作したい図形の名前</param>
''' <param name="posX">配置したいX座標(cm)</param>
''' <param name="posY">配置したいY座標(cm)</param>
Sub AlignHeaderShapes()
    Dim sec As Section
    Dim targetHeader As HeaderFooter
    Dim shp As Shape
    Dim found As Boolean
    
    ' 配置したい座標の設定(ここを自由に変えてください)
    Dim targetX As Single: targetX = Application.CentimetersToPoints(15) ' 右端寄り
    Dim targetY As Single: targetY = Application.CentimetersToPoints(1)  ' 上端寄り
    
    ' 1. 文書内の全セクションをループで回す
    ' セクションごとにヘッダーの設定が異なるため、ここが重要です
    For Each sec In ActiveDocument.Sections
        
        ' 2. セクション内の「プライマリヘッダー(通常使うヘッダー)」を取得
        ' 奇数・偶数ページで分かれている場合は、wdHeaderFooterEvenPages等も考慮が必要
        Set targetHeader = sec.Headers(wdHeaderFooterPrimary)
        
        found = False
        
        ' 3. ヘッダーという「別世界」の中にある図形(Shapes)を探索
        ' 本文のShapesコレクションではなく、ヘッダーのShapesコレクションを見ます
        For Each shp In targetHeader.Shapes
            
            ' 図形の名前で判定(事前に図形に名前をつけておくと確実です)
            If shp.Name = "Logo" Then
                
                ' 4. 座標の書き換え
                ' Left(左からの距離)と Top(上からの距離)を指定
                shp.Left = targetX
                shp.Top = targetY
                
                found = True
                Exit For ' 見つかったらそのセクションの探索は終了
            End If
        Next shp
        
        ' デバッグ用:見つからなかった場合にイミディエイトウィンドウへ出力
        If Not found Then
            Debug.Print "Section " & sec.Index & ": 'Logo' が見つかりませんでした。"
        End If
        
    Next sec

    MsgBox "配置完了!セクションごとの制御が終了しました。", vbInformation
End Sub

コードの解説と設計のポイント

1. `For Each sec In ActiveDocument.Sections`:
Wordはセクションが変わると、ページ設定やヘッダーの内容をリセットできます。セクションごとに異なる配置をしたいなら、このループが「心臓部」になります。
2. `sec.Headers(wdHeaderFooterPrimary)`:
ここが最大のポイントです。`ActiveDocument.Shapes` ではなく、`sec.Headers(…).Shapes` と書くことで、初めてヘッダーというレイヤーにアクセスできます。
3. 防御的プログラミング(Defensive Programming):
図形が見つからないときにエラーで止まってしまうのは、素人のコードです。`If shp.Name = “Logo”` で判定し、見つからなくても次のセクションへ進むように設計しています。

4. よく陥るエラーと回避策(トラブルシューティング)

現場でよく遭遇する「罠」をいくつか共有しておきます。

# ① 「図形が見つからない!」問題

図形には「名前」があります。しかし、図形をコピー&ペーストすると、名前が `Picture 1`、`Picture 2` と自動的に変わってしまいます。
解決策:
VBAで操作する図形には、あらかじめ[図形の書式設定]やプロパティから、明示的に名前(例: `”Logo”`)をつけておく習慣をつけましょう。

# ② 「Shape」と「InlineShape」の混同

これが最も多いミスです。

  • Shape: 浮いている図形。文字の上や後ろに配置でき、`Left` や `Top` で座標指定が可能。
  • InlineShape: 文字と同じ扱い(行内配置)の図形。座標指定ではなく、文字の位置として扱われる。

ヘッダーで自由な位置に配置したいなら、必ず 「Shape」 として挿入してください。もし `InlineShape` を操作しようとして `shp.Left` と書くと、「そんなプロパティはありません」とエラーになります。

# ③ 座標がズレる

Wordには「余白」があります。`shp.Left = 0` と指定したとき、それは「ページの端」からなのか「余白の内側」からなのか、設定によって解釈が揺らぐことがあります。
解決策:
可能な限り、基準となる位置(左端や上端)を明確に意識し、必要に応じて `RelativeHorizontalPosition` などのプロパティを併用して、「どこからの距離か」を明示的に指定するのがプロの技です。

最後に:一歩先のエンジニアへ

いかがでしたか?

ヘッダーの図形を操るということは、単に見た目を整えることではありません。Wordという巨大で複雑なオブジェクトモデルの「構造」を理解し、目に見えないレイヤーを制御する力を手に入れたということです。

この「レイヤー(StoryRange)を意識する」という考え方は、Wordに限らず、あらゆる自動化業務に応用できる普遍的な知見です。

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

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