継ぎ接ぎのコードを卒業せよ:図面規格を「強制」する堅牢なプロパティ初期化設計
「とりあえず、全ての線の太さを変えるマクロを作りました」
もし君が、業務効率化の担当者としてそんな報告を私にしているとしたら、私は即座にそのコードを破棄させるだろう。なぜなら、それは「自動化」ではなく、単なる「破壊的な操作」に過ぎないからだ。
図面(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で規格を更新し、マクロに反映させることが可能になる。これこそが、真に「業務を自動化する」ということだ。
結論
自動化とは、単に「手作業を消す」ことではない。「正しいルールを、正しい手順で、確実に適用する仕組みを作る」ことだ。
君が次にコードを書くときは、単なるループ処理を書く前に、一度立ち止まって考えてほしい。「このコードは、規格が変わったときに泣きを見るか?」「このコードは、図面が巨大になったときに止まるか?」と。
その問いへの答えが、君を「ただのプログラマー」から「チーフアーキテクト」へと進化させる。
