【入門編】【中級】ステンシル内のマスターシェイプを「名前順」に並び替えてステンシルファイルを再保存する – Visio VBA解析バイブル

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

【極限の知見】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に限らず、あらゆるデータ処理に応用できる普遍的な考え方です。

「もっとこうしたい」「このエラーが消えない」といった疑問があれば、いつでも聞いてください。コードの向こう側にある「設計の美しさ」を、一緒に追求していきましょう。

さあ、次はどんな自動化に挑戦しますか?

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