【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の基本はバッチリですよ。自信を持って進んでくださいね!
