「マクロの記録」の先へ。Visio VBAでマスターシェイプの競合を支配する極限の管理術
こんにちは。現場の設計自動化を支えるアーキテクトへようこそ。
Visioで大規模な図面を描き始めると、必ずと言っていいほど直面する「壁」があります。それは、「複数のステンシルを使っているうちに、同じ名前のマスターシェイプが混在して、どれが正しいのか分からなくなる」という問題です。
「マクロの記録」を使っている段階では、単に「図形を置く」ことだけに集中していれば問題ありません。しかし、プロフェッショナルとして「設計の整合性を担保するツール」を作るなら、この「名前の衝突(Name Collision)」を論理的に解決するロジックが必要になります。
今日は、複数のステンシルから重複するマスターを検出し、どちらを優先するかを判定する「競合解消ロジック」の構築方法を伝授します。ここをマスターすれば、あなたのVisio VBAは「ただの自動化」から「信頼されるシステム」へと進化します。
1. なぜ「名前の重複」が致命的なのか?
Visioの構造を、エンジニアの視点で整理してみましょう。
- Application(Visio本体)
- Document(今開いている図面)
- Stencil(道具箱:複数のマスターが入っている)
- Master(個々の部品:名前、形状、データを持つ)
ここで問題が発生します。
例えば、「標準ネットワーク構成」ステンシルと、「プロジェクト専用」ステンシルの両方に “Router” という名前のマスターがあったとします。
プログラムで `Application.Application.Stencil(“Standard”).Masters(“Router”)` と指定したつもりが、環境によって意図しない方の “Router” が呼ばれてしまう……。これは、自動化ツールが「誤った部品を使って図面を生成する」という、設計ミスに直結する致命的なエラーを引き起こす原因になります。
2. 解決への戦略:Dictionaryオブジェクトの活用
重複を検知するためには、「一度見た名前を記憶しておく場所」が必要です。
配列(Array)を使って一つずつ比較することもできますが、それはプロの書き方ではありません。計算量が $O(n^2)$ になり、ステンシル内のマスターが増えるほど動作が劇的に重くなります。
ここで投入するのが、`Scripting.Dictionary` です。
Dictionaryは「キー(名前)」と「値(その名前がどこに属しているか)」をペアで保持します。名前の検索が極めて高速($O(1)$)であるため、大量のマスターをスキャンする場合でもパフォーマンスが落ちません。
競合解消のアルゴリズム(思考プロセス)
1. 空の Dictionary を用意する。
2. 開いているすべての Stencil をループで回す。
3. 各ステンシル内のすべての Master をループで回す。
4. もし、その名前がすでに Dictionary に存在していたら……
- 「競合発生!」と判定。
- あらかじめ決めた「優先ルール」に基づき、どちらを残すか決定する。
5. 存在していなければ……
- Dictionary に「名前」と「ステンシル名」を登録する。
3. 実装:マスター競合検出・解決エンジン
それでは、実際に動くコードを見ていきましょう。今回は「特定のキーワードを含むステンシルを優先する」というルールを組み込んだ、実戦的なコードを用意しました。
''**
'' 目的: 開いているステンシル内のマスター名の重複を検出し、優先順位に基づき管理する
'' 備考: Scripting.Dictionary を使用して高速化を実現
''**
Sub ResolveMasterConflicts()
Dim dict As Object
Set dict = CreateObject("Scripting.Dictionary") ' 後期バインディングで参照設定不要に
Dim stl As Visio.Stencil
Dim mst As Visio.Master
Dim masterName As String
Dim stencilName As String
Dim conflictCount As Integer
conflictCount = 0
On Error GoTo ErrorHandler
' 1. 全ての開いているステンシルを走査
' Application.DocumentStencils は現在アプリケーションでロードされているステンシルを指す
For Each stl In Application.DocumentStencils
stencilName = stl.Name
' 2. ステンシル内の各マスターを走査
For Each mst In stl.Masters
masterName = mst.Name
' 3. 重複チェック
If dict.Exists(masterName) Then
' --- 競合発生時のロジック ---
conflictCount = conflictCount + 1
Dim existingStencil As String
existingStencil = dict(masterName)
' 【優先ルール例】
' ステンシル名に "Standard" が含まれるものを優先し、それ以外を警告する
If InStr(1, stencilName, "Standard", vbTextCompare) > 0 And _
InStr(1, existingStencil, "Standard", vbTextCompare) = 0 Then
Debug.Print "【競合解消】" & masterName & " を " & stencilName & " に差し替えました。"
dict(masterName) = stencilName
Else
Debug.Print "【警告】競合を検出: " & masterName & " (既知: " & existingStencil & " / 新規: " & stencilName & ")"
Debug.Print " -> 現在の優先順位を維持します。"
End If
' ---------------------------
Else
' 4. 新規マスターとして登録
dict.Add masterName, stencilName
End If
Next mst
Next stl
' 結果報告
MsgBox "スキャン完了。" & vbCrLf & _
"検出された競合数: " & conflictCount & vbCrLf & _
"解析詳細はイミディエイトウィンドウを確認してください。", vbInformation, "マスター管理システム"
Set dict = Nothing
Exit Sub
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical
Set dict = Nothing
End Sub
コードの解説(ここがプロの視点!)
1. `CreateObject(“Scripting.Dictionary”)`:
あえて「参照設定(Microsoft Scripting Runtime)」を行わない「後期バインディング(Late Binding)」を採用しています。これにより、このマクロを他のユーザーに配布した際、「参照設定が足りなくて動かない!」という初歩的なトラブルを防げます。
2. `InStr` による優先判定:
単に「重複している」と警告を出すだけでなく、`InStr` 関数を使ってステンシル名に `”Standard”` という文字列が含まれているかを判定しています。これにより、「標準的な部品ならこちらを優先する」というビジネスルールをコードに落とし込むことができています。
3. `Debug.Print` の活用:
ユーザーへの `MsgBox` は「結果」だけを伝え、詳細なプロセス(どの名前が、どのステンシルと衝突したのか)は `Debug.Print` でイミディエイトウィンドウに出力しています。これは、大規模な開発におけるデバッグの鉄則です。
4. 陥りやすい罠:パフォーマンスとオブジェクトの寿命
中級者への階段を登るなら、以下の2点に注意してください。
① オブジェクトのライフサイクル
コード内で `Set dict = Nothing` を忘れないでください。VBAはガベージコレクション(メモリ解放)が強力ですが、大規模なループ内で大量のオブジェクトを生成・保持し続けると、メモリリークの原因になり、Visioの動作が不安定になります。
② 「表示されているステンシル」と「ロードされているステンシル」
`Application.DocumentStencils` は、現在Visioがメモリ上に展開しているステンシルを指します。ユーザーが「ステンシルウィンドウ」に表示させていないステンシルは、ここには現れません。もし、特定のファイルに埋め込まれたステンシルまで管理したい場合は、`Document.DocumentStencils` を走査するなどのアプローチが必要になります。
まとめ:ここをクリアすれば、基本はバッチリです
「名前が被っているから、手動で直す」……そんな作業は、エンジニアの仕事ではありません。
今回学んだ 「Dictionaryによる高速な重複検知」 と 「ルールに基づいた競合解消ロジック」 を実装できれば、あなたの作るツールは、どれほど複雑なステンシル構成であっても、常に正しい部品を選択できるようになります。
「マクロの記録」で覚えた断片的なコードを、こうした「論理的な構造」で繋ぎ合わせていく。その積み重ねが、あなたを「単なるユーザー」から「設計自動化エンジニア」へと変えてくれます。
一歩ずつ、着実に進んでいきましょう。応援していますよ!
