【実務・中級編】【初心者向け】図面テンプレート内の不要なデフォルトシートを自動検出して安全に一挙削除するVBA – SolidWorks VBA解析バイブル

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

【極限の知見】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操作における共通言語だ。これらをマスターし、単なるスクリプトライターではなく、堅牢なシステムを構築できるエンジニアへと昇華してほしい。

健闘を祈る。

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