【テクニカル・上級編】【初心者向け】図面内の特定文字列(担当者名や図面ステータス)を正規表現レスで高速に部分一致置換するVBA – SolidWorks VBA解析バイブル

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

【極限の知見】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の重みを知り、オブジェクトの寿命を支配する。その積み重ねが、信頼されるエンジニアリング・システムを作り上げるのだ。

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