【実務・中級編】【初心者向け】図面ビューごとの線の太さやフォントなどのドキュメントプロパティを初期化するVBAマクロ – SolidWorks VBA解析バイブル

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

継ぎ接ぎのコードを卒業せよ:図面規格を「強制」する堅牢なプロパティ初期化設計

「とりあえず、全ての線の太さを変えるマクロを作りました」

もし君が、業務効率化の担当者としてそんな報告を私にしているとしたら、私は即座にそのコードを破棄させるだろう。なぜなら、それは「自動化」ではなく、単なる「破壊的な操作」に過ぎないからだ。

図面(Drawing)の自動化において、線の太さ、フォント、文字サイズといったドキュメントプロパティの制御は、一見すると単純な作業に見える。しかし、実務レベルでは「継承関係の複雑さ」「オブジェクトのライフサイクル」「パフォーマンスへの影響」という、初心者が陥りがちな罠が至る所に潜んでいる。

本記事では、単なる「コピペで動くコード」の提供はしない。現場で通用する、バグを許さない「規格復旧エンジンの設計思想」を伝授する。

1. 思考の転換:なぜ君のマクロは失敗するのか

初心者が書くコードの多くは、「全ての図形(Entity)をループで回して、一つずつプロパティを書き換える」という力技だ。これには致命的な欠陥が3つある。

1. 階層構造の無視: SolidWorksの図面は、`Document` $\rightarrow$ `Sheet` $\rightarrow$ `View` $\rightarrow$ `Entity` という階層構造を持っている。ビューに設定されたプロパティは、ドキュメント全体の設定をオーバーライド(上書き)する。この優先順位を理解せずにループを回しても、意図した結果は得られない。
2. 例外処理の欠如: 図面内には、スケッチ、注釈(Note)、寸法(Dimension)、そして複雑な構成のビューが混在している。特定のオブジェクトに対して、そのオブジェクトが持たないプロパティを操作しようとした瞬間、マクロは無慈悲にクラッシュする。
3. 計算コストの過小評価: 数千の要素を持つ図面で、一つ一つの変更に対して画面更新(Redraw)を走らせれば、処理時間は指数関数的に増大する。

我々プロフェッショナルが目指すべきは、「規格(Standard)を定義し、それを各階層へ論理的に適用する」設計である。

2. アーキテクチャ設計:Single Source of Truth(信頼できる唯一の情報源)

堅牢なツールを作るための鉄則は、「規格値をコードの中にハードコードしない」ことだ。

線の太さやフォント名をマクロのあちこちに散らしてはいけない。それらは一つの「定数定義セクション」または「外部設定ファイル」に集約すべきだ。これにより、社内規格が変更された際、修正箇所は一箇所だけで済む。これが「保守性の高いコード」の正体である。

3. 実装例:プロフェッショナル・リセット・エンジン

以下に、図面ビューおよびドキュメントプロパティを社内規格へ強制的にリセットするための、プロダクション品質のコード例を示す。

Option Explicit

' ==============================================================================
' 社内CAD規格定義セクション (Single Source of Truth)
' 規格変更時はここだけを修正すればよい
' ==============================================================================
Private Const STD_LINE_WEIGHT_THICK As Double = 0.035 ' 太線 (m)
Private Const STD_LINE_WEIGHT_THIN  As Double = 0.018 ' 細線 (m)
Private Const STD_FONT_NAME         As String = "MS Gothic"
Private Const STD_FONT_SIZE         As Double = 3.5   ' 文字サイズ (mm)

' ==============================================================================
' メインルーチン
' ==============================================================================
Public Sub ResetDrawingProperties()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swSheet As SldWorks.Sheet
    Dim vSheets As Variant
    Dim i As Integer
    
    On Error GoTo ErrorHandler
    
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 1. ドキュメント型の検証 (堅牢性の確保)
    If swModel Is Nothing Then
        MsgBox "ドキュメントが開かれていません。", vbCritical
        Exit Sub
    End If
    
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを選択してください。", vbExclamation
        Exit Sub
    End If
    
    Set swDraw = swModel
    
    ' 処理速度向上のため、描画更新を停止
    swModel.LockGraphics = True
    
    Debug.Print "--- プロパティ初期化処理開始 ---"
    
    ' 2. ドキュメント全体の基本設定を適用 (Document Level)
    ApplyDocumentStandard swModel
    
    ' 3. 全シート・全ビューの走査
    vSheets = swDraw.GetSheetNames
    For i = 0 To UBound(vSheets)
        swDraw.ActivateSheet vSheets(i)
        Set swSheet = swDraw.GetCurrentSheet
        
        Debug.Print "Processing Sheet: " & vSheets(i)
        
        ' シート内の全ビューを処理
        ProcessSheetViews swDraw, swSheet
    Next i
    
    ' 4. 後処理
    swModel.LockGraphics = False
    swModel.ForceRebuild3 True
    
    MsgBox "図面規格への復旧が完了しました。", vbInformation
    
    Exit Sub

