【入門編】【中級】複数のステンシルから「重複する名前」のマスターシェイプを検出し、競合を解消する – Visio VBA解析バイブル

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

「マクロの記録」の先へ。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による高速な重複検知」 と 「ルールに基づいた競合解消ロジック」 を実装できれば、あなたの作るツールは、どれほど複雑なステンシル構成であっても、常に正しい部品を選択できるようになります。

「マクロの記録」で覚えた断片的なコードを、こうした「論理的な構造」で繋ぎ合わせていく。その積み重ねが、あなたを「単なるユーザー」から「設計自動化エンジニア」へと変えてくれます。

一歩ずつ、着実に進んでいきましょう。応援していますよ!

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