【入門編】【初心者】ステンシル内のマスターシェイプを「名前の完全一致」で抽出し、座標指定で自動配置する基本スクリプト – Visio VBA解析バイブル

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

【Visio VBA 掌握への第一歩】ステンシルからマスターを呼び出し、座標へ正確に配置する極意

「マクロの記録」ボタンを押して、生成されたコードを眺めて溜息をついたことはありませんか?
「動いてはいるけれど、なぜこの単語が並んでいるのかさっぱりわからない……」

もしあなたが今、そう感じているなら、おめでとうございます。あなたは「単なる作業の自動化」から、「プログラムによる設計」へと足を踏み入れる直前にいます。

こんにちは。今日は、Visio VBAの世界へようこそ。
今回のテーマは、自動描画の心臓部とも言える「ステンシル(Stencil)からマスターシェイプ(Master Shape)を特定し、指定した座標にドロップする」というプロセスです。

一見シンプルに見えますが、ここにはVisioのオブジェクトモデルの本質が詰まっています。ここをマスターすれば、あなたは「マウスで図形を置く」という作業から完全に解放されるでしょう。

1. 概念の整理:マスターとシェイプは「型」と「実体」である

コードを書く前に、まず頭の中に「概念の地図」を描きましょう。ここを曖昧にすると、必ずエラーの迷宮に迷い込みます。

Visioにおける図形の世界は、以下の3層構造になっています。

1. ステンシル (Stencil):図形の「カタログ」です。
2. マスター (Master):カタログに載っている「設計図(型)」です。まだページには存在しません。
3. シェイプ (Shape):設計図をもとに、ページ上に実際に配置された「実体」です。

初心者が陥りやすい最大のミスは、「マスターシェイプに対して、直接座標を指定しようとすること」です。
マスターはあくまで「型」です。座標(X, Y)を持つことができるのは、ページにドロップされた後の「シェイプ」だけなのです。

「マスターをドロップして、返ってきたシェイプを操作する」
この流れを脳に刻んでください。

2. 実装のレシピ:マスターを抽出し、座標指定で配置する

それでは、実際にコードを見ていきましょう。
今回のシナリオは、「開いているステンシルの中から、名前が完全に一致するマスターを探し出し、指定した座標(X=4, Y=5)に配置する」というものです。

Option Explicit

