SolidWorks APIの深淵：アセンブリ・ロールバックとコンポーネント管理の最適解
SolidWorks APIを扱う際、多くの開発者が陥る罠がある。それは「オブジェクトをただ触るだけで満足してしまうこと」だ。特にアセンブリのフィーチャーツリーをプログラムから操作する場合、単純なメソッド呼び出しの積み重ねは、メモリリークとパフォーマンス低下、そして不可解なクラッシュへの最短ルートとなる。
本稿では、アセンブリ内のコンポーネントを一時的に「ロールバック（抑制）」または「非表示」にするという日常的なタスクを通じ、プロフェッショナルが守るべきメモリ管理と実行効率の極意を伝授する。
—
1. コンポーネント操作の「鉄則」：オブジェクトのライフサイクルを制御せよ
SolidWorks APIにおいて最も重要なのは、`ISldWorks`、`IModelDoc2`、`IAssemblyDoc` といったインターフェースの「寿命」をいかに管理するかだ。特にアセンブリのコンポーネント操作では、再帰的なツリー走査が発生しやすいため、参照変数を安易に保持し続けることは厳禁である。
なぜ「明示的解放」が必要か
VBA（COM）環境下では、参照カウントが適切にデクリメントされない場合、プロセスが終了してもメモリ上にSolidWorksのゾンビオブジェクトが残留する。これを防ぐには、処理の終了時にオブジェクトを `Nothing` に戻すだけでなく、操作の最小単位でスコープを限定する設計が求められる。
—
2. 実装：コンポーネントを安全に抑制（Suppress）する
アセンブリ内の特定のコンポーネントをプログラムから制御するには、`IComponent2::Select2` を経由してコンテキストを確定させ、`IAssemblyDoc::SuppressComponent` を実行するのが定石だ。
しかし、ここで重要なのは「選択状態のクリア」と「再描画制御」である。
‘ コンポーネントを抑制し、メモリと描画負荷を制御する
Public Sub SuppressComponentSafe(compName As String)
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swComp As SldWorks.Component2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swAssy = swModel
‘ コンポーネントの取得
Set swComp = swAssy.GetComponentByName(compName)
If swComp Is Nothing Then Exit Sub
‘ 描画の凍結（パフォーマンス最適化の極致）
swModel.FeatureManager.EnableFeatureTree = False
‘ 抑制実行（戻り値の確認を怠らないこと）
Dim status As Long
status = swAssy.SuppressComponent(swComp.Name2)
‘ 選択状態の解除（これがメモリリークを防ぐ）
swModel.ClearSelection2 True
‘ 描画の復帰
swModel.FeatureManager.EnableFeatureTree = True
‘ オブジェクトの明示的解放
Set swComp = Nothing
Set swAssy = Nothing
Set swModel = Nothing
Set swApp = Nothing
End Sub
—
3. シニアエンジニアが意識する「隠れたコスト」
上記のコードで注目すべきは `swModel.FeatureManager.EnableFeatureTree = False` である。
大量のコンポーネントを順次処理する場合、毎回ツリーを再描画させてはならない。Windows APIの `LockWindowUpdate` 相当の制御をSolidWorks側で行うことで、処理速度は数倍から十数倍に跳ね上がる。
システム間連携と保守性の知見
- 名前の依存性: `GetComponentByName` はツリー構造が深くなると予期せぬ挙動を示すことがある。可能であれば、`IComponent2::GetID` を活用した特定を推奨する。
- エラーハンドリング: アセンブリ内のコンポーネントが「読み取り専用」または「外部参照」である場合、APIは無言で失敗する。必ず `swComp.IsSuppressed` 等で状態を確認するガード句を入れること。
—
4. 結論：コードは「対話」ではなく「規律」である
初心者向けのスクリプトは、単に動けば良いかもしれない。しかし、我々が目指すのは「10,000部品を超える大規模アセンブリでも止まらないシステム」だ。
1. オブジェクトの寿命は最短に保つ（変数のスコープを絞る）。
2. 描画更新は処理の最後にまとめて行う（`EnableFeatureTree` の活用）。
3. 状態変更の前後には必ずクリア処理を入れる（`ClearSelection2`）。
これらを徹底するだけで、あなたの書くVBAは「場当たり的なマクロ」から「堅牢な自動化エンジンのコア」へと昇華する。
SolidWorks APIは奥が深い。次回の講義では、非同期処理を模したキュー管理と、大規模アセンブリにおけるコンポーネント検索の最適化アルゴリズムについて深掘りする予定だ。コードの裏側にある「なぜ」を理解し続けるエンジニアであれ。
