マクロ記録のその先へ:マスターシェイプの「設計図」を書き換える、ステンシル管理の極意
こんにちは。現場で数々の巨大なシステム図面を自動化してきた、あなたのエンジニアリング・メンターです。
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)」を組み込んで、図形同士を連動させる高度な自動化に挑戦してみましょう。
応援しています。また次の現場でお会いしましょう!
