【極限の知見】SolidWorks図面自動化の洗礼:不要なシートを「安全に」一掃し、クリーンな環境を構築せよ
業務自動化の現場へようこそ。君たちが直面するのは、綺麗な設計データではない。社外から流れてきた、あるいは過去の遺物である「ゴミの混じったテンプレート」だ。
SolidWorksの図面(Drawing)自動化において、最初の、そして最も初歩的かつ致命的な罠がこれだ。「テンプレートを開いた瞬間、意図しないマルチシート状態に陥り、後続のビュー配置ロジックが崩壊する」。
多くの初心者は、力技でシートを削除しようとしてエラーを吐くか、あるいは「全てのシートを消そうとして、最後の1枚が消せずにプログラムが死ぬ」という無様な結末を迎える。
今日は、単なる「シート削除スクリプト」ではない。オブジェクトのライフサイクルを制御し、エラーを未然に防ぎ、プロダクション環境に投入できるレベルの「堅牢なシートクリーンアップ・エンジン」の設計思想を伝授する。
1. なぜ「単純なループ」では失敗するのか?
設計思想以前に、APIの挙動を理解せよ。SolidWorksのAPIにおいて、シートの操作は「コレクションの走査」と「アクティブなオブジェクトの状態」に強く依存する。
陥りがちな3つの設計ミス
1. インデックスの逆転現象:
`For i = 1 To SheetCount` のように前から順に削除しようとすると、1枚目を消した瞬間に、元々2枚目だったものが1枚目に繰り上がる。これにより、ループのインデックスがズレ、削除漏れが発生する。
2. ActiveSheetの呪縛:
SolidWorksには「現在アクティブなシートを削除することはできない」という絶対的な制約がある。もし、プログラムが現在表示しているシートを消そうとした瞬間、実行時エラーでプロセスは停止する。
3. 更新負荷の無視:
シートを1枚消すごとに、SolidWorksは図面全体の再計算(Rebuild)を試みることがある。大量のシートがある場合、この挙動がパフォーマンスを著しく低下させる。
2. プロダクション・グレードの設計戦略
プロのエンジニアなら、以下の3層構造でロジックを組む。
1. 判定層 (Identification): どのシートが「残すべき正解」で、どれが「排除すべきノイズ」かを定義する。
2. 制御層 (Control): アクティブシートを回避しつつ、インデックスのズレを防ぐために「後ろから(降順で)」削除を実行する。
3. 保護層 (Protection): エラーハンドリングを完備し、万が一の際もSolidWorksのプロセスを死なせない。
3. 実装例:RobustSheetCleaner
以下に、実務でそのまま使えるレベルのVBAコードを示す。単に消すだけではなく、「特定の名前のシート以外は全て排除する」という、実務で最も汎用性の高いロジックを組み込んでいる。
Option Explicit
''' <summary>
''' 図面内の不要なシートを安全に一括削除し、指定したシートのみを残す
''' </summary>
''' <param name="swApp">SolidWorks Application Instance</param>
''' <param name="targetSheetName">残すべきメインシートの名前 (例: "Sheet1")</param>
''' <returns>成功した場合はTrue</returns>
Public Function CleanUpDrawingSheets(ByRef swApp As SldWorks.SldWorks, ByVal targetSheetName As String) As Boolean
On Error GoTo ErrorHandler
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim vSheetNames As Variant
Dim i As Long
Dim sheetCount As Long
Dim currentSheet As SldWorks.Sheet
Dim activeSheet As SldWorks.Sheet
Set swModel = swApp.ActiveDoc
' 1. ドキュメントの型チェック(図面以外では動かさない)
If swModel Is Nothing Then Exit Function
If swModel.GetType <> swDocDRAWING Then
Debug.Print "Error: アクティブなドキュメントが図面ではありません。"
CleanUpDrawingSheets = False
Exit Function
End If
Set swDraw = swModel
' 2. シート情報の取得
' GetSheetNamesは全シート名を配列で返す。これを利用して走査する。
vSheetNames = swDraw.GetSheetNames
sheetCount = UBound(vSheetNames) + 1 ' 0-based to 1-based
' 3. 現在のアクティブシートを退避(削除対象から外すため)
Set activeSheet = swDraw.GetCurrentSheet
Debug.Print "Starting cleanup. Total sheets found: " & sheetCount
' 4. 【重要】インデックスの逆順ループ
' 後ろから削除することで、削除に伴うインデックスの繰り上がり問題を防ぐ
For i = sheetCount To 1 Step -1
Dim sheetName As String
sheetName = vSheetNames(i - 1)
' 判定ロジック: 「残すべきシート名」ではない、かつ「アクティブシートではない」場合
If sheetName <> targetSheetName And sheetName <> activeSheet.GetName Then
' シートをアクティブにする(削除の準備)
' ※APIの仕様上、削除対象を直接指定するのではなく、
' 対象をアクティブにしてからDeleteSheetを呼ぶ必要があるケースが多い
swDraw.ActivateSheet sheetName
' 削除実行
' Note: DeleteSheetは引数なしで「現在のシート」を削除する
swDraw.DeleteSheet
Debug.Print "Deleted sheet: " & sheetName
Else
Debug.Print "Skipped sheet: " & sheetName & " (Protected)"
End If
Next i
' 5. 最終的な整合性チェック
' 最後に必ず目的のシートをアクティブにして終了する
swDraw.ActivateSheet targetSheetName
CleanUpDrawingSheets = True
Exit Function
ErrorHandler:
Debug.Print "Critical Error in CleanUpDrawingSheets: " & Err.Description
' プログラムをクラッシュさせず、エラー状態を呼び出し元に返す
CleanUpDrawingSheets = False
End Function
''' <summary>
''' メインエントリーポイント(テスト用)
''' </summary>
Sub Main()
Dim swApp As SldWorks.SldWorks
Set swApp = Application.SldWorks
Dim success As Boolean
' 「Sheet1」という名前のシートだけを残して、他は全て削除する
success = CleanUpDrawingSheets(swApp, "Sheet1")
If success Then
MsgBox "図面のクリーンアップが完了しました。", vbInformation
Else
MsgBox "クリーンアップ中にエラーが発生しました。ログを確認してください。", vbCritical
End If
End Sub
4. 伝説のアーキテクトによる「ここが差がつく」解説
コードをコピペして動かすだけでは、君はまだ「作業員」だ。以下の設計意図を血肉化せよ。
なぜ `Step -1` なのか?
これはコレクション操作の鉄則だ。例えば、3枚のシートがある状態で `1 -> 2 -> 3` と消そうとすると、1枚目を消した瞬間に、元々2枚目だったものが「新1枚目」になる。次に君が「2枚目を消せ」と命令したとき、それは元々3枚目だったものを指してしまう。「後ろから叩く」。これだけで、インデックスの混乱というバグの8割は防げる。
エラーハンドリングの思想
`On Error GoTo ErrorHandler` を書かないのは、設計放棄と同じだ。特にSolidWorks APIは、外部ファイルやメモリの状態によって予期せぬエラーを吐く。エラーが発生した際に、`swApp` の制御を失わないように、適切にエラーをキャッチし、呼び出し元に「失敗したこと」を伝える責務が、関数にはある。
拡張性への配慮
今回のコードでは `targetSheetName` を引数に取っている。これは、現場によって「Sheet1」であったり「A図」であったり、ルールが異なるからだ。「ロジック(削除の仕組み)」と「パラメータ(何を残すか)」を分離する。 これが保守性の高いコードを作る鍵だ。
5. まとめ:次の一歩へ
図面自動化の真の価値は、人間が「テンプレートの掃除」という低付加価値な作業から解放され、設計の本質に集中できる環境を作ることにある。
今回学んだ「逆順ループ」「アクティブシートの保護」「型チェックによるガード」は、図面に限らず、あらゆるSolidWorks API操作における共通言語だ。これらをマスターし、単なるスクリプトライターではなく、堅牢なシステムを構築できるエンジニアへと昇華してほしい。
健闘を祈る。
