【入門編】【中級】ステンシル内のマスターシェイプを「名前のプレフィックス」でフィルタリングして読み込む高速化手法 – Visio VBA解析バイブル

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

Visio VBAを掌握する極限の知見:大量のマスターシェイプから「必要なものだけ」を高速に呼び出す技術

こんにちは。現場の設計から自動化アーキテクチャの構築まで、長年Visioの深淵を覗いてきたチーフアーキテクトです。

「マクロの記録」を使って、形を描いたり色を変えたりする。そこまでは素晴らしい第一歩です。しかし、あなたがプロフェッショナルな自動化ツールを作ろうとしたとき、必ず一つの壁にぶつかります。

それは、「ステンシルが重すぎて、プログラムが動かない(あるいは極端に遅い)」という問題です。

数千、数万のマスターシェイプ(部品のテンプレート)を持つ巨大なステンシルを扱うとき、漫然と「すべてのマスターをループで回して、名前をチェックする」という書き方をしてはいけません。それは、巨大な倉庫のすべての箱を開けて中身を確認するようなもので、非効率の極みです。

今日は、エンジニアとして一段上のステージへ進むために、「名前のプレフィックス(接頭辞)によるフィルタリング」を用いて、メモリと処理時間を劇的に節約する実装手法を伝授しましょう。ここをクリアすれば、Visio VBAの基本はバッチリですよ。

1. なぜ「全部読み込む」と失敗するのか?(オブジェクトの重みを知る)

まず、設計思想(アーキテクチャ)の話をしましょう。

Visioにおける「ステンシル」は単なるファイルではなく、`Document`オブジェクトとしてメモリ上に展開されます。そしてその中の「マスターシェイプ」は、ページに配置される前の「設計図」です。

初心者が陥りがちなのは、以下のようなコードです。

' ❌ 避けるべき、非効率なアプローチのイメージ
For Each m In stencil.Masters
    ' すべてのマスターに対して、何か重い処理や描画を試みてしまう
    If m.Name = "MyPrefix_*" Then 
        ' ... 処理 ...
    End If
Next m

なぜこれがダメなのか。それは、「オブジェクトへのアクセス回数」と「プロパティの評価」にはコストがかかるからです。特に、マスターの名前を判定する際、ローカライズされた名前(表示名)ではなく、システム内部のユニークな名前(`NameU`)を正しく扱うことが、パフォーマンスと安定性の鍵となります。

2. 実践:プレフィックスによる高速フィルタリング・アルゴリズム

では、賢いエンジニアはどう書くか。
「特定の文字(プレフィックス)で始まるマスターだけを特定し、それだけをページにドラッグ&ドロップする」という、無駄のないロジックを実装しましょう。

以下のコードは、そのまま実戦投入できるレベルの堅牢性を備えています。

''' <summary>
''' 指定したプレフィックスを持つマスターシェイプのみを、指定したページに高速にロードする
''' </summary>
''' <param name="stencilName">開いているステンシルの名前</param>
''' <param name="prefix">抽出したい名前の接頭辞 (例: "IT_")</param>
''' <param name="targetPage">配置先のページオブジェクト</param>
Sub LoadMastersByPrefix(stencilName As String, prefix As String, targetPage As Visio.Page)
    Dim stencil As Visio.Document
    Dim master As Visio.Master
    Dim targetShape As Visio.Shape
    Dim foundCount As Integer
    
    foundCount = 0
    
    ' 1. ステンシルの存在確認
    On Error Resume Next
    Set stencil = Application.Documents(stencilName)
    On Error GoTo 0
    
    If stencil Is Nothing Then
        MsgBox "エラー: ステンシル '" & stencilName & "' が見つかりません。", vbCritical
        Exit Sub
    End If

    ' 2. パフォーマンス最適化:画面更新を停止
    ' これをしないと、シェイプを置くたびにVisioが再描画を行い、猛烈に遅くなります。
    Application.ScreenUpdating = False
    
    ' 3. マスターの走査(ここが心臓部)
    ' NameU (Unformatted Name) を使用することで、言語環境に左右されない高速な判定を実現します。
    For Each master In stencil.Masters
        ' Like演算子を用いて、プレフィックスの一致を判定
        ' UCaseを使うことで、大文字・小文字の揺れを吸収して堅牢性を高めます
        If UCase(master.NameU) Like UCase(prefix) & "*" Then
            
            ' 4. 必要なマスターだけをページに配置(ドラッグ&ドロップのシミュレーション)
            ' Dropメソッドは、マスターを新しいシェイプとしてページに生成します
            Set targetShape = targetPage.Drop(master, 0, 0)
            
            ' 配置したシェイプに少し位置をずらす(重ならないように)
            targetShape.CellsU("PinX").FormulaU = "(foundCount * 1.5) + 1"
            targetShape.CellsU("PinY").FormulaU = "5"
            
            foundCount = foundCount + 1
        End If
    Next master

    ' 5. 後処理:画面更新を再開
    Application.ScreenUpdating = True
    
    If foundCount > 0 Then
        MsgBox foundCount & " 個のマスターをロードしました。", vbInformation
    Else
        MsgBox "該当するプレフィックスを持つマスターは見つかりませんでした。", vbExclamation
    End If
    
