【実務直結】Visio VBAにおけるマスターシェイプ制御の極意:堅牢な自動配置エンジンの設計思想
「とりあえず、ステンシルからシェイプを引っ張ってきて、決まった場所に置くコードを書きました。動いています。」
もし君がプロジェクトのリーダーにそう報告したなら、私は即座にそのコードを破棄させるだろう。なぜなら、それは「動くスクリプト」であっても、業務システムとしての「堅牢なプログラム」ではないからだ。
現場で求められるのは、ユーザーが誤った名前を入力しても、ステンシルが閉じられていても、あるいは座標系が想定と違っていても、システムが沈黙したりクラッシュしたりしない「エラーへの耐性」と「予測可能性」を備えたコードだ。
本記事では、Visio VBAにおける「ステンシル内のマスターシェイプを特定し、指定座標へ配置する」という一見単純なタスクを、プロフェッショナルの視点でどう設計すべきかを徹底解説する。
1. 初学者が陥る「3つの致命的な設計ミス」
コードを書く前に、まず君が避けるべき「素人特リアリズム」を定義しておく。
① ステンシルの存在確認を怠る
「`Documents.Open(“MyStencil.vssx”)` を呼び出せばいい」と考えていないか? ステンシルが既に開いている場合、二重に開こうとしてエラーになるか、あるいはメモリを無駄に消費する。既存のインスタンスを再利用するロジックは必須だ。
② `Name` と `NameLocal` の混同
Visioのオブジェクトには `Name`(システム内部的な識別名)と `NameLocal`(ユーザーが見る表示名)がある。ユーザーが「矩形」という名前のマスターを探している場合、コード内で `Master.Name` を比較してもヒットしない。「何をもって一致とするか」の定義が曖昧なコードは、必ずバグを生む。
③ 座標系の「単位」に対する無知
Visioの内部単位は「ポイント」だ。しかし、実務の仕様書は「mm」や「inch」で書かれている。ここを無視してハードコーディングすると、配置された図形が豆粒のように小さかったり、画面外に飛んでいったりする。
2. プロフェッショナルな設計指針:モジュール化と責務の分離
堅牢なツールを作るなら、処理を以下の3つのフェーズに分離すべきだ。
1. Resource Management(リソース管理): ステンシルが利用可能か確認し、必要なら開く。
2. Object Discovery(オブジェクト探索): 指定された名前のマスターを、型安全に、かつ確実に特定する。
3. Execution(実行): 特定したマスターを、正しい座標系・単位でドロップする。
3. 実装例:プロダクション品質の配置エンジン
以下に、これら全ての設計思想を組み込んだコードを示す。単なるコピペではなく、各行の「意図」を読み解いてほしい。
Option Explicit
' ==============================================================================
' Module: ShapePlacementEngine
' Description: ステンシルからマスターを抽出し、正確な座標に配置する堅牢なエンジン
' ==============================================================================
''' <summary>
''' 指定したステンシル内のマスターを名前で検索し、ページ上の指定座標に配置する
''' </summary>
''' <param name="stencilPath">ステンシルファイルのフルパス(開いている場合はファイル名のみでも可)</param>
''' <param name="masterName">検索するマスターの表示名 (NameLocal)</param>
''' <param name="posX">配置するX座標</param>
''' <param name="posY">配置するY座標</param>
''' <param name="unit">使用する単位 (visMM, visInches, visPoints 等)</param>
Public Sub PlaceMasterWithPrecision( _
ByVal stencilPath As String, _
ByVal masterName As String, _
ByVal posX As Double, _
ByVal posY As Double, _
Optional ByVal unit As Visio.VisUnitType = visMM)
Dim vsoApplication As Visio.Application
Dim vsoPage As Visio.Page
Dim vsoStencil As Visio.Document
Dim vsoMaster As Visio.Master
Dim vsoDroppedShape As Visio.Shape
Dim foundMaster As Boolean
Set vsoApplication = Visio.Application
Set vsoPage = vsoApplication.ActivePage
foundMaster = False
On Error GoTo ErrorHandler
' 1. ステンシルの取得・管理 (Resource Management)
' 既に開いているか確認し、なければ開く
Set vsoStencil = GetOrOpenStencil(stencilPath)
' 2. マスターの探索 (Object Discovery)
' NameLocal(表示名)で完全一致検索を行う
For Each vsoMaster In vsoStencil.Masters
If StrComp(vsoMaster.NameLocal, masterName, vbTextCompare) = 0 Then
foundMaster = True
Exit For
End If
Next vsoMaster
If Not foundMaster Then
Err.Raise vbObjectError + 513, "PlacementEngine", _
"指定されたマスター '" & masterName & "' がステンシル内に見つかりません。"
End If
' 3. 配置の実行 (Execution)
' 座標をアプリケーションの単位系に合わせて変換してドロップ
' DropメソッドはPageの座標系を使用する
Set vsoDroppedShape = vsoPage.Drop(vsoMaster, posX, posY)
' 配置後の微調整(必要に応じて)
' 例: 形状の回転や色の変更など
Debug.Print "Successfully placed: " & masterName & " at (" & posX & ", " & posY & ")"
CleanUp:
' ここでステンシルを閉じる必要があるかは、設計思想(使い捨てか共有か)による
' 今回は「開いているものはそのまま」とする設計
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました:" & vbCrLf & Err.Description, vbCritical, "Placement Engine Error"
Resume CleanUp
End Sub
''' <summary>
''' ステンシルが既に開いているか確認し、開いていなければ開く
''' </summary>
Private Function GetOrOpenStencil(ByVal path As String) As Visio.Document
Dim doc As Visio.Document
Dim fileName As String
' パスからファイル名のみを抽出(既に開いているか判定するため)
fileName = Mid(path, InStrRev(path, "\") + 1)
' 既存のドキュメントから検索
For Each doc In Visio.Application.Documents
If doc.Name = fileName Then
Set GetOrOpenStencil = doc
Exit Function
End If
Next doc
' 見つからなければ開く
On Error Resume Next
Set doc = Visio.Application.Documents.Open(path)
On Error GoTo 0
If doc Is Nothing Then
Err.Raise vbObjectError + 514, "ResourceMgr", "ステンシルファイルを開けませんでした: " & path
End If
Set GetOrOpenStencil = doc
End Function
' ==============================================================================
' テスト実行用メインルーチン
' ==============================================================================
Sub TestPlacement()
' 実際の運用では、これらの値はExcelやDBから取得する
Dim targetStencil As String: targetStencil = "Basic Shapes.vssx" ' 標準ステンシル
Dim targetMaster As String: targetMaster = "Rectangle" ' 表示名
Dim x As Double: x = 50 ' 50mm
Dim y As Double: y = 50 ' 50mm
' 描画の高速化
Visio.Application.ScreenUpdating = False
Call PlaceMasterWithPrecision(targetStencil, targetMaster, x, y, visMM)
Visio.Application.ScreenUpdating = True
MsgBox "配置完了"
End Sub
4. アーキテクトからのアドバイス:実務への応用
このコードをベースに、さらに高度なシステムへと昇華させるための指針を授ける。
外部データ(Excel/DB)との連携
実務では、配置すべき図形リストはExcelやSQL Serverに格納されているはずだ。
`PlaceMasterWithPrecision` をループ内で呼び出す際、「ステンシルの開閉」をループの外で行うように設計せよ。ループのたびに `Documents.Open` を実行するのは、パフォーマンスに対する冒涜だ。
座標系の厳密な管理
`visMM`(ミリメートル)などの単位指定を引数に持たせたのは、このためだ。呼び出し側が「何を単位として渡しているか」を明示的に管理させることで、設計ミスによる位置ズレを物理的に防ぐことができる。
エラーハンドリングの思想
上記のコードでは `Err.Raise` を使い、エラーを上位へ伝播させている。これは、個別の処理(配置)の失敗を、呼び出し元(メインロジック)が「全体の中断」として扱うか、「ログに記録して次へ進む」として扱うかを判断できるようにするためだ。
まとめ
「動くコード」を書くのは誰にでもできる。しかし、「メンテナンス可能で、予測可能で、堅牢なコード」を書ける者だけが、真の自動化エンジニアとして信頼される。
今回のコードをただコピーするのではない。なぜ `NameLocal` を使うのか、なぜステンシルの存在確認が必要なのか、その「なぜ」を血肉に変えてほしい。
健闘を祈る。
