【入門編】【実務中級者向け】図面保存と同時に「画層一覧」をテキスト出力:納品図面の構成情報を自動ドキュメント化する – AutoCAD VBA解析バイブル

スポンサーリンク
スポンサーリンク

「マクロの記録」を卒業せよ。図面保存時に画層情報を自動ドキュメント化する、プロフェッショナルへの第一歩

こんにちは。現場の自動化を支えるアーキテクトとして、今日は皆さんに「一歩先の自動化」の世界へ足を踏み入れてもらいたいと思います。

AutoCAD VBAを触り始めたばかりの頃、多くの人が「マクロの記録」機能に感動します。「線を引く」「円を描く」……自分の操作がそのままコードになる。それは魔法のように見えるでしょう。しかし、実務で本当に求められるのは、そんな「操作の再現」ではありません。

求められているのは、「業務フローに溶け込み、ミスを未然に防ぎ、付加価値を生むシステム」です。

今日のテーマは、図面を保存(SaveAs)するタイミングで、その図面の「画層一覧(名前・色・線種)」をテキストファイルとして自動書き出しするツールです。これは単なる便利機能ではありません。納品図面の構成情報を自動的にドキュメント化するという、品質管理(QA)のプロセスを自動化する高度なアプローチです。

さあ、準備はいいですか?「ただ動くコード」ではなく、「壊れにくく、美しいコード」の書き方を伝授します。

1. アーキテクチャの思考:なぜ「イベント」を意識するのか?

「ボタンを押したら実行する」というプログラムは簡単です。しかし、プロフェッショナルは「ユーザーが何もしなくても、適切なタイミングで動く」仕組みを考えます。

今回のゴールは「保存したとき」に動かすことです。
本来、AutoCAD VBAで「保存イベント」を完全に捕捉するには、`ApplicationEvents`を用いたクラスモジュールの実装が必要になります。これは中級者の入り口となる少し複雑な領域です。

そこで今回は、実務への導入しやすさを考慮し、「保存と書き出しをセットで行う『スマート・セーブ』関数」を構築する手法を学びましょう。これを使いこなせるようになれば、あなたは「マクロ利用者」から「ツール開発者」へと進化します。

図解:処理のフロー

[ユーザーの操作] 
      ↓
[SmartSaveWithExport マクロを実行]
      ↓
      ├─ ① 図面を保存 (Document.SaveAs)
      └─ ② 画層コレクションを走査 (Layers Collection)
              ↓
              └─ ③ テキストファイルへ情報出力 (File I/O)
      ↓
[完了:図面と管理資料が同時に生成される]

2. 実装:画層情報を書き出す極限のコード

それでは、魂を込めて書いたコードを見ていきましょう。このコードは、エラーハンドリング(異常事態への備え)と、オブジェクトのライフサイクルを意識した設計になっています。

Option Explicit

