図面から「元ネタ」を突き止める:Visio VBAにおけるマスターとステンシルの逆引き術
こんにちは。Visioの広大なオブジェクトモデルの海へようこそ。
「マクロの記録」を使って、なんとか自動化の第一歩を踏み出した皆さん、素晴らしいスタートです。でも、ふとした瞬間にこんな壁にぶつかったことはありませんか?
「この図面にあるこのシェイプ、一体どのステンシルから持ってきたんだっけ……?」
複雑な設計図や大規模なネットワーク構成図を扱っていると、シェイプの数だけ増え、どのパーツがどのライブラリ(ステンシル)に属しているのか分からなくなることがあります。これを手作業で探すのは、砂漠の中から一本の針を探すようなものです。
今日は、そんな「迷子」を防ぐためのテクニックを伝授しましょう。図面上のシェイプから、その「親」であるマスターシェイプを、さらにその「家」であるステンシルを特定する――。この「逆引き」のロジックをマスターすれば、あなたのVisio自動化スキルは「記録」のレベルから「設計」のレベルへと一気に跳躍します。
ここをクリアすれば、Visio VBAの基本はバッチリですよ。さあ、一緒に見ていきましょう。
1. 概念の整理:シェイプ、マスター、ステンシルの関係性
コードを書く前に、まずはVisioの「オブジェクトの親子関係」を整理しておきましょう。ここを曖昧にすると、後で必ずエラーの迷宮に迷い込みます。
Visioの世界は、以下のような階層構造になっています。
1. Stencil(ステンシル): パーツが格納されている「カタログ」や「道具箱」です。
2. Master(マスターシェイプ): カタログに載っている「設計図(テンプレート)」です。
3. Shape(シェイプ): 図面に配置された「実体」です。
イメージとしては、「ステンシル」という本の中に、「マスター」というレシピがあり、そのレシピを元に作られた料理が、図面上の「シェイプ」である、と考えてください。
私たちがやりたいのは、「目の前の料理(Shape)を見て、そのレシピ(Master)を特定し、どの本(Stencil)に載っているかを見つけ出す」という作業です。
2. 実践:逆引きを実現する魔法のコード
それでは、実際に動くコードを見てみましょう。
このコードは、「現在選択しているシェイプ」に対して、その正体を突き止めてメッセージボックスで表示するものです。
Sub IdentifyShapeOrigin()
' 変数の宣言:型を明示するのは、プロフェッショナルへの第一歩です
Dim selectedShape As Visio.Shape
Dim masterShape As Visio.Master
Dim parentStencil As Visio.Document
' 1. 現在選択されているシェイプを取得
' 何も選択されていない場合にエラーにならないよう、チェックを入れるのがコツです
If Visio.ActiveWindow.Selection.Count = 0 Then
MsgBox "先に図面上のシェイプを選択してくださいね。", vbExclamation
Exit Sub
End If
' 最初の選択オブジェクトをターゲットにします
Set selectedShape = Visio.ActiveWindow.Selection(1)
' 2. シェイプから「マスター」を特定する
' ここが最大のポイント!シェイプには .Master プロパティがあります
Set masterShape = selectedShape.Master
' 【重要】マスターが存在するかどうかの判定
' 手書きで描いた図形(線など)には「マスター」が存在しないため、Nothing になります
If masterShape Is Nothing Then
MsgBox "このシェイプは、ステンシルから配置されたものではありません。" & vbCrLf & _
"(手書きの図形や、マスターを持たないシェイプのようです)", vbInformation
Exit Sub
End If
' 3. マスターから「ステンシル(ドキュメント)」を特定する
' マスターは、自分が属しているステンシルを .Stencil プロパティで持っています
Set parentStencil = masterShape.Stencil
' 4. 結果を表示
' 丁寧に情報を組み立てて、ユーザーに伝えます
Dim info As String
info = "【調査結果】" & vbCrLf & vbCrLf
info = info & "■ シェイプ名: " & selectedShape.Name & vbCrLf
info = info & "■ マスター名: " & masterShape.Name & vbCrLf
info = info & "■ 所属ステンシル: " & parentStencil.Name
MsgBox info, vbInformation, "シェイプの正体判明"
End Sub
3. エンジニアの視点:なぜこのコードが必要なのか?(陥りやすい罠)
さて、コードは書けましたが、ここで「なぜこう書くのか」という本質に触れておきましょう。ここを知っているかどうかが、初級者とプロフェッショナルの分かれ目です。
罠その1:`Nothing` の恐怖
コードの中で `If masterShape Is Nothing Then` という一文を入れましたね? これ、実は絶対に省略してはいけない一文です。
Visioでは、ツールバーからドラッグ&ドロップしたシェイプには必ず「マスター」が紐付いています。しかし、ペンツールで自由に描いた線や、コピー&ペーストで加工された一部の特殊な図形には、マスターが存在しないことがあります。
もし、マスターがないシェイプに対して `masterShape.Name` を参照しようとすると、プログラムは「オブジェクト変数または With ブロック変数が設定されていません」という無慈悲なエラーを吐いて止まってしまいます。
「もし空っぽだったら(Nothingだったら)、処理を中断する」というガード(防御策)を入れる。これが、止まらないプログラムを作る鉄則です。
罠その2:`Stencil` は `Document` オブジェクトである
Visioのオブジェクトモデルにおいて、ステンシルは `Visio.Document` という型で扱われます。
「ステンシルはファイルのようなものだから、Document型で扱うんだな」と理解しておくと、将来的に「ステンシルを保存する」「ステンシルを開く」といった操作をしたい時に、迷うことがなくなります。
4. まとめ:次の一歩へ
今回の手法をマスターすれば、例えば以下のような高度な自動化への道が開けます。
- 「図面内の全シェイプをスキャンし、特定のステンシルに含まれるものだけを抽出してリスト化する」
- 「特定のマスターを使っているシェイプだけ、色を一括変更する」
これらは、単なる「記録」では絶対に不可能な、ロジックに基づいた自動化です。
プログラミングは、魔法ではありません。オブジェクトがどのような親子関係を持ち、どのようなルールで動いているかという「構造」を理解する作業です。
今日の「逆引き」はその構造を理解するための、とても素晴らしい練習台になりました。
一歩ずつ、着実に。Visio VBAという強力な武器を、あなたの手の一部にしていってくださいね。
応援していますよ!
