Visio VBAの深淵へ：VSDX自動生成とステンシル制御の「黄金律」
こんにちは。自動化の現場でVisioと格闘し続けてきた諸君、ようこそ。
「マクロの記録」ボタンを押して生成された、冗長で意味不明なコードを見て絶望したことはないかな？あれはVisioが吐き出す「死んだコード」だ。
我々エンジニアが書くべきは、Visioのオブジェクトモデルの呼吸を感じる「生きたコード」だ。今回は、VSDXファイルを自在に操り、テンプレートからステンシルを呼び出すという、自動化の「第一の関門」を突破する極意を伝授しよう。
—
1. Visio VBAの核：ApplicationとDocumentの関係
Visioの世界において、全ての頂点に君臨するのが `Application` オブジェクトだ。そして、君たちが操作するファイルは `Document` オブジェクトとして定義される。
ここを勘違いしてはいけない。「ファイルを操作する」のではなく「ドキュメントというメモリ上のオブジェクトを操作している」という意識を持つこと。これがプロへの第一歩だ。
—
2. 実践：テンプレートからVSDXを生成するコード
まずは、特定のテンプレートを元に新しい図面を作成し、必要なステンシルを読み込む定石コードを見てみよう。
Sub CreateNewDrawingFromTemplate()
‘ Visioのアプリケーションそのものを指す
Dim visApp As Visio.Application
Set visApp = Application
‘ ドキュメントを格納する変数を定義
Dim doc As Visio.Document
‘ テンプレートのパス（環境に合わせて書き換えること）
Dim templatePath As String
templatePath = “C:\Users\YourName\Documents\Custom Templates\MyTemplate.vstx”
‘ テンプレートから新規ドキュメントを作成
‘ Documents.Add メソッドはテンプレートパスを指定するとそれを元に生成する
Set doc = visApp.Documents.Add(templatePath)
‘ ステンシルを読み込む（例：基本図形）
‘ ステンシルは Documents.OpenEx で開くのが通例
Dim stencil As Visio.Document
Set stencil = visApp.Documents.OpenEx(“Basic Shapes.vssx”, visOpenDocked)
‘ 成功の証をイミディエイトウィンドウへ
Debug.Print “ドキュメント生成完了: ” & doc.Name
End Sub
なぜ `OpenEx` を使うのか？
単なる `Open` ではなく `OpenEx` を使う理由は、「読み取り専用で開くか」「ドッキングするか」といったオプションを制御できるからだ。自動化において、ステンシルを勝手に画面のあちこちに表示させるのは御法度。`visOpenDocked` を指定することで、UIを汚さずに静かに裏側で準備させるのがスマートなプロのやり方だ。
—
3. 初学者が必ず踏む「地雷」と回避策
地雷1：テンプレートのパス指定ミス
VBAにおいてパスの指定は鬼門だ。`C:\…` と書く際、フォルダ名にスペースが含まれていると、パスが途切れてエラーになることがある。必ず `”` で囲むのは基本だが、できれば定数化して管理しよう。
地雷2：オブジェクトの開放忘れ
`Set doc = Nothing` を書かないエンジニアが多いが、これはメモリリークの温床になる。VBAはガベージコレクションが優秀ではない。使い終わったオブジェクトは、明示的にNothingを代入してメモリを解放するのが、大規模システムを支えるエンジニアの矜持だ。
—
4. PDF出力：自動化の締めくくり
生成した図面をPDFとして保存する処理もセットで覚えておこう。
Sub ExportToPDF(targetDoc As Visio.Document)
Dim outputPath As String
outputPath = “C:\Temp\Output.pdf”
‘ FixedFormatExport は Visio 2010以降の標準的なエクスポートメソッド
targetDoc.ExportAsFixedFormat visFixedFormatPDF, outputPath
Debug.Print “PDF出力完了: ” & outputPath
End Sub
—
最後に：君たちへ伝えたいこと
Visioの自動化において最も重要なのは、「Visioに見えているもの」と「コードが認識しているオブジェクト」のズレをなくすことだ。
最初は難しく感じるかもしれない。だが、このコードを理解し、自分の手で自由にキャンバスを操れるようになれば、君たちの生産性は間違いなく10倍に跳ね上がる。
「マクロの記録」という名の呪縛から解き放たれ、自分だけの自動化エンジンを構築してほしい。何かエラーで詰まったら、いつでも戻ってくるといい。ここには、君たちが次に進むための道しるべがあるのだから。
健闘を祈る。