End Sub

''' <summary>
''' テスト実行用のメインルーチン
''' </summary>
Sub TestMasterLoading()
    ' 使用例: "MyStencil.vssx" というステンシルのうち、"Part_" で始まるものだけを
    ' アクティブなページにロードする
    Dim activePage As Visio.Page
    Set activePage = Application.ActivePage
    
    ' ここを実際のステンシル名とプレフィックスに変えて実行してください
    Call LoadMastersByPrefix("MyCustomStencil.vssx", "Part_", activePage)
End Sub

3. プロの視点:なぜこのコードは「速い」のか?

このコードには、単なる「動くコード」を超えた、3つの設計思想が組み込まれています。

① `NameU` プロパティの徹底活用

Visioには `Name`(表示名)と `NameU`(システム内部名)があります。
`Name` はユーザーが言語設定を変えると変わってしまう可能性がありますが、`NameU` は不変です。プロのエンジニアは、比較演算には必ず `NameU` を使い、予期せぬエラーを未然に防ぎます。

② `Application.ScreenUpdating = False` の魔法

これはVisio VBAにおける「鉄則」です。
大量のオブジェクトを操作するとき、Visioはデフォルトで「今、何が起きたか」を画面に描画しようとします。これを停止させるだけで、処理速度は10倍、時には100倍変わります。

③ `Like` 演算子による高速マッチング

`Left(master.NameU, Len(prefix)) = prefix` という書き方もありますが、VBAの `Like` 演算子はパターンマッチングに特化しており、直感的かつ高速です。今回のケースでは、この「文字列のパターン照合」が最も効率的なフィルタリング手法となります。

4. 陥りやすいエラーと回避策(トラブルシューティング)

実装中に遭遇しやすい「壁」をあらかじめ教えておきます。

  • 「ステンシルが開いていない」エラー

`Application.Documents(stencilName)` は、そのステンシルがメモリ上にロードされていないとエラーを吐きます。必ず `On Error Resume Next` を使って存在チェックを行うか、事前に `Documents.Open` で開く処理を挟んでください。

  • 「大文字・小文字」の罠

ユーザーが `part_` と入力しても、マスターが `Part_` だった場合、単純な比較では不一致になります。`UCase()` 関数を使って、「比較する両方を大文字に揃える」のが、プロの作法です。

  • 「メモリの解放」

大量のオブジェクトをループで扱う場合、変数のスコープ(有効範囲)を意識してください。今回は `Dim` で宣言した変数がプロシージャ終了時に解放されるため安全ですが、非常に巨大なデータを扱う場合は、オブジェクトを `Set obj = Nothing` で明示的に解放する癖をつけておくと、将来的にメモリ不足で悩まされることがなくなります。

まとめ:次は「設計」のフェーズへ

お疲れ様でした。これであなたは、単に「マクロを記録する人」から、「リソースを管理し、効率的なアルゴリズムを実装できるエンジニア」へと進化しました。

「動けばいい」コードと、「大量のデータに対しても高速に、正確に動く」コード。この差が、現場におけるあなたの信頼を決定づけます。

次に挑戦するのは、ロードしたマスターシェイプのプロパティを、さらに一括で書き換える高度な自動化です。この調子で、一歩ずつマスターへの道を歩んでいきましょう。応援していますよ!

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