【入門編】【中級】Visioドキュメント内の「使用されていないマスターシェイプ」を特定して削除する – Visio VBA解析バイブル

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

【極限の知見】Visioの肥大化を断つ:未使用マスターシェイプの完全抹消ロジック

「マクロの記録」でコードを書き始めたあなた。素晴らしい一歩を踏み出しました。しかし、ツールを使いこなす「エンジニア」へと脱皮するためには、記録されたコードの裏側にある「オブジェクトの生存戦略」を理解する必要があります。

今日、私たちが挑むのは、Visioドキュメントの「ダイエット」です。
大規模な図面を扱っていると、ファイルサイズが異常に重くなることがありますよね? 実は、図面の上に置いてある図形(Shape)のせいではなく、「ステンシルの中に眠っている、一度も使われていないマスターシェイプ(Master Shape)」が、メモリとストレージを食いつぶしている原因であることが多いのです。

この記事では、使われていないマスターを特定し、エレガントに削除するプロフェッショナルな手法を伝授します。ここをマスターすれば、あなたは「ただ動くコード」を書く段階から、「システムの最適化ができるエンジニア」へと進化できるはずですよ。

1. 構造を理解する:マスターとシェイプの「親子関係」

コードを書く前に、Visioのオブジェクトモデルの階層を整理しましょう。ここを誤解すると、プログラムは必ずエラーを吐きます。

  • Stencil(ステンシル): 図形の「カタログ」です。
  • Master(マスター): カタログに載っている「設計図」です。
  • Shape(シェイプ): 設計図を元に、実際にページ上に配置された「実体」です。

ここが重要です:
あなたがページに図形を置いたとき、Visioは「マスター」をコピーして「シェイプ」を作ります。しかし、カタログ(ステンシル)の中に「一度も使われていない設計図(マスター)」が大量に残っていても、Visioはそれを削除しません。これがファイルサイズ肥大化の正体です。

私たちのミッションは、「全ページをスキャンして、使用中のマスター名をリストアップし、リストにないマスターをステンシルから削除する」ことです。

2. 戦略的アルゴリズム:計算量を最小限に抑える

初学者が陥りがちな失敗は、以下のような「二重ループの地獄」です。

> ❌ 非効率なアプローチ:
> 「マスターを1つ取り出す」→「全ページを回って、そのマスターが使われているか確認する」→「使われていなければ消す」

これでは、マスターの数 × ページの数 × ページ内の図形数 という膨大な計算量になり、図面が大きくなると処理が終わりません。

プロのエンジニアは、「ハッシュマップ(Dictionaryオブジェクト)」を使います。

> ✅ プロのアプローチ:
> 1. 一回目のスキャン: 全ページを一度だけ走査し、「今使われているマスターの名前」を `Dictionary` に格納する。
> 2. 二回目のスキャン: ステンシル内のマスターを順に確認し、`Dictionary` に名前がなければ削除する。

この方法なら、計算量は劇的に抑えられます。

3. 実装:未使用マスター削除マクロ

それでは、実際に動作するコードを見てみましょう。このコードは、ドキュメント専用のステンシル(Document Stencil)を対象にクリーンアップを行います。

Option Explicit

