AutoCAD VBAの深淵：AcadDocumentプロパティの「正解」とメモリ管理の哲学
AutoCADのオートメーションにおいて、`AcadDocument`オブジェクトが提供する `Name`、`FullName`、そして `Path` プロパティ。これらは単なる文字列の取り扱いではない。システムの堅牢性と拡張性を左右する、アーキテクチャの根幹だ。
新人エンジニアは「どれを使ってもファイル名は取れる」と考える。だが、我々シニアエンジニアは知っている。その選択が、将来的なファイル名の重複、ネットワークドライブの切断、さらにはメモリリークという悪夢を招く引き金になることを。
今回は、これらのプロパティを「どう使い分け、どう管理すべきか」という視点から、極限の知見を伝授しよう。
—
1. 三つのプロパティの「本質」を暴く
まず、基本的な定義を再確認する。しかし、ただの定義ではない。「システムがどう扱っているか」という観点で見てほしい。
- `Name`: 図面のファイル名（例: `Design01.dwg`）。これは表示用だ。ログのヘッダーやメッセージボックス、UI表示にのみ使う。これを使ってファイル操作を行ってはならない。
- `FullName`: ファイルシステムの絶対パス（例: `C:\Project\2024\Design01.dwg`）。これは一意の識別子だ。マルチドキュメント環境で、現在どのファイルがアクティブかを判定する唯一の基準となる。
- `Path`: フォルダのパス（例: `C:\Project\2024`）。これはリソース管理用だ。外部参照（Xref）の配置や、バックアップファイルの保存先生成に使用する。
極限の指針:
「文字列操作を最小化せよ」。`FullName`から`Path`を抽出する際、`InStrRev`で文字を切り出すのはC言語的な古い手法だ。`Scripting.FileSystemObject`を使用するか、あるいはWindows APIを叩くのが、現代のレガシー保守における「正解」である。
—
2. コードの実装：メモリ解放と堅牢性
VBAはガベージコレクションがない。オブジェクトを保持し続ければ、AutoCADのプロセスは確実に太る。以下のコードは、バックアップ生成時の標準的な実装モデルである。
‘ ————————————————————————–
‘ 極限のファイル管理：バックアップ生成ルーチン
‘ ————————————————————————–
Public Sub CreateReliableBackup()
Dim doc As AcadDocument
Dim fso As Object
Dim fullPath As String
Dim folderPath As String
Dim fileName As String
‘ 1. オブジェクトの安全な取得
Set doc = Application.ActiveDocument
‘ 2. 未保存図面のハンドリング（FullNameが空のケース）
If doc.FullName = “” Then
MsgBox “保存されていない図面はバックアップできません。”, vbCritical
GoTo Cleanup
End If
‘ 3. FSOを使用したパス操作 (APIライクな安全性を確保)
Set fso = CreateObject(“Scripting.FileSystemObject”)
fullPath = doc.FullName
folderPath = fso.GetParentFolderName(fullPath)
fileName = fso.GetBaseName(fullPath) & “_Backup_” & Format(Now, “yyyymmdd_hhnn”) & “.dwg”
‘ 4. バックアップ実行
doc.SaveAs fso.BuildPath(folderPath, fileName)
‘ 5. コンテキスト復帰（重要：元のファイル名に戻す等の処理が必要な場合）
doc.SaveAs fullPath
Debug.Print “Backup created at: ” & folderPath
Cleanup:
‘ 6. 明示的なメモリ解放（VBAにおける正義）
Set fso = Nothing
Set doc = Nothing
End Sub
—
3. シニアエンジニアが守るべき「三つの鉄則」
1. 未保存図面の「空白」を想定せよ
`AcadDocument.FullName` は、未保存の新規図面では空文字を返す。`If doc.FullName = “”` のチェックを怠るシステムは、必ず本番環境でクラッシュする。
2. ファイルシステムAPIの活用
パスの連結（`\` の有無など）を文字列演算で行うのはやめろ。`FSO.BuildPath` を使え。OSのパス区切り文字の差異や、環境依存の挙動をすべて吸収してくれる。
3. オブジェクトの明示的解放
`Set doc = Nothing` を軽視するな。AutoCADのプロセスが長時間稼働する環境（サーバーサイドでのバッチ処理など）では、この一行の積み重ねが、数日後のメモリ不足エラーを回避する唯一の鍵となる。
—
結び：アーキテクトの視点
AutoCAD VBAは、現代では「レガシー」と呼ばれることもある。しかし、図面データという膨大な資産を管理する上で、そのオブジェクトモデルは極めて洗練されている。
プロパティの使い分けは、単なるプログラミングのテクニックではない。「どの情報がどこに存在し、どう流れるか」を制御するアーキテクトの矜持そのものだ。
次にコードを書くとき、`Name` か `FullName` かで迷ったら、思い出してほしい。その一文字が、システムの安定稼働という「信頼」を左右しているということを。
諸君、コードに魂を込めよ。その先にしか、自動化の真髄はない。
