【極限の知見】SolidWorks図面におけるテキスト制御の真髄 — 高速・低負荷な部分一致置換の実装
設計自動化の現場において、「図面内の特定の文字列を書き換える」というタスクは、一見すると初歩的な問題に見える。しかし、数千枚の図面を管理するエンタープライズ環境において、この「初歩的な実装」が、メモリリークやシステムハングアップ、あるいは数時間の処理遅延を引き起こす致命的なバグへと変貌する様を、私は嫌というほど見てきた。
本稿では、正規表現(RegExp)という重いライブラリに頼ることなく、VBAのネイティブ機能を最大限に活用し、オブジェクトのライフサイクルを厳格に管理しながら、図面内のノート(Note)を高速に走査・置換する「プロフェッショナル仕様」の手法を解説する。
1. 凡庸なエンジニアが陥る「3つの罠」
実装に入る前に、多くの開発者が犯す設計ミスを定義しておく。これらを回避することこそが、アーキテクトとしての第一歩である。
罠1:COMオブジェクトの解放漏れ
SolidWorks APIはCOM(Component Object Model)ベースである。ループ内で `Note` や `Annotation` オブジェクトを生成・参照し、それを適切に `Nothing` で解放しない場合、メモリ上に「幽霊オブジェクト」が蓄積され続ける。これは長時間のバッチ処理において、不可避的なクラッシュを招く。
罠2:不必要なAPIコールによるオーバーヘッド
`Note.GetText` や `Note.SetText` は、単なる文字列操作ではない。背後ではSolidWorksのグラフィカル・エンジンと通信し、モデルの再描画フラグを立てる重い処理だ。すべてのノートに対して無差別に書き込みを行うのは、計算資源の浪費である。
罠3:階層構造の無視
図面のノートは、`Sheet` 直下に存在するだけでなく、各 `View`(投影図)の中に隠れている。Viewを介さずにノートを探そうとする実装は、データの欠落を招く。
2. 高速化の戦略:なぜ「正規表現レス」なのか
「正規表現を使えば柔軟に検索できる」という意見がある。しかし、今回のような「特定のキーワードを含むか否か」という単純な判定において、正規表現エンジン(`VBScript.RegExp`)の呼び出しは、CPUサイクルとメモリ消費の観点から見て「過剰(Overkill)」である。
VBA標準の `InStr` 関数は、内部的に極めて最適化された文字列検索アルゴリズムを使用している。部分一致の判定のみであれば、`InStr` を使用するのが、実行速度およびメモリ効率において最も合理的である。
3. 実装:堅牢な置換アーキテクチャ
以下に、実戦投入可能なレベルのコードを示す。このコードは、単なる「書き換え」ではなく、「リソース管理」に主眼を置いている。
Option Explicit
''
' @description 図面内の全ノートを走査し、特定の文字列を置換する。
' @param swApp SolidWorks Application インスタンス
' @param targetKeyword 検索するキーワード
' @param replacementString 置換後の文字列
''
Public Sub FastReplaceDrawingNotes(ByRef swApp As Object, _
ByVal targetKeyword As String, _
ByVal replacementString As String)
Dim swModel As Object ' SldWorks.ModelDoc2
Dim swDraw As Object ' SldWorks.DrawingDoc
Dim swSheet As Object ' SldWorks.Sheet
Dim swView As Object ' SldWorks.View
Dim swNote As Object ' SldWorks.Note
Dim swAnn As Object ' SldWorks.Annotation
Dim currentText As String
Dim updatedText As String
Dim matchCount As Long
' 1. コンテキストの取得
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> 3 Then ' swDocDRAWING = 3
MsgBox "図面ファイルを開いてください。", vbCritical
Exit Sub
End If
Set swDraw = swModel
matchCount = 0
' エラーハンドリングの確立
On Error GoTo ErrorHandler
' 2. 全シートの走査(必要に応じて拡張可能)
' ここでは現在アクティブなシートを対象とする
Set swSheet = swDraw.GetCurrentSheet
' 3. Viewの走査
' 図面には「Sheet」自体が最初のViewとして存在する
Set swView = swDraw.GetFirstView ' Sheet View
Do While Not swView Is Nothing
' Viewに属する最初のNoteを取得
Set swNote = swView.GetFirstNote
Do While Not swNote Is Nothing
' --- 最重要:オブジェクトの参照取得 ---
currentText = swNote.GetText
' 4. 高速部分一致判定 (InStr を使用)
' vbTextCompare を指定することで、大文字小文字を区別しない柔軟な検索を実現
If InStr(1, currentText, targetKeyword, vbTextCompare) > 0 Then
' 置換処理
updatedText = Replace(currentText, targetKeyword, replacementString, , , vbTextCompare)
' テキストが変更された場合のみAPIを叩く(重要:不要な書き込みを避ける)
If updatedText <> currentText Then
swNote.SetText updatedText
matchCount = matchCount + 1
End If
End If
' 次のNoteへ
Set swNote = swNote.GetNext
' --- メモリ管理:ループ内での明示的な解放 ---
' 注:VBAの参照カウント制御に任せるのが基本だが、
' 非常に大規模なループでは、明示的な Nothing が安定性に寄与する
Set swNote = Nothing
Loop
' 次のViewへ
Set swView = swView.GetNext
Set swView = Nothing
Loop
' 5. 変更の確定と再描画
swModel.ForceRebuild3 True
MsgBox matchCount & " 件のテキストを置換しました。", vbInformation
CleanUp:
' 6. オブジェクトの完全な解放(メモリリーク防止の鉄則)
Set swAnn = Nothing
Set swNote = Nothing
Set swView = Nothing
Set swSheet = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
4. アーキテクトの視点:なぜこの実装が「強い」のか
オブジェクト・トラバーサル(走査)の設計
このコードでは、`GetFirstView` から始まり、各 `View` の中の `Note` を辿る構造を取っている。SolidWorksの図面構造において、表題欄(Title Block)のテキストは、多くの場合「Sheet View」に属する。この階層を正しく辿ることで、図面内のあらゆる場所に配置されたテキストを漏らさず捕捉できる。
条件付き書き込み(Conditional Write)
`If updatedText <> currentText Then` という一行。これがパフォーマンスの鍵である。
APIを通じて `SetText` を呼び出す行為は、SolidWorks内部の「Dirtyフラグ(変更ありフラグ)」を立て、再計算プロセスを誘発させる。不必要な書き込みをスキップすることで、描画エンジンの負荷を最小限に抑えている。
メモリのライフサイクル管理
`CleanUp` ラベルを用いたエラーハンドリングと、`Set … = Nothing` による明示的な解放。これはレガシーなVBA環境から最新の64bit環境まで、一貫して「安定したシステム」を構築するための作法である。特に、数千のオブジェクトをループする際、この作法が守られていないコードは、いずれメモリ不足で沈む。
5. 結論
図面自動化における真のプロフェッショナリズムとは、単に「動くコード」を書くことではない。「大規模なデータセットにおいても、予測可能なパフォーマンスを維持し、システムのリソースを浪費しないコード」を書くことである。
正規表現に逃げず、APIの重みを知り、オブジェクトの寿命を支配する。その積み重ねが、信頼されるエンジニアリング・システムを作り上げるのだ。
