SolidWorks APIの深淵：HoleWizardDefで「穴ウィザード」を完全掌握する
SolidWorks APIを扱うエンジニアの多くが、なぜか「穴ウィザード」の自動化で躓く。多くの初学者は、`FeatureManager.InsertWizardHole`の引数の羅列に翻弄され、結果として「録画されたマクロ」の劣化コピーを生成しては、仕様変更のたびに崩壊する脆弱なコードを積み上げる。
いいか、現場で求められているのは「動くコード」ではない。「仕様変更に耐えうる堅牢なアーキテクチャ」だ。
今日は、`HoleWizardFeatureData`（以下、HoleWizardDef）を直接操作し、ISO規格のネジ穴をプログラムで完全に制御する方法を授ける。
—
1. なぜ「録画マクロ」ではいけないのか
SolidWorksのレコーダーが吐き出すコードは、単なる「操作の軌跡」だ。特に穴ウィザードは、ダイアログの設定値がハードコーディングされた配列として出力されるため、規格や板厚が変わった瞬間に使い物にならなくなる。
我々が目指すべきは、「必要なパラメータのみを定義し、残りはAPIに計算させる」というトップダウン型の設計だ。
2. 実装の要：HoleWizardFeatureDataの構造
穴ウィザードを制御する核心は `IFeatureManager::CreateDefinition(swFtrWizardHole)` で生成される `IHoleWizardFeatureData` オブジェクトにある。
重要なポイントは以下の3点だ：
1. FeatureTypeの正確な指定: `swWzdHoleStandard` を軸にISOやJISを切り替える。
2. HoleDataの型定義: タップ穴なのか、ドリル穴なのかを `HoleData` プロパティでキャストして操作する。
3. 位置（Position）の抽象化: 穴の位置は「スケッチ点」で与えるのが鉄則。座標を直接叩くのではなく、あらかじめ作成したスケッチのポイントを参照させることで、モデルの変更に追従するロジックが完成する。
—
3. 実践：ISO規格M8タップ穴を生成するプロダクションコード
このコードは、アクティブなドキュメントの「前視平面」上に穴を配置するテンプレートだ。保守性を考慮し、パラメータを定数化している。
‘ 必要なオブジェクトの取得
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeatMgr As SldWorks.FeatureManager
Dim swHoleData As SldWorks.HoleWizardFeatureData
Sub CreateISOTapHole()
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
Set swFeatMgr = swModel.FeatureManager
‘ 1. 定義オブジェクトの生成
Set swHoleData = swFeatMgr.CreateDefinition(swFtrWizardHole)
‘ 2. 規格の設定 (ISOを指定)
swHoleData.Standard = swWzdHoleStandard_ISO
swHoleData.FastenerType = swWzdHoleType_TapHole ‘ タップ穴
‘ 3. パラメータの注入 (M8, P1.25)
‘ ※プロパティの文字列は「穴ウィザードのデータベース名」に依存するため注意
swHoleData.Size = “M8”
swHoleData.ThreadClass = “6H”
swHoleData.EndCondition = swEndCondThroughAll ‘ 貫通
‘ 4. フィーチャの作成（事前に選択したスケッチポイントを使用）
‘ ここでは既にスケッチ点を選択している前提
Dim swFeat As SldWorks.Feature
Set swFeat = swFeatMgr.CreateFeature(swHoleData)
If swFeat Is Nothing Then
MsgBox “穴の生成に失敗しました。パラメータを確認してください。”
End If
End Sub
—
4. 堅牢な自動化のための「3つの鉄則」
① データベース名に依存しない設計
`swHoleData.Size = “M8″` と書いているが、これはあくまで標準的な環境での例だ。現場のSolidWorks環境設定（`holewizardfavorites.mdb`等）や日本語版・英語版での名称差異を考慮し、必ず `GetStandardSize` メソッド等で列挙可能な値を取得するラッパー関数を挟むべきだ。
② スケッチ駆動による位置管理
穴位置をAPIで数値指定（X, Y座標）するのは避けるべきだ。モデルが修正された際に追従できなくなる。
- ベストプラクティス: 穴を打つための「参照スケッチ」を先に生成し、その点を選択状態にしてから `InsertWizardHole` を実行する。これにより、穴の位置はスケッチに依存し、モデルの変更に完全追従する。
③ エラーハンドリングの極意
`CreateFeature` メソッドは、失敗した際に `Nothing` を返すだけではない。SolidWorksの内部エラーをキャッチするために、`swModel.Extension.LastError` を監視し、何が原因で生成が拒絶されたのか（貫通できない、厚みが足りない等）をログに出力する仕組みを必ず組み込むこと。
—
結論：自動化は「設計」である
穴ウィザードの自動化は、単なるプログラミングではなく、SolidWorksという巨大なシステムの「作法」を理解する行為だ。オブジェクトのライフサイクルを意識し、モデルの整合性を保つ。これこそが、伝説的な自動化エンジニアが共通して持っている視座である。
次に構築する君のツールが、単なる「便利なスクリプト」ではなく、「壊れないインフラ」になることを期待している。
実装で壁にぶつかったら、いつでも戻ってこい。コードの先にある「真の構造」をまた説いてやる。
