【極限の知見】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ファイルが軽くなる快感を味わってみてください。
応援していますよ。次回のテーマでお会いしましょう!
