【極限の知見】Visioマスターを支配する:ステンシル内のシェイプを名前順に整列・再構築する技法
こんにちは。現場の自動化を極めるアーキテクトへようこそ。
「マクロの記録」ボタンを押して、記録されたコードを眺めては「……で、これどうやって応用するの?」と立ち止まってしまったことはありませんか? もしそうなら、あなたは今、プログラミングの「写経」から「設計」へと脱皮する、最もエキサイティングな境界線に立っています。
今日のテーマは、Visioのユーザー体験(UX)を劇的に向上させるテクニックです。
「ステンシル(Stencil)内のマスターシェイプを名前順に並び替えて、新しいステンシルとして保存する」。
一見すると単純な作業に見えるかもしれません。しかし、Visioのオブジェクトモデルの深淵に触れると、実は「既存のマスターの順番を入れ替える」という直接的な命令は存在しないことがわかります。
では、プロのエンジニアはどう解決するのか? その「思考のプロセス」と「実装の極意」を伝授しましょう。
1. なぜ「並び替え」が必要なのか?(設計思想の話)
業務で使われるカスタムステンシルは、プロジェクトが進むにつれて、新しいマスターが次々と追加されていきます。その結果、マスターの並びは「追加した順」になり、混沌としてしまいます。
図面を描くエンジニアにとって、「目的のシェイプがどこにあるか一目でわかること」は、作業効率に直結する極めて重要なUI要素です。
「並び替えマクロ」を作る目的は、単なる整理整頓ではありません。「次に使う人が迷わないための、道具のメンテナンス」なのです。この視点を持つことが、一流の自動化エンジニアへの第一歩です。
2. Visioオブジェクトモデルの「壁」を知る
ここで、一つ重要な技術的知見を共有しておきます。
Visioの`Masters`コレクションには、`Sort`メソッドのような「中身を並び替える命令」は用意されていません。マスターの並び順は、ステンシルファイル(.vssx)内のXML構造に依存しているからです。
そのため、我々が取るべき戦略は「破壊的再構築」です。
1. 既存のステンシルから、マスターの情報(名前と実体)をすべて抜き出す。
2. 抜き出した情報を、名前順にソート(並び替え)する。
3. 新しい(空の)ステンシルを作成し、ソート済みの順番でマスターをコピーしていく。
4. 新しいステンシルとして保存する。
この「一度バラして、正しい順序で組み立て直す」という考え方は、複雑なシステム設計でも頻出する非常に強力なパターンです。
3. 実装:マスター整列エンジン
それでは、実際のコードを見ていきましょう。初学者の方向けに、あえて「分かりやすさ」と「堅牢さ」を両立させた書き方をしています。
Option Explicit
''' <summary>
''' ステンシル内のマスターを名前順に並び替えて、新しいステンシルとして保存する
''' </summary>
Sub SortMastersAndSaveNewStencil()
Dim sourceStencil As Visio.Document
Dim newStencil As Visio.Document
Dim mst As Visio.Master
Dim masterNames() As String
Dim masterObjects() As Visio.Master
Dim i As Long, j As Long
Dim tempName As String
Dim tempObj As Visio.Master
Dim savePath As String
' 1. 現在開いているステンシルを取得
' ※ ステンシルは Visio では「Document」オブジェクトとして扱われます
On Error Resume Next
Set sourceStencil = ActiveWindow.Application.ActiveDocument
On Error GoTo 0
If sourceStencil Is Nothing Then
MsgBox "ステンシルが開かれていません。対象のステンシルをアクティブにして実行してください。", vbCritical
Exit Sub
End If
' ステンシル(.vssx)であることを確認(簡易チェック)
If InStr(1, sourceStencil.FullName, ".vss", vbTextCompare) = 0 Then
MsgBox "選択されたドキュメントはステンシルではありません。", vbExclamation
Exit Sub
End If
' 2. マスター情報を配列に格納
' Mastersコレクションをループして、名前とオブジェクトをメモリに保持します
ReDim masterNames(sourceStencil.Masters.Count - 1)
ReDim masterObjects(sourceStencil.Masters.Count - 1)
For i = 1 To sourceStencil.Masters.Count
Set mst = sourceStencil.Masters(i)
' NameU (Unformatted Name) を使うのがプロの鉄則。
' Nameプロパティは表示名が変わるとズレる可能性がありますが、NameUは一意の識別子です。
masterNames(i - 1) = mst.NameU
Set masterObjects(i - 1) = mst
Next i
' 3. バブルソートによる並び替え(アルゴリズムの基本)
' マスターの数が膨大でない限り、このアルゴリズムで十分高速に動作します
For i = LBound(masterNames) To UBound(masterNames) - 1
For j = i + 1 To UBound(masterNames)
' 文字列の比較。大文字小文字を区別せずに比較します
If StrComp(masterNames(i), masterNames(j), vbTextCompare) > 0 Then
' 名前を入れ替え
tempName = masterNames(i)
masterNames(i) = masterNames(j)
masterNames(j) = tempName
' 対応するオブジェクトもセットで入れ替える(ここが重要!)
Set tempObj = masterObjects(i)
Set masterObjects(i) = masterObjects(j)
Set masterObjects(j) = tempObj
End If
Next j
Next i
' 4. 新しいステンシルを作成し、ソート済みの順でマスターをコピー
' visDocumentStencil 定数を指定して、空のステンシルを生成します
Set newStencil = ActiveWindow.Application.Documents.Add("")
' ※ 実際にはテンプレートから作るのが理想ですが、ここでは簡易的に新規作成
' ステンシル形式として定義するために、一度保存する必要があります
' 保存先のパスを生成(元のファイル名_Sorted.vssx)
savePath = Left(sourceStencil.FullName, InStrRev(sourceStencil.FullName, ".") - 1) & "_Sorted.vssx"
' 5. 新しいステンシルにマスターを複製していく
' マスターの「Duplicate」メソッドを使い、新しいステンシルへ転送します
For i = LBound(masterObjects) To UBound(masterObjects)
' masterObjects(i) は元のステンシルのマスター
' これを newStencil に複製します
masterObjects(i).Duplicate newStencil
Next i
' 6. 保存と終了
On Error Resume Next
newStencil.SaveAs savePath
If Err.Number <> 0 Then
MsgBox "保存に失敗しました。ファイルが書き込み禁止になっていないか確認してください。" & vbCrLf & _
"Error: " & Err.Description, vbCritical
Else
MsgBox "完了しました!" & vbCrLf & "保存先: " & savePath, vbInformation
End If
On Error GoTo 0
' newStencil.Close ' 必要に応じてクローズ
End Sub
4. ここがポイント!エンジニアの知恵袋
このコードを読み解く上で、絶対に忘れてはいけない「極限の知見」が3つあります。
① `Name` ではなく `NameU` を使え
Visioには、ユーザーが見るための「Name」と、システムが管理するための「NameU (Unformatted Name)」があります。
ユーザーがマスターの名前を「ポンプ (Pump)」のように日本語に変えても、`NameU` は内部的なIDを保持し続けます。「ユーザーの変更に左右されない堅牢なコード」を書くなら、必ず `NameU` を使いましょう。
② 配列の同期(オブジェクトのライフサイクル)
ソートアルゴリズムの中で、`masterNames`(名前の配列)だけを並び替えても意味がありません。それに対応する `masterObjects`(実体への参照)も、全く同じルールで入れ替える必要があります。これを忘れると、「名前は『A』なのに、中身は『C』のシェイプ」という、デバッグ地獄の入り口へ足を踏み入れることになります。
③ エラーハンドリングの重要性
`SaveAs` は、ファイルが既に開かれていたり、書き込み権限がなかったりすると、無慈悲に実行時エラーを吐いてマクロを停止させます。`On Error Resume Next` を適切に使い、ユーザーに「何が起きたか」を優しく伝えるのが、プロの作法です。
まとめ:次のステップへ
お疲れ様でした。これであなたは、単に「マクロを動かす人」から、「Visioの構造を理解し、ツールを最適化できるエンジニア」へと一歩近づきました。
今回学んだ「情報の抽出 $\rightarrow$ ソート $\rightarrow$ 再構築」というパターンは、Visioに限らず、あらゆるデータ処理に応用できる普遍的な考え方です。
「もっとこうしたい」「このエラーが消えない」といった疑問があれば、いつでも聞いてください。コードの向こう側にある「設計の美しさ」を、一緒に追求していきましょう。
さあ、次はどんな自動化に挑戦しますか?
