「接線表示の制御」を極める:単なるスクリプトから、業務を支える「ツール」への昇華
エンジニア諸君、現場の泥臭い作業を自動化しようとするその姿勢は素晴らしい。しかし、一つ忠告しておこう。「動けばいい」というレベルのコードを書くのは、自動化エンジニアではなく、単なるスクリプト・キディだ。
図面作成において、接線(Tangent Edges)の表示制御は、図面の視認性を決定づける極めて重要な要素だ。これを手動で、一つ一つのビューに対して切り替えているようでは、設計の本質的な価値に時間を割けない。
本記事では、図面内の全ビューに対して接線表示モード(表示・非表示・破線)を一括で切り替えるマクロを題材に、「バグを生まないオブジェクト走査」と「プロダクション品質の設計思想」を伝授する。
1. 陥りがちな「初歩的な設計ミス」を回避せよ
多くの初心者が SolidWorks VBA で図面操作を行う際、以下のような設計ミスを犯す。
罠1:ルートビュー(Sheet View)の誤認
`DrawingDoc.GetFirstView` を呼び出したとき、返ってくるのは「最初のモデルビュー」ではない。それは「シートそのもの(Root View)」だ。このルートビューに対してモデル固有の属性(接線表示など)を操作しようとすると、エラーが発生するか、予期せぬ動作を引き起こす。
罠2:エラーハンドリングの欠如
図面内には、モデルビュー以外にも「注釈(Annotation)」や「シートフォーマット」の要素が混在している。これらを「モデルビュー」と決め打ちして処理を進めると、実行時エラーでマクロが即座にクラッシュする。プロのコードは、「期待しないオブジェクトに遭遇した際の挙動」をあらかじめ定義しておく。
罠3:描画更新のオーバーヘッド
ビューの数が多い図面で、ループのたびに画面描画(Redraw)を要求すると、処理速度は劇的に低下する。処理の「塊(Batch)」を意識し、最後に一度だけ更新をかけるのが鉄則だ。
2. アーキテクチャ設計:堅牢なロジックの構築
我々が実装すべきロジックは、以下の3層構造で設計する。
1. Validation層: 現在のドキュメントが「図面」であるか、また有効なドキュメントかを厳格にチェックする。
2. Traversal(走査)層: `GetFirstView` から `GetNextView` を使い、シートの階層を正しく辿る。
3. Execution(実行)層: 各ビューが「モデルビュー」であるかを判定し、安全にプロパティを書き換える。
3. 実践:プロダクション・グレードのコード例
以下に、実務でそのまま利用できるレベルのコードを示す。単なるコピペで終わらせず、コメントから私の意図を読み取ってほしい。
Option Explicit
''' <summary>
''' 図面内の全ビューに対して接線表示モードを一括制御する
''' </summary>
Public Sub SetAllViewsTangentEdgeMode()
' --- 定数定義(マジックナンバーを排除し、可読性を高める) ---
Const MODE_SHOW As Long = 1 ' 接線を表示
Const MODE_HIDE As Long = 2 ' 接線を非表示
Const MODE_DASH As Long = 3 ' 接線を破線で表示
' ターゲットとなるモードを選択(ここでは例として「破線」を選択)
' 本来はユーザーフォーム等から選択させるのが理想的だ
Dim targetMode As Long
targetMode = MODE_DASH
' --- オブジェクト宣言 ---
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim viewCount As Long
Dim errorCount As Long
' 初期化
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' --- 1. Validation層: 入力チェック ---
If swModel Is Nothing Then
MsgBox "ドキュメントが開かれていません。", vbCritical
Exit Sub
End If
If swModel.GetType <> swDocDRAWING Then
MsgBox "アクティブなドキュメントが図面ではありません。", vbCritical
Exit Sub
End If
Set swDraw = swModel
viewCount = 0
errorCount = 0
' 描画更新を一時停止し、パフォーマンスを最適化する(大規模図面対策)
' ※SolidWorks APIには直接的な「描画停止」コマンドはないが、
' 最後に一括で再構築を行うことで疑似的に高速化する。
' --- 2. Traversal層: ビューの走査 ---
' GetFirstViewは「シート(Root View)」を返すことに注意せよ
Set swView = swDraw.GetFirstView
Do While Not swView Is Nothing
' --- 3. Execution層: 属性操作 ---
' ルートビュー(シート自体)はスキップし、モデルビューのみを対象とする
' GetTypeでビューの種類を確認する手法が最も安全だ
If swView.Type <> swViewType_e.swDrawingViewType_Sheet Then
On Error Resume Next ' 予期せぬエラーによる中断を防ぐ
' 接線表示モードの設定
' swTangentEdgeDisplayMode_e を使用
swView.SetTangentEdgeDisplayMode targetMode
If Err.Number <> 0 Then
errorCount = errorCount + 1
Err.Clear
Else
viewCount = viewCount + 1
End If
On Error GoTo 0 ' エラーハンドリングを元に戻す
End If
' 次のビューへ移動
Set swView = swView.GetNextView
Loop
' --- 4. 最終処理: 画面更新と結果報告 ---
' 全ての変更が終わった後に、一度だけモデルを再構築する
swModel.ForceRebuild3 True
If errorCount = 0 Then
MsgBox "処理完了: " & viewCount & " 個のビューの接線表示を更新しました。", vbInformation
Else
MsgBox "処理完了: " & viewCount & " 個のビューを更新しましたが、" & _
errorCount & " 個のビューでエラーが発生しました。", vbExclamation
End If
End Sub
4. チーフアーキテクトからの技術講義
このコードを読み解く上で、君たちがマスターすべき「プロの視点」を3点授ける。
① `On Error Resume Next` の使い方
「エラーを無視するなんて無責任だ」と言う者がいる。それは間違いだ。
プロフェッショナルは、「無視してもシステム全体に影響がないことが分かっているエラー」に対してのみ、局所的にこれを使用する。 今回の場合、特定のビューが何らかの理由で操作不能であっても、マクロ全体を止めてユーザーの手を煩わせるべきではない。エラーをカウントし、最後に報告する。これが「道具」としての礼儀だ。
② `swViewType_e.swDrawingViewType_Sheet` によるフィルタリング
`swView.Type` をチェックすることは、防御的プログラミングの基本だ。図面には、モデルの投影図だけでなく、注釈、寸法、そして「シート」そのものがビューとして存在している。これらを混同することは、設計図という精密な構造物に、無秩序な命令を叩き込むに等しい。
③ 拡張性への布石
上記のコードでは `targetMode` を固定値にしているが、実務ツールにするならば、ここを `InputBox` や `UserForm` から取得するように変更せよ。また、将来的に「特定のレイヤーにあるビューだけを対象にする」といった条件分岐を追加したくなったとき、この `Do While` ループの構造であれば、容易に拡張が可能だ。
まとめ
自動化とは、単に作業を速くすることではない。「人間が介在することで発生するミスを、構造的に排除すること」だ。
今回学んだ「オブジェクトの型を意識した走査」と「堅牢なエラーハンドリング」を、他のAPI操作にも応用せよ。それが、君たちを「単なるプログラマー」から「信頼されるエンジニア」へと変える唯一の道だ。
以上だ。作業に戻れ。
