【極限の知見】Visio VBAにおけるマスターシェイプの逆引き:オブジェクトモデルを正しく辿る設計論
業務自動化の現場において、「図面上のこの図形(Shape)は、一体どのステンシルから持ってきたものか?」という問いに直面することは珍しくない。部品表(BOM)の自動生成や、使用済みコンポーネントの監査ツールを作成する際、この「逆引き」は避けて通れない要件だ。
しかし、多くの初学者がここで犯す致命的なミスがある。それは、「すべてのステンシルとすべてのマスターをループで回して、名前が一致するか片っ端から照合する」という、計算量の無駄遣いである。
このようなブルートフォース(総当たり)的な設計は、ステンシルの数が増え、図面内のオブジェクトが増大した瞬間に、パフォーマンスの崖から転落する。
本記事では、Visioのオブジェクトモデルの本質を突き、極めて低負荷かつ堅牢に「図形からマスター、そしてステンシルを特定する」ための設計思想と、プロダクションレベルのコードを伝授する。
1. 思考の転換:検索するな、辿れ
設計者としてまず理解すべきは、Visioのオブジェクト間のリレーションシップ(関係性)だ。
図面上の `Shape` オブジェクトは、自分がどの `Master` から生成されたかという情報を、自身のプロパティとして既に保持している。さらに、その `Master` は自分がどの `Stencil` に属しているかを知っている。
つまり、我々がすべきことは「探す(Search)」ことではなく、「参照を辿る(Traverse)」ことなのだ。
階層構造の理解
1. `Shape` (図面上のオブジェクト)
2. $\to$ `Shape.Master` (その図形の設計図)
3. $\to$ `Master.Stencil` (設計図が格納されているファイル)
このパスを辿るだけで、目的の情報に $O(1)$ に近い計算量で到達できる。これが「プロの設計」だ。
2. 堅牢な設計における「死角」:マスターを持たないシェイプ
ここで、設計上の大きな落とし穴(エッジケース)について触れておく。
Visioにおいて、すべての `Shape` が `Master` を持っているわけではない。例えば、ユーザーがペンツールで手書きした線や、単に図形をコピーして加工しただけのオブジェクト、あるいはマスターが削除された後の図形などは、`Shape.Master` が `Nothing` (Null)を返す。
この「Nothing」に対するガード(防御)を怠ると、プログラムは無残に `Run-time error ’91’: Object variable or With block variable not set` を吐いて停止する。プロダクションコードにおいて、例外処理のないコードは単なる「動くかもしれないゴミ」に過ぎない。
3. プロダクション・コードの実装例
以下に、実務でそのまま利用可能な、堅牢性を極限まで高めたVBAコードを示す。このコードは、単に情報を返すだけでなく、エラーハンドリングとオブジェクトのライフサイクルを考慮した設計になっている。
' ==============================================================================
' Module: Mod_ShapeAnalyzer
' Description: 図形からマスターおよびステンシル情報を安全に取得する
' Author: Chief Architect
' ==============================================================================
Option Explicit
' 取得した情報を格納するための構造体(User-Defined Type)
' 戻り値を複数の変数で返すのではなく、一つの型にまとめることで保守性を高める
Public Type MasterInfo
IsFromMaster As Boolean ' マスター由来の図形かどうか
MasterName As String ' マスターの名前
StencilName As String ' ステンシルの名前
StencilPath As String ' ステンシルのファイルパス(重要)
End Type
''' <summary>
''' 指定されたシェイプから、その元となったマスターとステンシルの情報を逆引きする。
''' </summary>
''' <param name="shp">解析対象の Visio.Shape オブジェクト</param>
''' <returns>MasterInfo 構造体</returns>
Public Function GetMasterDetails(ByVal shp As Visio.Shape) As MasterInfo
Dim info As MasterInfo
' 初期化
info.IsFromMaster = False
info.MasterName = ""
info.StencilName = ""
info.StencilPath = ""
' 1. オブジェクトの存在チェック(防御的プログラミング)
If shp Is Nothing Then
Exit Function
End If
' 2. マスターの存在確認
' Shape.Master が Nothing の場合、それはステンシル由来ではない(手書き等)
If Not shp.Master Is Nothing Then
On Error Resume Next ' 万が一のプロパティアクセスエラーに備える
info.IsFromMaster = True
info.MasterName = shp.Master.Name
' 3. ステンシルの存在確認
' マスターがステンシルに紐付いているかを判定
If Not shp.Master.Stencil Is Nothing Then
info.StencilName = shp.Master.Stencil.Name
' ステンシルが外部ファイル(.vssx等)の場合、パスを取得できる
' これにより、どのファイルから来たのかを完全に特定可能にする
info.StencilPath = shp.Master.Stencil.FullName
End If
On Error GoTo 0
End If
GetMasterDetails = info
End Function
''' <summary>
''' テスト実行用メインルーチン
''' </summary>
Public Sub Test_ShapeAnalysis()
Dim vsoPage As Visio.Page
Dim vsoShape As Visio.Shape
Dim info As MasterInfo
Set vsoPage = ActivePage
' 選択中のシェイプを解析する例
If ActiveWindow.Selection.Count = 0 Then
MsgBox "シェイプを選択してください。", vbExclamation
Exit Sub
End If
For Each vsoShape In ActiveWindow.Selection
info = GetMasterDetails(vsoShape)
Debug.Print "--- Shape Analysis ---"
Debug.Print "Name: " & vsoShape.Name
If info.IsFromMaster Then
Debug.Print "Master: " & info.MasterName
Debug.Print "Stencil: " & info.StencilName
Debug.Print "Path: " & info.StencilPath
Else
Debug.Print "Status: This shape is NOT from a master (e.g., drawn manually)."
End If
Next vsoShape
End Sub
4. アーキテクトの視点:データ連携とスケーラビリティ
このロジックを単なる「情報表示」で終わらせてはならない。実務における自動化ツールの価値は、その先の「データ活用」にある。
データベース・Excel連携への応用
もし君が、図面内の全コンポーネントを抽出し、ERP(基幹システム)やExcelの在庫管理リストと照合するツールを作っているなら、以下の設計指針を守れ。
1. 一意性の確保: `Master.Name` だけでは不十分だ。大規模なプロジェクトでは、同名のマスターが異なるステンシルに存在する可能性がある。必ず `Stencil.FullName`(フルパス)と `Master.Name` を組み合わせて、一意のキー(Composite Key)として扱え。
2. コレクションの活用: 図面全体を走査する場合、`ActivePage.Shapes` をループする際、シェイプが階層構造(Group Shapeの中にある等)を持っている可能性がある。`shp.AllChildren` を再帰的に処理する設計にすることを忘れるな。
3. バッチ処理の検討: 数千個のシェイプを解析してExcelに書き出す場合、セルへの書き込みを1つずつ行うのは愚策だ。一度メモリ上の配列(Array)や `Dictionary` オブジェクトにデータを蓄積し、最後に一括で出力する。これが、実行速度を劇的に変える。
結論
Visio VBAにおける「逆引き」の本質は、「オブジェクトの親子関係を正しく理解し、Nothingへの耐性を持たせ、パスを最短で辿ること」にある。
ブルートフォースによる力押しは、プロフェッショナルのコードではない。オブジェクトモデルの設計思想を理解し、堅牢な型(Type)を用いてデータを扱う。この積み重ねが、バグのない、そしてメンテナンス性の高い、真に価値のある自動化ツールを生むのだ。
