【実務・中級編】【初心者向け】図面ビュー内の接線表示モード(表示/非表示/破線)を一括切り替えするVBAマクロ – SolidWorks VBA解析バイブル

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

「接線表示の制御」を極める:単なるスクリプトから、業務を支える「ツール」への昇華

エンジニア諸君、現場の泥臭い作業を自動化しようとするその姿勢は素晴らしい。しかし、一つ忠告しておこう。「動けばいい」というレベルのコードを書くのは、自動化エンジニアではなく、単なるスクリプト・キディだ。

図面作成において、接線(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操作にも応用せよ。それが、君たちを「単なるプログラマー」から「信頼されるエンジニア」へと変える唯一の道だ。

以上だ。作業に戻れ。

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