''' <summary>
''' ドキュメント内で使用されていないマスターシェイプを特定し、削除する
''' </summary>
Sub PurgeUnusedMasters()
    Dim vsoPage As Visio.Page
    Dim vsoShape As Visio.Shape
    Dim vsoDocument As Visio.Document
    Dim vsoStencil As Visio.DocumentStencil
    Dim vsoMaster As Visio.Master
    Dim usedMasters As Object ' Scripting.Dictionaryを使用
    Dim masterName As String
    Dim deleteCount As Integer
    
    ' 高速化のため、画面更新を停止(プロのテクニック)
    Application.ScreenUpdating = False
    
    Set vsoDocument = ActiveDocument
    Set usedMasters = CreateObject("Scripting.Dictionary")
    deleteCount = 0
    
    On Error GoTo ErrorHandler

    ' --- STEP 1: 使用中のマスターを収集 ---
    ' 全ページを走査し、配置されているシェイプの「マスター名」を辞書に登録
    For Each vsoPage In vsoDocument.Pages
        For Each vsoShape In vsoPage.Shapes
            ' シェイプが持つマスターの名前を取得
            masterName = vsoShape.Master.Name
            
            ' Dictionaryに登録(重複は自動的に無視される)
            If Not usedMasters.Exists(masterName) Then
                usedMasters.Add masterName, True
            End If
        Next vsoShape
    Next vsoPage

    ' --- STEP 2: 未使用マスターの削除 ---
    ' ドキュメント専用のステンシル(Document Stencil)を対象にする
    ' ※標準のステンシルを消すとユーザーが困るので、ドキュメント内のみを対象にするのが安全
    For Each vsoStencil In vsoDocument.DocumentStencils
        For Each vsoMaster In vsoStencil.Masters
            
            ' マスター名が辞書に存在しない場合、それは「未使用」
            If Not usedMasters.Exists(vsoMaster.Name) Then
                ' 削除実行
                vsoMaster.Delete
                deleteCount = deleteCount + 1
            End If
            
        Next vsoMaster
    Next vsoStencil

    ' 後処理
    Application.ScreenUpdating = True
    MsgBox "クリーンアップ完了!" & vbCrLf & _
           "削除されたマスター数: " & deleteCount & " 個", vbInformation, "完了"
    
    Set usedMasters = Nothing
    Exit Sub

ErrorHandler:
    Application.ScreenUpdating = True
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "エラー"
    Set usedMasters = Nothing
End Sub

4. エンジニアとしての深掘り:陥りやすい落とし穴

このコードを動かす際、あるいは応用する際に、絶対に知っておくべき「知見」が3つあります。

① `DocumentStencil` と `ApplicationStencil` の違い

Visioには、アプリ全体で共有されるステンシル(Application Stencil)と、そのファイル専用のステンシル(Document Stencil)があります。
もし、コードの中で `vsoDocument.DocumentStencils` ではなく、アプリ全体のステンシルを対象にしてしまうと、「他のファイルでも使っている大事な図形」まで消去してしまうという大事故に繋がります。常に「対象範囲」を意識してください。

② `Dictionary` オブジェクトの威力

コード内で `CreateObject(“Scripting.Dictionary”)` を使いましたね。これは、データの検索を「一瞬」で行うための魔法の道具です。
`usedMasters.Exists(name)` というメソッドは、数万個のデータがあっても、一撃でその名前があるかどうかを判定できます。これが、プロの書く「高速なコード」の正体です。

③ オブジェクトのライフサイクルとエラーハンドリング

マスターを削除するとき、もしそのマスターが何らかの理由で「保護(Protected)」されていた場合、`vsoMaster.Delete` はエラーを吐いて止まってしまいます。
実務用のコードでは、`On Error Resume Next` を使って個別の削除エラーをスキップするか、事前に `vsoMaster.Protection` プロパティを確認する処理を入れるのが、一流の仕事です。

まとめ:ここをクリアすれば、次の一歩が見えてくる

今回のロジックを整理しましょう。

1. 「何が使われているか」を先にすべて把握する(Dictionaryの活用)
2. 「使われていないもの」だけを後から狙い撃ちする
3. 影響範囲(DocumentStencil)を限定して、安全性を確保する

この「まず全体像を把握してから、差分を操作する」という考え方は、Visio VBAに限らず、あらゆるプログラミング、ひいてはシステム設計において極めて重要な概念です。

「マクロの記録」から一歩踏み出し、このような「構造的な思考」ができるようになれば、あなたの自動化スキルは飛躍的に向上します。
さあ、このコードを自分の環境で試して、重かったVisioファイルが軽くなる快感を味わってみてください。

応援していますよ。次回のテーマでお会いしましょう!

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