【入門編】【中級】マスターシェイプの「ユーザー定義セル」をVBAで一括追加・削除するメンテナンスツール – Visio VBA解析バイブル

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

マクロ記録のその先へ:マスターシェイプの「設計図」を書き換える、ステンシル管理の極意

こんにちは。現場で数々の巨大なシステム図面を自動化してきた、あなたのエンジニアリング・メンターです。

Visio VBAを学び始めると、多くの人が最初に通る道があります。それは「マクロの記録」です。図形を動かし、色を変える。その操作をコードとして書き出す。それは素晴らしい第一歩です。

しかし、もしあなたが「図面全体の管理を自動化したい」「すべての図形に一括で『作成者』や『管理番号』という属性を持たせたい」と考えたとき、マクロの記録だけでは限界にぶつかります。なぜなら、マクロの記録は「今、画面上にある図形」に対して命令を下すものだからです。

今日、私たちが挑むのは、もっと高次元な領域。図面の「部品」そのもの、つまりステンシル(Stencil)内のマスターシェイプ(Master Shape)の定義を書き換えるという作業です。

ここをマスターすれば、あなたは「図形を操作する人」から「図面システムの設計者」へと進化できます。さあ、一緒に極限の知見へ足を踏み入れましょう。

1. 概念の理解:マスターシェイプは「設計図」である

プログラミングにおいて、オブジェクトの「型(Class)」と「実体(Instance)」を区別することは極めて重要です。Visioにおいても全く同じです。

  • マスターシェイプ(Master): ステンシルの中に格納されている「設計図」です。
  • シェイプ(Shape): 図面に配置された「実体」です。

もし、図面に配置された100個の図形すべてに「プロジェクトID」という属性を追加したいとき、1つずつ図形に属性を付けるのは非効率の極みです。それどころか、後から新しい図形を配置したら、その図形には属性がありません。

「マスター(設計図)に属性を追加する」

これこそが、メンテナンス性を極限まで高めるエンジニアの思考法です。マスターに属性を書き込んでおけば、そのマスターから生成されるすべての図形が、自動的にその属性を引き継ぐのです。

2. アーキテクチャ:セルにアクセスするための階層構造

マスターシェイプの「ユーザー定義セル」を操作するには、Visioのオブジェクト階層を正しく登る必要があります。ここを間違えると、コードは迷宮入りします。

Stencil (ステンシル)
  └── Master (マスターシェイプ)
        └── Shape (マスターを構成するシェイプ)
              └── Cell (セル)
                    ├── Row (行:ユーザー定義セルなど)
                    └── Column (列:値や数式)

ここで注意すべきプロの視点は、「マスター自体には直接セルを追加するのではなく、マスターが持つ『最初のシェイプ』に対して操作を行う」という点です。マスターは実質的に、一つのシェイプの定義(テンプレート)として存在しているからです。

3. 実装:マスターメンテナンスツールの全貌

それでは、実用的なコードを見ていきましょう。このツールは、指定したステンシル内の全マスターに対して、「一括追加」と「一括削除」を行う機能を備えています。

Option Explicit