''' <summary>
''' 図面を保存し、同時に画層構成情報をテキストファイルへ出力する
''' </summary>
Sub SmartSaveAndExportLayers()
    Dim acadDoc As AcadDocument
    Set acadDoc = ThisDrawing ' 現在の図面をオブジェクトとして取得
    
    Dim savePath As String
    Dim txtPath As String
    Dim layer As AcadLayer
    Dim fileNo As Integer
    
    ' --- 1. パス情報の生成 ---
    ' 図面が一度も保存されていない場合、パスが空なのでエラーになるのを防ぐ
    If acadDoc.Path = "" Then
        MsgBox "図面を一度手動で保存してから実行してください。", vbCritical, "エラー"
        Exit Sub
    End If
    
    ' 図面と同じフォルダに、拡張子 .txt で保存するパスを作成
    ' 例: C:\Project\Drawing1.dwg -> C:\Project\Drawing1_layers.txt
    savePath = acadDoc.FullName
    txtPath = Left(savePath, InStrRev(savePath, ".")) & "layers.txt"
    
    ' --- 2. 図面の保存 ---
    On Error GoTo ErrorHandler
    acadDoc.Save ' 現在の状態を保存
    
    ' --- 3. テキストファイルへの書き出し処理 ---
    ' ファイル番号を取得(OSが空いている番号を割り当てる)
    fileNo = FreeFile
    
    ' 書き込みモードでファイルを開く
    Open txtPath For Output As #fileNo
    
    ' ヘッダーの書き込み
    Print #fileNo, "============================================"
    Print #fileNo, "画層構成管理レポート"
    Print #fileNo, "作成日時: " & Now
    Print #fileNo, "図面名: " & acadDoc.Name
    Print #fileNo, "============================================"
    Print #fileNo, "画層名 | 色(Index) | 線種"
    Print #fileNo, "--------------------------------------------"
    
    ' 画層コレクション(Layers)を一つずつ走査
    ' ここが「オブジェクトのライフサイクル」を扱う核心部です
    For Each layer In acadDoc.Layers
        ' 各画層のプロパティを取得して一行にまとめる
        ' layer.Color は色番号、layer.Linetype は線種名
        Print #fileNo, layer.Name & " | " & _
                       Format(layer.Color, "000") & " | " & _
                       layer.Linetype
    Next layer
    
    Print #fileNo, "--------------------------------------------"
    Print #fileNo, "End of Report"
    
    ' ファイルを閉じる(これを忘れると、ファイルがロックされて開けなくなります!)
    Close #fileNo
    
    MsgBox "保存と画層リストの出力が完了しました。" & vbCrLf & _
           "出力先: " & txtPath, vbInformation, "完了"
    
    Exit Sub

ErrorHandler:
    ' エラーが発生した場合の処理
    MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
           "エラー番号: " & Err.Number & vbCrLf & _
           "内容: " & Err.Description, vbCritical, "システムエラー"
    
    ' 開いているファイルがあれば閉じる
    If fileNo > 0 Then Close #fileNo
End Sub

3. 伝説のエンジニアによる「コードの深読み」解説

このコードには、初心者が陥りがちな罠を回避するための「知恵」が詰まっています。

① `On Error GoTo ErrorHandler` の重要性

実務では、ネットワークドライブの書き込み権限がなかったり、ファイルが別のソフトで開かれていたりすることが多々あります。エラーを無視して進むコードは、現場では「凶器」になります。エラーをキャッチし、ユーザーに優しく伝える。これがプロの作法です。

② `FreeFile` と `Close` の徹底

`Open “file.txt” For Output As #1` と直接番号を指定するのは、素人のやり方です。`FreeFile` 関数を使うことで、システムが現在使用していない安全な番号を取得できます。また、`Close` を忘れると、そのファイルは「使用中」としてロックされ、AutoCADを再起動するまで誰も触れなくなる……という悲劇を招きます。

③ `For Each` によるコレクションの走査

AutoCADの図面は、膨大な「オブジェクトの集合体」です。`Layers` コレクションを `For Each` で回すことで、画層がいくつあろうとも、漏れなく、かつ効率的に情報を抜き出すことができます。これは、メモリ負荷を最小限に抑えつつ、確実なデータ取得を実現する最も美しい方法です。

4. ここをクリアすれば、AutoCAD VBAの基本はバッチリですよ

このツールを完成させたあなたは、すでに「自動化の設計図」を描けるようになっています。次に目指すべきステップは以下の通りです。

1. カスタマイズ: テキストではなく、Excelファイルに直接書き出すように改造してみる(`Excel.Application` オブジェクトの操作)。
2. 条件分岐: 「特定の画層(例:’TEXT’画層)だけを抽出する」といったフィルタリング機能を追加する。
3. UIの構築: ボタン一つで実行できるよう、リボンメニューやツールバーにこのマクロを登録する。

最後に

プログラミングは、単なる「作業の置き換え」ではありません。「人間の注意力を、より創造的な仕事へと解放するための手段」です。

今回学んだ「情報を抽出し、ドキュメント化する」という考え方は、あらゆるCAD業務に応用できます。一歩ずつ、着実に。あなたのコードが、誰かの仕事を劇的に変える日を楽しみにしています。

Happy Coding!

タイトルとURLをコピーしました