【Visio VBA】AutoSizeの呪縛を解く：キャンバスの動的制御とメモリ管理の極意
Visio 2013以降、我々自動化エンジニアにとって「Page.AutoSize」は諸刃の剣となった。図面を動的に生成する際、意図せずページが拡張され、レイアウトが崩壊した経験はないだろうか。特に、大規模なネットワーク図や自動配置アルゴリズムを実装している最中に、AutoSize機能が余計な「お節介」を焼くことで、描画座標の計算が狂うケースは後を絶たない。
今日は、Visioのキャンバスを完全に支配下に置き、メモリ消費を最小限に抑えつつ、堅牢な描画ロジックを構築するための知見を共有する。
—
1. AutoSize制御の真実
Visioの `Page.AutoSize` プロパティは、GUI上の「自動サイズ調整」ボタンと連動している。これをVBAで制御する場合、単に `True/False` を切り替えるだけでは不十分な場合が多い。
特に、ドキュメントの初期化時や、大量のシェイプをプログラムで流し込む際は、「AutoSizeを無効化し、ページサイズを固定した上で、最後に必要に応じて調整する」のがプロフェッショナルの定石だ。
2. 極限の制御コード：AutoSizeの完全無効化と管理
以下のコードは、ページを生成・操作する際、AutoSizeによる予期せぬキャンバス拡張を封じ込めるためのテンプレートだ。
Option Explicit
‘ @brief ページサイズを厳格に制御し、AutoSizeを無効化する
‘ @param targetPage 対象のVisio Pageオブジェクト
Public Sub SetPageCanvasFixed(ByRef targetPage As Visio.Page)
‘ オブジェクトの有効性チェック（防御的プログラミング）
If targetPage Is Nothing Then Exit Sub
‘ AutoSizeをOFFにする（描画中の勝手な拡張を防ぐ）
If targetPage.AutoSize Then
targetPage.AutoSize = False
End If
‘ ページサイズを明示的に固定（必要に応じて調整）
‘ ※PrintPropertiesを使用することで、用紙サイズとページサイズを一致させる
Dim pProps As Visio.PrintProperties
Set pProps = targetPage.PageSheet.PrintProperties
‘ メモリリークを避けるため、使用後は明示的に解放する
Set pProps = Nothing
End Sub
3. なぜ「明示的な解放」が重要なのか
VBAのガーベジコレクションを過信してはならない。Visioのオブジェクトモデルは、特に `PageSheet` や `PrintProperties` のような深層オブジェクトにアクセスする際、内部でCOMポインタを大量に消費する。
大規模なバッチ処理で `Set` を繰り返すと、VBAのメモリ管理スタックが溢れ、Visioが突然クラッシュする「理由なき終了」を招く。「`Set` したオブジェクトは、スコープを抜ける前に必ず `Nothing` を代入する」。この泥臭い習慣が、数万シェイプを扱うシステムの安定性を担保する。
4. 高度な手法：Windows APIによる描画更新の抑制
さらに上を目指すなら、画面更新を抑止し、描画パフォーマンスを極限まで引き上げる必要がある。Visioの描画エンジンは非常に高コストだ。
‘ 画面更新の一時停止（Win32 APIではなくVisio内部プロパティを活用）
‘ 処理速度を数倍に引き上げるための必須テクニック
Public Sub OptimizePerformance(ByVal isEnabled As Boolean)
If isEnabled Then
‘ 画面更新とイベント発生を抑制
Application.ScreenUpdating = False
Application.DeferRecalc = True
Else
‘ 復元
Application.ScreenUpdating = True
Application.DeferRecalc = False
End If
End Sub
5. アーキテクトからの提言
AutoSize機能は「手動で描画するユーザー」にとっては福音だが、「自動生成を行うシステム」にとってはノイズでしかない。
- 自動配置の際は常に `AutoSize = False` であること。
- 座標計算には、常にページ原点からの絶対座標を用いること。
- 処理終了後に `Application.ActiveWindow.DeselectAll` を呼び出し、再描画のオーバーヘッドを意図的に制御すること。
これらを守るだけで、あなたのVisio自動化スクリプトは、単なるマクロから「堅牢なエンジン」へと昇華する。レガシーなアーキテクチャを保守する際も、この「制御対象を明確に分離する」という思想は変わらない。
Visioという、一見不安定でブラックボックスなキャンバスを、君のコードで完全に掌握せよ。それがエンジニアとしての矜持である。