''' <summary>
''' 指定したステンシル内のマスターシェイプを、指定座標にドロップする
''' </summary>
''' <param name="stencilName">ステンシルの名前 (例: "Basic Shapes.vssx")</param>
''' <param name="masterName">マスターの名前 (例: "Rectangle")</param>
''' <param name="posX">配置するX座標</param>
''' <param name="posY">配置するY座標</param>
Sub DropMasterAtPosition()
    Dim vsoDocument As Visio.Document
    Dim vsoStencil As Visio.Document
    Dim vsoMaster As Visio.Master
    Dim vsoPage As Visio.Page
    Dim vsoShape As Visio.Shape
    Dim foundMaster As Boolean
    
    ' --- 設定エリア ---
    Dim targetStencil As String: targetStencil = "Basic Shapes.vssx"
    Dim targetMaster As String: targetMaster = "Rectangle"
    Dim targetX As Double: targetX = 4.0  ' インチまたは図面単位
    Dim targetY As Double: targetY = 5.0
    ' ------------------

    On Error GoTo ErrorHandler

    ' 1. 現在アクティブなページを取得
    Set vsoPage = ActivePage
    
    ' 2. ステンシルを探す(開いているものから探す)
    foundMaster = False
    For Each vsoDocument In Application.Documents
        ' ステンシルの名前が一致するか確認
        If vsoDocument.Name = targetStencil Then
            Set vsoStencil = vsoDocument
            Exit For
        End If
    Next vsoDocument

    ' ステンシルが見つからない場合の処理
    If vsoStencil Is Nothing Then
        MsgBox "エラー: ステンシル '" & targetStencil & "' が開かれていません。" & vbCrLf & _
               "あらかじめステンシルを開いてから実行してください。", vbCritical
        Exit Sub
    End If

    ' 3. ステンシル内からマスターを「名前の完全一致」で探す
    ' ※ Master.Name よりも Master.NameU (ユニバーサル名) を使うのがプロの作法です
    For Each vsoMaster In vsoStencil.Masters
        If vsoMaster.NameU = targetMaster Then
            foundMaster = True
            Exit For
        End If
    Next vsoMaster

    ' マスターが見つからない場合の処理
    If Not foundMaster Then
        MsgBox "エラー: マスター '" & targetMaster & "' がステンシル内に見つかりません。", vbExclamation
        Exit Sub
    End If

    ' 4. 【重要】マスターをページにドロップし、生成されたシェイプを変数に格納する
    ' Dropメソッドは、新しく作成されたShapeオブジェクトを返します
    Set vsoShape = vsoMaster.Drop(vsoPage)

    ' 5. シェイプの座標を設定する
    ' PinX, PinY はシェイプの中心点(ピン)の座標です
    vsoShape.CellsU("PinX").FormulaU = targetX
    vsoShape.CellsU("PinY").FormulaU = targetY

    MsgBox "成功: '" & targetMaster & "' を座標 (" & targetX & ", " & targetY & ") に配置しました。", vbInformation

    Exit Sub

ErrorHandler:
    MsgBox "予期せぬエラーが発生しました:" & vbCrLf & Err.Description, vbCritical
End Sub

3. プロの視点:ここが「分かれ道」です

コードを読み解きましたか? ここで、単なる初心者と、一歩抜き出たエンジニアを分ける3つの重要な知見をお伝えします。

① `Name` ではなく `NameU` を使え

コードの中で `vsoMaster.NameU` を使用しました。Visioには「Name(表示名)」と「NameU(ユニバーサル名)」の2種類があります。
表示名は、言語設定(日本語なら「長方形」、英語なら「Rectangle」)によって変わってしまいます。しかし、`NameU` は言語に依存しない内部的な識別子です。「名前で検索するなら、常にNameUを使う」。これが、世界中どこでも動く堅牢なコードを書く鉄則です。

② `Drop` メソッドの戻り値に注目せよ

ここが最大のポイントです。
`Set vsoShape = vsoMaster.Drop(vsoPage)`
この一行は、単に図形を置いているだけではありません。「設計図(Master)から実体(Shape)を生成し、その実体を操作するためのハンドル(変数)を掴み取っている」のです。
この戻り値を受け取らない限り、ドロップした図形を後から「色を変える」「位置を動かす」といった操作をすることはできません。

③ 座標指定の「ピン」という概念

`vsoShape.CellsU(“PinX”)`。
Visioにおいて、図形の座標は「図形のどこを基準にするか」というPin(ピン)によって決まります。デフォルトでは図形の中心がピンになっています。
もし、図形の左下を基準に配置したい場合は、ピンの位置を操作する必要がありますが、まずは「PinX/PinY = 図形の中心座標」と覚えておけば、自動配置の基本はバッチリです。

4. まとめ:次に進むあなたへ

今回のステップをクリアしたあなたは、もう「マクロの記録」の呪縛から解き放たれつつあります。

  • ステンシルは図形のライブラリ。
  • マスターは設計図。
  • ドロップによってシェイプが誕生する。
  • NameU を使って確実に特定する。

これらは、Visio VBAにおける「オブジェクトのライフサイクル」の基礎です。
次は、このシェイプの色を変えたり、テキストを書き込んだり、あるいはループ処理を使って大量の図形をグリッド状に整列させたり……。できることは無限に広がっています。

焦る必要はありません。一つひとつのオブジェクトが、メモリの中でどのように息づいているのかを想像しながら、コードを書いてみてください。

ここをクリアすれば、Visio VBAの基本はバッチリですよ。自信を持って進んでくださいね!

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