【テクニカル・上級編】【中級】マスターシェイプの「ShapeSheet」をVBAで一括置換して図形属性を統一する – Visio VBA解析バイブル

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

ShapeSheetの深淵を統べる:ステンシル内マスターシェイプの一括属性定義とメモリ管理の極致

企業規模のアーキテクチャ設計や大規模なネットワーク構成図において、図形の「一貫性」は単なる見た目の問題ではない。それは、自動化されたドキュメント生成パイプラインの信頼性を担保するための、極めて重要な「データ規約」である。

あるエンジニアが作成したステンシル(Stencil)に、色指定や線幅のルールが混在している。この「不純物」が混じったステンシルを使い続けることは、後続の自動生成プロセスにおけるバグの温床となり、システム全体の整合性を損なう。

本稿では、Visio VBAを用いてステンシル内の全マスターシェイプ(Master Shape)に対し、ShapeSheetのセル値を一括置換し、属性を強制的に統一する技術を解説する。単なるループ処理ではない。COMオブジェクトのライフサイクル、プロテクション(保護)の回避、そして大規模処理におけるメモリリークを防ぐためのアーキテクトの視点を提供しよう。

1. オブジェクト階層の再定義:ShapeとMasterの決定的な違い

多くの初級者は、ドキュメント上の「Shape」を操作することと、ステンシル内の「Master」を操作することを混同する。ここが最大の分岐点だ。

  • Shape: ドキュメント上に配置された実体。その属性を変更しても、ステンシル(マスター)には影響しない。
  • Master: ステンシル内に格納された「設計図」。マスターのShapeSheetを書き換えることで、そのマスターから生成される将来のすべてのシェイプに属性が継承される。

我々がターゲットとするのは後者、すなわちステンシル・ファイルそのものの構造定義である。

2. 堅牢な一括置換エンジンの実装

ステンシル内のマスターを走査し、特定のセル(例:`FillForegnd` や `LineWeight`)を書き換えるコードを実装する。ここで重要なのは、「全てのマスターが同じセルを持っているとは限らない」という前提に立つことだ。存在しないセルへのアクセスは、ランタイムエラーを引き起こし、プロセスを停止させる。

以下に、プロフェッショナル仕様のコードを示す。

Option Explicit

''' <summary>
''' ステンシル内の全マスターシェイプの特定セルを一括更新する
''' </summary>
''' <param name="stencilPath">対象となるステンシルファイルのフルパス</param>
''' <param name="cellName">書き換えるShapeSheetのセル名 (例: "FillForegnd")</param>
''' <param name="newValue">設定する値 (例: "RGB(0,112,192)")</param>
Public Sub UnifyMasterAttributes(ByVal stencilPath As String, ByVal cellName As String, ByVal newValue As String)
    Dim visioApp As Visio.Application
    Dim stencilDoc As Visio.Document
    Dim stencil As Visio.Stencil
    Dim master As Visio.Master
    Dim targetCell As Visio.Cell
    
    ' エラーハンドリングの初期化
    On Error GoTo ErrorHandler
    
    Set visioApp = Visio.Application
    
    ' 1. ステンシルドキュメントのオープン
    ' 既存のドキュメントとして開くのではなく、編集のために明示的に開く
    Set stencilDoc = visioApp.Documents.OpenEx(stencilPath, visioFlagsOpenDocked)
    Set stencil = stencilDoc.Stencil
    
    ' 画面更新を停止(パフォーマンス最適化の定石)
    ' Visioでは直接的なScreenUpdatingプロパティはないが、
    ' 大規模処理時は描画負荷を抑えるための設計が必要
    
    Debug.Print "--- Processing Stencil: " & stencilDoc.Name & " ---"

    ' 2. マスターの反復処理
    For Each master In stencil.Masters
        Debug.Print "Checking Master: " & master.Name
        
        ' 3. セルの存在確認と保護解除の試行
        ' ShapeSheetのセルは保護されている場合があるため、一時的に解除する
        On Error Resume Next
        Set targetCell = master.Cell(visioCellName, cellName)
        
        If Err.Number = 0 Then
            ' セルが存在する場合
            ' プロテクション(Protection)セルを確認し、書き込み権限を確保する
            ' 0x00000001 は visProtectsCell を指す
            If targetCell.Protects(visProtectsCell) Then
                targetCell.Unprotect visProtectsCell
            End If
            
            ' 値の書き込み
            targetCell.Formula = newValue
            
            ' 書き込み後に再度保護が必要な場合はここで設定する(設計思想による)
            ' targetCell.Protect visProtectsCell
        Else
            ' セルが存在しない場合はスキップ
            Debug.Print "  [Skip] Cell '" & cellName & "' not found in " & master.Name
            Err.Clear
        End If
        On Error GoTo ErrorHandler ' エラーハンドリングを復帰
    Next master

    ' 4. 保存とクリーンアップ
    stencilDoc.Save
    Debug.Print "--- Success: Attributes Unified ---"

CleanUp:
    ' オブジェクトの明示的な解放(メモリリーク防止の極意)
    ' COMオブジェクトは参照カウントがゼロになるまでメモリに居座り続ける
    Set targetCell = Nothing
    Set master = Nothing
    Set stencil = Nothing
    If Not stencilDoc Is Nothing Then
        stencilDoc.Close
        Set stencilDoc = Nothing
    End If
    Exit Sub

ErrorHandler:
    MsgBox "Critical Error in " & master.Name & vbCrLf & _
           "Error No: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "Architecture Engine Error"
    Resume CleanUp
End Sub

3. アーキテクトの視点:パフォーマンスとメモリの管理

COMオブジェクトのライフサイクル

VBAはCOM(Component Object Model)上で動作している。`For Each` ループ内で大量の `Master` オブジェクトを生成し、それを適切に破棄せずにループを回すと、Visioのメモリ使用量は指数関数的に増大し、最終的に「Out of Memory」またはプロセス自体のクラッシュを招く。
`Set master = Nothing` を明示的に行うことは、単なる作法ではなく、ミッションクリティカルなシステムにおいては生存戦略である。

保護セル(Protection Cell)への介入

ShapeSheetには、ユーザーによる誤操作を防ぐための `Protection` セルが存在する。マスターシェイプの属性をプログラムから変更しようとする際、この保護が有効だと `Access Denied` エラーで停止する。
コード内で `targetCell.Unprotect` を呼び出すロジックは、自動化における「強制的整合性」を確保するために不可欠な処理だ。

Windows APIとレガシー環境への配慮

もし、この処理をより高速化したい、あるいはVisioがバックグラウンドでハングアップするのを防ぎたいのであれば、Windows APIの `Sleep` 関数を使用して、ループの合間にOSに制御を戻す(Yieldする)検討も必要になる。

' 標準モジュールの先頭で宣言

If VBA7 Then

Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)

Else

Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

End If

大規模なステンシル(数百のマスターを含むもの)を処理する場合、各マスターの処理後に `DoEvents` または `Sleep 1` を挟むことで、OSのメッセージキューを処理させ、アプリケーションの応答性を維持することができる。

4. 結論

マスターシェイプの属性統一は、図面品質の標準化における「基盤」である。
エンジニアが真に目指すべきは、単に「動くコード」を書くことではない。「例外が発生し得ること」を前提とし、「リソースを制御下に置き」、「大規模なデータに対しても予測可能な挙動を示す」ことである。

このコードをテンプレートとして、君たちのシステムに、揺るぎない整合性をもたらしてほしい。

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