''' <summary>
''' ステンシル内の全マスターに対して、ユーザー定義セルを一括管理するツール
''' </summary>
Sub MasterMaintenanceTool()
    Dim stl As Visio.Stencil
    Dim mst As Visio.Master
    Dim shp As Visio.Shape
    Dim targetRowName As String
    Dim action As String
    
    ' --- 設定エリア ---
    ' 操作したいステンシルの名前を指定(開いているもの)
    ' 例: "Basic Shapes.vssx"
    Const TARGET_STENCHIL_NAME As String = "YourStencilName.vssx" 
    ' 追加・削除したいセルの名前
    targetRowName = "ManagementID"
    ' ------------------

    ' 1. ステンシルの取得
    On Error Resume Next
    Set stl = Application.Documents(TARGET_STENCHIL_NAME).Stencil
    On Error GoTo 0

    If stl Is Nothing Then
        MsgBox "指定されたステンシルが見つかりません。開いているか確認してください。", vbCritical
        Exit Sub
    End If

    ' 2. ユーザーへのアクション選択
    action = InputBox("操作を選択してください" & vbCrLf & _
                      "ADD  : セルを追加" & vbCrLf & _
                      "DEL  : セルを削除", "マスターメンテナンス")

    ' 描画更新を停止してパフォーマンスを向上させる(プロの鉄則)
    Application.ScreenUpdating = False

    ' 3. マスターのループ処理
    For Each mst In stl.Masters
        ' マスターの定義シェイプを取得(通常は最初の1つ)
        Set shp = mst.Shapes(1)
        
        Select Case UCase(action)
            Case "ADD"
                Call AddUserDefinedCell(shp, targetRowName)
            Case "DEL"
                Call DeleteUserDefinedCell(shp, targetRowName)
            Case Else
                MsgBox "無効な操作です。中断します。"
                GoTo CleanUp
        End Select
    Next mst

    MsgBox "メンテナンスが完了しました。", vbInformation

CleanUp:
    Application.ScreenUpdating = True
End Sub

''' <summary>
''' 指定したシェイプにユーザー定義セルを追加する
''' </summary>
Private Sub AddUserDefinedCell(ByRef shp As Visio.Shape, ByVal rowName As String)
    Dim rowIdx As Visio.CellRow
    
    ' すでに同じ名前のセルが存在しないかチェック(二重追加エラー防止)
    On Error Resume Next
    Set rowIdx = shp.CellRows.ItemU(rowName)
    On Error GoTo 0
    
    If rowIdx Is Nothing Then
        ' 行を追加:Visio.visUserDefinedCell を指定することで「ユーザー定義セル」になる
        shp.AddRow Visio.visUserDefinedCell, rowName, Visio.visAlways
        Debug.Print "Added: " & rowName
    Else
        Debug.Print "Skipped (Already exists): " & rowName
    End If
End Sub

''' <summary>
''' 指定したシェイプからユーザー定義セルを削除する
''' </summary>
Private Sub DeleteUserDefinedCell(ByRef shp As Visio.Shape, ByVal rowName As String)
    Dim rowIdx As Visio.CellRow
    
    ' 削除対象の行が存在するか確認
    On Error Resume Next
    Set rowIdx = shp.CellRows.ItemU(rowName)
    On Error GoTo 0
    
    If Not rowIdx Is Nothing Then
        rowIdx.Delete
        Debug.Print "Deleted: " & rowName
    Else
        Debug.Print "Skipped (Not found): " & rowName
    End If
End Sub

4. 陥りやすい罠:プロが教える「落とし穴」の回避術

このコードを動かすにあたって、あなたが直面するかもしれない壁がいくつかあります。事前に知っておけば、慌てることはありません。

① 「二重追加エラー」の恐怖

`AddRow` メソッドは、もし既に同じ名前の行が存在する場合、実行時エラーを吐いて停止してしまいます。
解決策: コード内で `shp.CellRows.ItemU(rowName)` を使って、事前に存在チェックを行っています。これが「マクロの記録」にはない、ロジックによる制御です。

② パフォーマンスの重み

マスターが数百個あるステンシルに対して、一つずつセルを追加・削除すると、Visioは毎回画面の再描画を試みます。これが動作を極端に重くします。
解決策: `Application.ScreenUpdating = False` を使い、処理が終わるまで画面更新を凍結させましょう。これだけで処理速度は劇的に変わります。

③ マスターは「保護」されていることがある

一部の標準ステンシル(Visioのデフォルトのもの)は、編集が制限されている場合があります。
解決策: 独自のステンシル(.vssxファイル)を作成して運用することを強くお勧めします。自作のステンシルであれば、完全にコントロール下に置くことができます。

5. まとめ:設計者への道

今回のツールは、単に「セルを増やす・減らす」だけのものです。しかし、その背後にある考え方は極めて重要です。

1. 共通化: 個別の図形ではなく、マスター(設計図)を操作する。
2. 堅牢性: 存在チェックを行い、エラーで止まらないコードを書く。
3. 効率化: 描画制御によって、大量のデータ処理を高速化する。

これらを意識できるようになったとき、あなたのVisio VBAは「単なる自動化ツール」から「強力な図面管理基盤」へと昇華します。

ここをクリアすれば、Visio VBAの基本はバッチリですよ。次は、これらのセルに「数式(Formula)」を組み込んで、図形同士を連動させる高度な自動化に挑戦してみましょう。

応援しています。また次の現場でお会いしましょう!

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