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

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

配置した瞬間、図形が「意志」を持つ。Visio VBAによるドロップイベント制御と接続ポイントの自動生成

こんにちは。設計自動化の世界へようこそ。

「マクロの記録」を使って、なんとか自動化の第一歩を踏み出したあなた。素晴らしい一歩です。しかし、記録されたコードを眺めていて、「もっとこう、図形を置いた瞬間に、自動的に何かを仕込みたいんだよな……」ともどかしさを感じたことはありませんか?

例えば、特定の図形をキャンバスにドロップした瞬間に、その図形の四隅に「コネクタを繋ぐための専用ポイント」が自動的に生成される……。そんな、まるで図形が自ら意思を持って形を変えるような挙動。

これは、単なる「操作の記録」の延長線上にはありません。Visioの「イベント駆動型プログラミング」という、一段高いステージの技術です。

今日は、エンジニアとして一歩抜け出すための鍵となる、「ドロップイベント(Drop Event)」の制御について、その本質を解き明かしていきましょう。ここをクリアすれば、あなたのVisio開発は「記録」から「設計」へと進化しますよ。

1. 概念の整理:マスターとインスタンスの境界線

コードを書く前に、プロフェッショナルとして絶対に外してはいけない「オブジェクトのライフサイクル」の話をさせてください。

Visioにおける図形には、二つの姿があります。

1. マスターシェイプ (Master Shape): ステンシルの中に眠っている「設計図」です。
2. インスタンス (Instance): ユーザーがキャンバスにドラッグ&ドロップして、実際に配置された「実体」です。

初心者が陥りやすい罠は、「マスターシェイプを書き換えようとしてしまうこと」です。マスターを書き換えると、ステンシル内のすべての図形が変わってしまい、後戻りができなくなります。

私たちが今回行うべきことは、「ドロップされた瞬間に、その『インスタンス』に対してのみ、動的に接続ポイントを付与する」という制御です。この違いを理解しているだけで、設計の堅牢性は劇的に向上します。

2. 核心:`Document_Drop` イベントとは何か

Visio VBAにおいて、図形が配置される動作を検知する窓口が `Document_Drop` イベントです。これは、図形が「ドロップされた」という事実を、ドキュメント全体に通知する仕組みです。

このイベントは、標準モジュールではなく、`ThisDocument` モジュールに記述する必要があります。ここが、多くの開発者が最初につまずくポイントです。

実装の全体像

以下のコードは、「特定の名前を持つマスターシェイプ」がドロップされたときだけ、その図形に4つの接続ポイント(Connection Points)を自動生成する実装例です。

' --- ThisDocument モジュールに記述してください ---

Option Explicit

' 図形がドロップされた瞬間に呼び出されるイベントハンドラ
Private Sub Document_Drop(ByVal Shape As Visio.Shape)
    On Error GoTo ErrorHandler

    ' 1. ドロップされた図形が、我々が制御したい「特定のマスター」かどうかを判定
    ' ※ "MyStencil.vssx\SmartBox" の部分は、自身の環境に合わせて書き換えてください
    ' Master.Name をチェックすることで、関係ない図形への干渉を防ぎます。
    If Shape.Master.Name = "MyStencil.vssx\SmartBox" Then
        
        ' 2. 自動接続ポイント生成のメインロジックへ
        Call AddCustomConnectionPoints(Shape)
        
    End If

    Exit Sub

ErrorHandler:
    ' 現場では、エラーで止まるよりも「ログを残して継続する」ことが重要です
    Debug.Print "Error in Document_Drop: " & Err.Description
End Sub

''' <summary>
''' 指定された図形に対して、四隅に接続ポイントを生成するサブプロシージャ
''' </summary>
''' <param name="targetShape">対象となる図形インスタンス</param>
Private Sub AddCustomConnectionPoints(ByVal targetShape As Visio.Shape)
    Dim cp As Visio.ConnectionPoint
    
    ' 描画のちらつきを抑え、パフォーマンスを向上させるための定石
    ' (大規模な図面では非常に重要です)
    
    ' 接続ポイントの追加
    ' AddConnectionPoint(x, y) : x, y は図形のローカル座標系(0.0 〜 1.0)で指定します
    
    ' 左下
    targetShape.AddConnectionPoint 0.1, 0.1
    ' 右下
    targetShape.AddConnectionPoint 0.9, 0.1
    ' 左上
    targetShape.AddConnectionPoint 0.1, 0.9
    ' 右上
    targetShape.AddConnectionPoint 0.9, 0.9
    
    ' 補足:座標は図形の「Size」に基づいた相対値(0〜1)で指定するのが、
    ' 図形サイズが変わってもポイントがズレないためのプロのテクニックです。
End Sub

3. コードの深層解剖:なぜこう書くのか?

このコードには、単なる「動くコード」以上の、設計思想が込められています。

① なぜ `Shape.Master.Name` を判定するのか?

`Document_Drop` は、図面上のあらゆる図形が置かれたときに実行されます。もし判定を入れずに処理を走らせると、ユーザーがただの「四角形」を置いたときにも、重たい計算やポイント生成が走ってしまいます。
「対象を絞り込む」ことは、パフォーマンスと安定性を守るための鉄則です。

② 座標指定の魔法:0.0 〜 1.0 の世界

`AddConnectionPoint` に渡す座標は、ページ全体の座標ではなく、図形自身のローカル座標です。
ここで `0.5, 0.5` と指定すれば、図形がどれだけ大きくても小さくても、常に「真ん中」にポイントが作られます。この「相対的な指定」こそが、図形のサイズ変更に強い(Robustな)設計を作る秘訣です。

4. 陥りやすい「落とし穴」と回避策

実戦投入する前に、以下の3点に注意してください。これを知っているだけで、デバッグの時間は半分になります。

1. 無限ループの恐怖:
もし、イベントハンドラの中で「新しい図形を生成する(`Shapes.Add`)」ような処理を書いてしまうと、その生成がまた `Drop` イベントを発生させ……という無限ループに陥る危険があります。今回は「既存の図形を加工するだけ」なので安全ですが、常に意識してください。

2. エラーハンドリングの重要性:
ユーザーが操作中にVBAがエラーで止まると、そのユーザーは「Visioが壊れた」と感じてしまいます。`On Error GoTo ErrorHandler` を使い、エラーが起きても静かに処理を抜ける、あるいはログを出す設計にしましょう。

3. マスター名の不一致:
`Shape.Master.Name` で判定する場合、ステンシルのファイル名やマスター名が少しでも違うと、一切反応しません。まずは `Debug.Print Shape.Master.Name` を使って、実際にどのような名前が返ってきているかを確認する癖をつけましょう。

最後に:自動化の先にあるもの

いかがでしたか?

単に「図形を置く」という動作が、VBAによって「図形が自身の接続ルールを準備する」という高度なプロセスに変わりました。これが、エンジニアリングの醍醐味です。

「マクロの記録」は、あくまで「答え」を教えてくれるガイドです。しかし、今回学んだ「イベント」や「オブジェクトのライフサイクル」は、あなたが自ら「問い」を立て、システムを構築するための「武器」になります。

一歩ずつ、確実に。コードの向こう側にある、洗練された自動化の世界を楽しんでください。応援していますよ!

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