【入門編】【初心者】Visio図面上の「使用済みマスターシェイプ」をステンシルから逆引きして特定する方法 – Visio VBA解析バイブル

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

図面から「元ネタ」を突き止める: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という強力な武器を、あなたの手の一部にしていってくださいね。

応援していますよ!

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