【テクニカル・上級編】【中級】マスターシェイプの「ドロップ時イベント」をVBAで制御し、自動で接続ポイントを生成する – Visio VBA解析バイブル

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

Dynamic Topology: MASTER Shapeの「生命」を吹き込む――ドロップイベントによる接続ポイントの動的注入術

図面を描くという行為を、単なる「記号の配置」と考えているなら、君はまだエンジニアではない。それは単なるオペレーターの仕事だ。

真のシステムアーキテクトにとって、Visioにおける図形とは、特定のプロパティと振る舞い、そして動的なトポロジー(接続構造)を内包した「オブジェクト」でなければならない。マスターシェイプをドロップした瞬間、その図形が自身の役割を理解し、必要な接続ポート(Connection Points)を自律的に展開する――この「動的な自己構成」を実現することこそが、複雑なシステム設計図を自動化する鍵となる。

本稿では、マスターシェイプのドロップを検知し、実行時に接続ポイントを動的に生成する、極めて堅牢な実装手法について解説する。単なるコードの書き方ではない。メモリのライフサイクル、イベントのオーバーヘッド、そしてレガシー環境における安定性を考慮した、実戦的なアーキテクチャの話だ。

1. 凡庸な実装が陥る「イベントの罠」

多くの開発者が、マスターシェイプに直接 `ShapeSheet` の `Event` セルを書き込み、VBA関数を呼び出そうとする。しかし、これは設計として極めて脆弱だ。

1. メンテナンス性の欠如: マスターシェイプが増えるたびに、ShapeSheetの数式を書き換える必要がある。これは「自動化」の理念に反する。
2. 実行時エラーの連鎖: ShapeSheetからVBAを呼び出す際、オブジェクトの参照が不安定になりやすく、予期せぬメモリリークやVisioのハングアップを引き起こす原因となる。
3. パフォーマンスの劣化: 大規模な図面において、個々のシェイプにイベントハンドラを持たせることは、アプリケーションのイベントキューを汚染し、描画パフォーマンスを著しく低下させる。

我々が目指すべきは、「ドキュメントレベルでの監視」と「メタデータによる識別」を組み合わせた、集中管理型のアーキテクチャである。

2. アーキテクチャ設計:Observer Patternの適用

マスターシェイプ自体にロジックを持たせるのではなく、`ThisDocument` または専用の `Class Module` を「監視役(Observer)」として機能させる。

戦略的アプローチ

  • 識別子(Tagging): マスターシェイプには、`UserData` セクションを用いて「どのロジックを適用すべきか」を示すIDを埋め込んでおく。
  • イベントフック: `Document.WindowSelectionChange` や、より低レイヤーでの変更検知を利用する。ここでは、最も確実な「シェイプの追加・変更」を捕捉する手法をとる。
  • 動的注入: 識別子が一致したシェイプに対し、VBAから `AddConnectionPoint` メソッドを実行する。

3. 実装:極限の堅牢性を備えたコード

以下に、プロフェッショナルな実装例を示す。このコードは、クラスモジュールを用いたイベント管理と、メモリリークを防止するための明示的なオブジェクト解放を組み込んでいる。

Step 1: Class Module (`clsShapeObserver`) の作成

まず、イベントを捕捉するためのクラスを作成する。これにより、`ThisDocument` を汚さず、カプセル化されたロジックを実現できる。

' Class Module: clsShapeObserver
Option Explicit

Private WithEvents objWindow As Visio.Window
Private objDoc As Visio.Document

' 初期化メソッド
Public Sub Initialize(doc As Visio.Document)
    Set objDoc = doc
    Set objWindow = doc.ActiveWindow
End Sub

' ウィンドウの選択変更(シェイプ配置直後の検知に利用)
Private Sub objWindow_SelectionChange(ByVal window As Visio.Window)
    Dim sel As Visio.Selection
    Dim shp As Visio.Shape
    Dim targetTag As String
    
    Set sel = window.Selection
    
    ' 選択範囲が空、またはシェイプでない場合は即座に抜ける
    If sel.Count = 0 Then Exit Sub
    
    ' 選択された最初のシェイプを解析
    Set shp = sel.Item(1)
    
    ' UserDataから識別子を取得(事前にマスターシェイプに設定しておく)
    ' 例: "Type" という名前のデータに "Server" が入っている場合
    On Error Resume Next
    targetTag = shp.CellsU("UserData.Type").ResultStr(visExists)
    On Error GoTo 0
    
    ' 識別子が空なら何もしない
    If targetTag = "" Then Exit Sub
    
    ' 特定のタイプに対する動的プロセスの実行
    Select Case targetTag
        Case "Server"
            InjectServerConnectionPoints shp
        Case "Switch"
            InjectSwitchConnectionPoints shp
    End Select
    
    ' メモリ管理:ローカル変数の明示的な解放
    Set shp = Nothing
    Set sel = Nothing
