【実務・中級編】【初心者】ステンシル内のマスターシェイプを「名前の完全一致」で抽出し、座標指定で自動配置する基本スクリプト – Visio VBA解析バイブル

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

【実務直結】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` を使うのか、なぜステンシルの存在確認が必要なのか、その「なぜ」を血肉に変えてほしい。

健闘を祈る。

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