AutoCAD VBAの「沈黙」を許すな：Utility.Promptによる洗練されたUXの構築
AutoCADのオートメーション開発において、未熟なエンジニアほどすぐに `MsgBox` を叩きつける。
画面中央に無機質なダイアログを出し、ユーザーの操作を強制的に停止させる。あれはUIではない。ユーザーの思考を分断し、ワークフローを破壊する「ノイズ」だ。
真の自動化とは、AutoCADの標準コマンドと見紛うほどのシームレスな操作感を提供することにある。本稿では、`AcadDocument.Utility.Prompt` を軸とした、プロフェッショナルなガイダンス表示術を伝授する。
—
1. なぜ MsgBox は「悪」なのか
エンジニアリングの観点から言えば、`MsgBox` の使用は「非同期的な非同期処理」への冒涜だ。
AutoCADはコマンドラインと密接に連携するステートマシンである。`MsgBox` を呼ぶと、AutoCADのメインスレッドはモーダルダイアログの応答待ちで完全にフリーズする。これはメモリの解放やバックグラウンド処理の柔軟なハンドリングを阻害する。
我々が目指すべきは、コマンドライン（`ThisDrawing.Utility.Prompt`）への適切なフィードバックである。これはユーザーの視線を動かさず、AutoCADの作法に則った「自然な案内」となる。
—
2. 現場で生きる実装：Utility.Promptの活用術
単に文字列を流すだけでは足りない。ユーザーが「今、何ができるか」を明確にする必要がある。以下に、堅牢かつ洗練されたプロンプト制御のテンプレートを示す。
‘ ———————————————————
‘ 処理状況をコマンドラインに美しく表示するプロシージャ
‘ @param msg 表示するメッセージ
‘ @param newline 改行を挿入するかどうか
‘ ———————————————————
Public Sub WritePrompt(ByVal msg As String, Optional ByVal newline As Boolean = True)
On Error Resume Next ‘ 万が一の描画エラーを握りつぶす
Dim prefix As String
prefix = IIf(newline, vbCrLf, “”)
‘ Utility.Promptはアクティブなドキュメントのコマンドラインに出力する
‘ ユーザーの思考を止めない「非同期的な案内」として機能させる
ThisDrawing.Utility.Prompt prefix & “[System Info] ” & msg
‘ メモリの解放：VBAにおいて明示的な解放は重要
‘ 参照型を扱う場合はSet = Nothingを徹底する
End Sub
なぜこれが強力なのか
- 非モーダル性: ユーザーは処理中も他のコマンドを実行したり、OS側の挙動を確認したりできる。
- 履歴の蓄積: コマンドライン履歴（F2キー）に残るため、ログとして事後検証が可能である。
- 低オーバーヘッド: Windows APIを直接叩く必要がなく、AutoCADの内部オブジェクトモデルに直接アクセスするため、極めて軽量である。
—
3. レガシー環境におけるメモリ最適化の極意
AutoCAD VBAは古いが、そのオブジェクトモデルは極めて巨大だ。特に `AcadDocument` や `AcadApplication` を不用意にグローバル変数として保持し続けると、メモリリークの温床となる。
特に大規模図面（数GB規模）を扱う際、オブジェクトのライフサイクル管理は死活問題だ。
‘ メモリリークを防ぐためのオブジェクト参照の作法
Public Sub ProcessEntities()
Dim doc As AcadDocument
Set doc = ThisDrawing ‘ 参照の取得
‘ — 処理ロジック —
‘ Utility.Promptによるリアルタイム進捗通知
doc.Utility.Prompt vbCrLf & “処理中: データベースを走査しています…”
‘ 処理終了後、速やかに明示的解放を行う
‘ これを忘れると、AutoCADを閉じてもプロセスが残る「ゾンビプロセス」の原因となる
Set doc = Nothing
End Sub
—
4. 上級編：Windows APIとの融合による「脱VBA」の視座
もし、あなたが「コマンドラインだけでは情報量が足りない」と感じているなら、それはVBAの限界を悟り始めた証拠だ。その際は、`User32.dll` を利用して、ステータスバーに直接文字列を送り込む手法が有効だ。
しかし、まずは `Utility.Prompt` を極めよ。
多くのシニアエンジニアが、足元の「AutoCAD標準の機能」を軽視し、複雑な外部ライブラリに頼ろうとする。だが、最も堅牢で、最も保守コストが低いのは、プラットフォーム自身が提供するAPIである。
結論：ユーザーを「待たせない」設計を
AutoCAD VBAにおいて、コードの美しさは「ユーザーにどれだけ負担をかけないか」で決まる。
`MsgBox` の誘惑を断ち切り、`Utility.Prompt` を通じてユーザーと対話せよ。それが、君が書くプログラムを「単なるスクリプト」から「現場で愛されるツール」へと昇華させる唯一の道だ。
次の設計では、ぜひ「コマンドラインでの対話」を意識してほしい。君の書いたコードが、誰かの作業時間を数秒短縮する。その積み重ねこそが、エンジニアの誇りである。