End Sub

' --- 接続ポイント注入ロジック ---

Private Sub InjectServerConnectionPoints(ByRef shp As Visio.Shape)
    ' 既にポイントが存在するかチェック(二重生成防止)
    ' 接続ポイントの数は ShapeSheet の ConnectionPts セクションで管理される
    
    On Error GoTo ErrorHandler
    
    ' 既存のポイントをクリアしたい場合はここで行うが、
    ' 通常は「未定義のポイントのみ追加」がセオリー
    
    ' 例: 座標 (0.5, 0.1) に "Power" ポートを追加
    ' 座標はセル相対値(0-1)で指定
    shp.AddConnectionPoint 0.5, 0.1
    ' 接続ポイントに名前を付ける(ShapeSheetのプロパティを操作)
    ' ※注意: ConnectionPoint自体に直接名前を付ける標準メソッドはないため、
    ' 通常は接続用のラベル(テキスト)や、ShapeSheetの管理用セルを利用する。
    
    ' ログ出力(デバッグ用)
    Debug.Print "Successfully injected Server ports for: " & shp.Name
    
CleanUp:
    Exit Sub

ErrorHandler:
    ' レガシー環境や複雑な図形でのエラーを捕捉
    Debug.Print "Error in InjectServerConnectionPoints: " & Err.Description
    Resume CleanUp
End Sub

Private Sub InjectSwitchConnectionPoints(ByRef shp As Visio.Shape)
    ' Switch用のロジック(実装は同様)
    shp.AddConnectionPoint 0.2, 0.5
    shp.AddConnectionPoint 0.8, 0.5
End Sub

' デストラクタ的な役割
Public Sub Terminate()
    Set objWindow = Nothing
    Set objDoc = Nothing
End Sub

Step 2: `ThisDocument` でのインスタンス管理

次に、アプリケーション起動時にこの監視役を起動させる。

' ThisDocument Module
Option Explicit

Private m_Observer As clsShapeObserver

' ドキュメントが開いた際に監視を開始
Private Sub Document_Open()
    Set m_Observer = New clsShapeObserver
    m_Observer.Initialize ThisDocument
End Sub

' ドキュメントが閉じられる際のクリーンアップ
' これを怠ると、Visioプロセスがメモリに残る「ゴースト現象」の原因となる
Private Sub Document_Close()
    If Not m_Observer Is Nothing Then
        m_Observer.Terminate
        Set m_Observer = Nothing
    End If
End Sub

4. エンジニアが知るべき「極限の知見」

この実装を運用するにあたり、シニアエンジニアとして以下の3点に留意せよ。

I. メモリ・ライフサイクルの厳格な管理

VBAは、オブジェクトの参照が残っている限り、そのメモリを解放しない。特に `Window` や `Document` オブジェクトをクラス内に保持する場合、`Document_Close` で必ず `Set … = Nothing` を行い、参照カウントをゼロに落とせ。これを怠ると、Visioを閉じても `visio.exe` がタスクマネージャーに残り続け、サーバーサイドでの自動生成バッチなどがメモリ不足で死滅することになる。

II. UserData による疎結合化

マスターシェイプの「名前(Name)」に依存してロジックを分岐させてはいけない。図面内でユーザーがシェイプの名前を変更した瞬間、システムは崩壊する。必ず `UserData` セクションを使用せよ。これは図形の「属性」であり、図形の「識別名」とは別物である。この分離こそが、堅牢な設計の基本だ。

III. Windows API との境界線

もし、接続ポイントの生成と同時に、外部の資産管理データベース(SQL Server等)から最新のポート構成を取得したい場合は、VBAから直接ADOを使うのではなく、必要に応じて Windows API (`SendMessage`) を介した外部プロセスとの通信や、COMオートメーションの最適化を検討せよ。大量のシェイプを配置する際、一つ一つの生成イベントでネットワークI/Oが発生すると、ユーザー体験は最悪になる。データのフェッチは「一括(Bulk)」で行い、メモリ上にキャッシュしてから、イベントハンドラ内で分配するのがプロのやり方だ。

結論

マスターシェイプのドロップイベントを制御することは、単なる自動化ではない。それは、静的な図面を、「ルールに従って自己増殖する動的なシステムモデル」へと昇華させる行為である。

正しいアーキテクチャを選択し、メモリとイベントの挙動を支配せよ。それが、伝説的なエンジニアへの第一歩だ。

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