ErrorHandler:
    swModel.LockGraphics = False
    MsgBox "致命的なエラーが発生しました:" & vbCrLf & Err.Description, vbCritical
End Sub

' ==============================================================================
' ドキュメントレベルのプロパティ適用
' ==============================================================================
Private Sub ApplyDocumentStandard(swModel As SldWorks.ModelDoc2)
    ' 例: デフォルトの注釈フォントなどを設定
    ' 注: APIの仕様に基づき、UserPreference系を使用
    swModel.SetUserPreferenceString2 swDocAnnotationFontName, STD_FONT_NAME
    Debug.Print "Document Standard Applied."
End Sub

' ==============================================================================
' シート内のビューを走査し、各エンティティを制御
' ==============================================================================
Private Sub ProcessSheetViews(swDraw As SldWorks.DrawingDoc, swSheet As SldWorks.Sheet)
    Dim swView As SldWorks.View
    Dim swEntity As SldWorks.Entity
    Dim swNote As SldWorks.Note
    Dim swLine As SldWorks.Line
    
    ' 最初のビュー(シートそのもの)から開始
    Set swView = swDraw.GetFirstView
    
    Do While Not swView Is Nothing
        ' ビュー内のエンティティを走査
        ' 注: swView.GetFirstEntity はビューに直接属するオブジェクトを返す
        Set swEntity = swView.GetFirstEntity
        
        Do While Not swEntity Is Nothing
            ' オブジェクトの型に応じて処理を分岐 (Type-safeな設計)
            Select Case swEntity.GetType
                
                Case swEntityType_e.swLine
                    Set swLine = swEntity.Line
                    ' 線の太さを規格に強制
                    ' ここでは単純化のため細線を適用しているが、ロジックにより分岐可能
                    swLine.SetLineWeight STD_LINE_WEIGHT_THIN
                
                Case swEntityType_e.swNote
                    Set swNote = swEntity.Note
                    ' フォントとサイズを強制
                    swNote.SetTextFont STD_FONT_NAME, False, False, False, False, False, False, STD_FONT_SIZE
                
                ' 他の型(Dimension等)が必要な場合はここに追加
            End Select
            
            Set swEntity = swEntity.GetNextEntity
        Loop
        
        Debug.Print "  View Processed: " & swView.Name
        Set swView = swView.GetNextView
    Loop
End Sub

4. プロフェッショナルが意識すべき「極限の知見」

このコードを理解し、さらに発展させるために、以下の3点を脳に刻んでおけ。

① `LockGraphics` によるパフォーマンスの最適化

図面内のエンティティを一つ書き換えるたびに、SolidWorksは画面を再描画しようとする。これは極めて重い処理だ。`swModel.LockGraphics = True` を使い、全ての処理が終わった後に一括で `ForceRebuild3` を叩く。この「まとめてやる」という意識が、処理速度を10倍、100倍と変える。

② オブジェクト型の厳格な判定 (`Select Case`)

`swEntity.GetType` を使った分岐は、単なる整理ではない。これは「予期せぬエラーを未然に防ぐ防壁」だ。注釈(Note)に対して線の太さ(LineWeight)を設定しようとすれば、VBAは即座に実行時エラーを吐く。型判定を厳格に行うことで、マクロの堅牢性は飛躍的に高まる。

③ 拡張性への布石

上記のコードでは、規格値を `Private Const` として定義した。実務でさらに高度なツールを作るなら、これを `CSV` や `XML` ファイルから読み込むように改造しろ。そうすれば、エンジニアがVBAを触ることなく、現場の管理者がExcelで規格を更新し、マクロに反映させることが可能になる。これこそが、真に「業務を自動化する」ということだ。

結論

自動化とは、単に「手作業を消す」ことではない。「正しいルールを、正しい手順で、確実に適用する仕組みを作る」ことだ。

君が次にコードを書くときは、単なるループ処理を書く前に、一度立ち止まって考えてほしい。「このコードは、規格が変わったときに泣きを見るか?」「このコードは、図面が巨大になったときに止まるか?」と。

その問いへの答えが、君を「ただのプログラマー」から「チーフアーキテクト」へと進化させる。

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