【中級】マスターシェイプの「アイコン画像」を外部のPNGファイルから一括更新する
「マクロの記録」で簡単な操作は覚えた。でも、実務で求められるのは『大量のデータを、いかに正確に、かつ高速に制御するか』。そう感じているあなたへ。
こんにちは。今日は、Visio VBAの真髄の一つである「ステンシル(Stencil)とマスター(Master)の動的制御」についてお話ししましょう。
今回のテーマは、「製品画像(PNG)が更新されるたびに、Visioのステンシル内にあるマスターシェイプのプレビューアイコンを、手作業ではなくプログラムで一括差し替える」というものです。
「ファイル名が製品番号と同じなら、フォルダ内の画像をスキャンして、対応するマスターの見た目を書き換える」……そんな自動化が実現できれば、図面管理の工数は劇的に削減されます。
ここをクリアすれば、あなたは「単なるマクロ使い」から「Visioを操るエンジニア」へとステップアップできるはずですよ。
1. 構造を理解する:マスターは「型」である
コードを書く前に、必ずオブジェクトの階層構造を脳内に描いてください。ここを間違えると、どれだけ優れたコードも「どこを操作しているのかわからない」迷宮に陥ります。
Visioの構造は、以下のようになっています。
Application (Visio本体)
└── Document (ステンシルファイル `.vssx`)
└── Stencil (ステンシルの管理領域)
└── Master (シェイプの「設計図」)
└── Shape (実際の図形)
私たちが今回操作するのは、「Master」の中身(Shape)です。
マスターシェイプの見た目を変更するということは、そのマスターが保持している「Shapeコレクション」を新しい画像(Picture Shape)で上書きすることを意味します。
2. 極限のコード:マスター画像一括更新スクリプト
それでは、実戦で使えるコードを見ていきましょう。
このコードは、指定したフォルダ内にあるPNGファイルを読み込み、ファイル名と一致するマスターシェイプを探して、その中身を画像に差し替えます。
Option Explicit
''' <summary>
''' フォルダ内のPNG画像を、ステンシル内のマスターシェイプのアイコンとして一括更新する
''' </summary>
''' <param name="stencilPath">更新対象のステンシルファイル (.vssx) のフルパス</param>
''' <param name="imageFolderPath">画像が格納されているフォルダのパス</param>
Public Sub BatchUpdateMasterIcons(ByVal stencilPath As String, ByVal imageFolderPath As String)
Dim vsoStencil As Visio.Document
Dim vsoMaster As Visio.Master
Dim vsoShape As Visio.Shape
Dim fso As Object
Dim folder As Object
Dim file As Object
Dim targetFileName As String
Dim targetImgPath As String
Dim foundMatch As Boolean
' 1. 高速化のための設定:画面更新を停止
Application.ScreenUpdating = False
On Error GoTo ErrorHandler
' 2. ファイルシステムオブジェクトの作成 (フォルダ走査用)
Set fso = CreateObject("Scripting.FileSystemObject")
If Not fso.FolderExists(imageFolderPath) Then
MsgBox "画像フォルダが見つかりません: " & imageFolderPath, vbCritical
Exit Sub
End If
Set folder = fso.GetFolder(imageFolderPath)
' 3. ステンシルを開く (編集可能モード)
' ※既存のステンシルを書き換えるため、通常のOpenではなくOpenExを使用する場合もあります
Set vsoStencil = Visio.Documents.Open(stencilPath)
' 4. フォルダ内のファイルをループ処理
For Each file In folder.Files
' PNGファイルのみを対象とする
If LCase(fso.GetExtensionName(file.Name)) = "png" Then
' 拡張子を除いたファイル名を「マスター名」として扱う
targetFileName = fso.GetBaseName(file.Name)
targetImgPath = file.Path
foundMatch = False
' 5. ステンシル内のマスターを検索
For Each vsoMaster In vsoStencil.Masters
If vsoMaster.Name = targetFileName Then
foundMatch = True
' --- ここからが核心:マスターの入れ替え処理 ---
' マスター内の既存のシェイプをすべて削除(中身を空にする)
' Master.Shapes.Range.Delete は強力ですが、マスターの構造に注意が必要
vsoMaster.Shapes.Range.Delete
' 画像をマスターとして挿入
' AddPicture(ファイル名, リンクするか, ドキュメントに保存するか, 左, 上, 幅, 高さ)
' ここでは、マスターのサイズに合わせて適宜調整してください
Set vsoShape = vsoMaster.Shapes.AddPicture(targetImgPath, False, True, 0, 0, 100, 100)
' 挿入した画像のサイズをマスターの枠に合わせる調整(例:1in x 1in)
vsoShape.Cells("Width").FormulaU = "1 in"
vsoShape.Cells("Height").FormulaU = "1 in"
Debug.Print "Updated: " & targetFileName
End If
Next vsoMaster
If Not foundMatch Then
Debug.Print "Skip (No Master Found): " & targetFileName
End If
End If
Next file
' 6. 保存して終了
vsoStencil.Save
MsgBox "更新が完了しました!", vbInformation
CleanUp:
Application.ScreenUpdating = True
Set fso = Nothing
Exit Sub
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' テスト実行用プロシージャ
''' </summary>
Public Sub TestRun()
' ここは自分の環境に合わせて書き換えてください
Dim sPath As String: sPath = "C:\Work\MyCustomStencil.vssx"
Dim iPath As String: iPath = "C:\Work\ProductImages\"
Call BatchUpdateMasterIcons(sPath, iPath)
End Sub
3. プロフェッショナルの視点:コードの解剖学
このコードがなぜ「動く」のか。そして、なぜ「こう書くのか」。その設計思想を解説します。
① `Master.Shapes.Range.Delete` の重み
マスターシェイプは、いわば「入れ物」です。既存のマスターに図形(線やテキスト)が入っている場合、それを消去せずに画像を重ねると、中身がぐちゃぐちゃになります。
`vsoMaster.Shapes.Range.Delete` を使うことで、一度マスターを「まっさらな状態」にリセットしています。これが、クリーンな更新を実現する鍵です。
② `AddPicture` メソッドの選択
画像を扱う際、`InsertFromFile` などのメソッドもありますが、VBAからマスターに対して直接操作する場合、`Shape.AddPicture` が最も制御しやすい。
特に、第3引数の `SaveWithDocument = True` は極めて重要です。これを `False` にすると、画像は「外部参照」になり、他の人にVisioファイルを送った瞬間に、アイコンが「×」印になって消えてしまいます。「画像はドキュメントに埋め込む」。これは自動化エンジニアの鉄則です。
③ 検索アルゴリズムの単純化
今回は `If vsoMaster.Name = targetFileName` という単純な比較を行っています。これは、「ファイル名とマスター名を一致させておく」という運用ルールを前提としています。
大規模なシステムでは、Excelなどの管理台帳を介して「ファイル名 ⇔ マスター名」のマッピングを行うように拡張しますが、まずはこの「名前の一致」という基本を押さえておきましょう。
4. 陥りやすい「3つの罠」
ここをクリアすれば、あなたのコードはプロ級です。
1. ステンシルが「読み取り専用」問題
標準のステンシル(Visio内蔵のもの)は読み取り専用です。これらを書き換えようとするとエラーになります。必ず、自分で作成したカスタムステンシル(.vssx)に対して実行してください。
2. スケーリング(サイズ)の罠
`AddPicture` で挿入した直後の画像は、元のPNGの解像度(ピクセル)に依存したサイズになることがあります。コード内で `vsoShape.Cells(“Width”).FormulaU = “1 in”` のように、明示的にサイズを指定(FormulaUを使用)しないと、マスターが巨大化したり、逆に豆粒のように小さくなったりします。
3. オブジェクトの解放漏れ
`FileSystemObject` などの外部ライブラリを使用する場合、`Set fso = Nothing` で明示的に解放する癖をつけましょう。特にループ内で大量のファイルを開閉する場合、メモリリークを防ぐために不可欠な作法です。
まとめ:一歩先の自動化へ
いかがでしたか?
単に「画像を貼り付ける」という作業を、「マスターという設計図の構成要素を、外部リソースに基づいて動的に再構築する」という視点で捉え直すことができたでしょうか。
「マクロの記録」は、あくまで「操作の録画」です。
しかし、今回のような「オブジェクトの階層を理解し、条件に基づいた制御を行うコード」こそが、真の業務自動化を支える武器になります。
一歩ずつ、確実に。
コードの向こう側にある「効率化された未来」を目指して、書き続けていきましょう。応援していますよ!
