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

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

【SolidWorks VBA】図面内のテキストを自動書き換え!初心者でもできる「特定キーワード置換」の極意

こんにちは。設計業務の自動化に取り組んでいる皆さん、調子はどうですか?

「マクロの記録」ボタンを押して、記録されたコードを眺めては、「これをどうやって実務で使える形に組み上げればいいんだろう……」と立ち止まってしまう。そんな経験はありませんか?

実は、その壁を乗り越えるための鍵は、コードの量ではなく「SolidWorksが、図面の中をどう見ているか」という構造(オブジェクトモデル)を理解することにあります。

今日は、実務で非常によくある「図面内の表題欄やノートに書かれた『担当者名』や『ステータス』を、一括で書き換えたい」という課題をテーマに、正規表現などの難しい知識を使わずに、もっともシンプルかつ高速に、そして「壊れにくい」コードを書く方法を伝授します。

ここをクリアすれば、あなたのVBAスキルは「記録の再生」から「設計の自動化」へと一気に進化しますよ。

1. 準備運動:図面の中身を「解剖」してみよう

プログラミングを始める前に、SolidWorksが図面をどう捉えているか、頭の中でイメージ図を作っておきましょう。ここがズレていると、どんなに優れたコードも動きません。

図面(Drawing)は、以下のような入れ子構造(階層構造)になっています。

1. DrawingDoc(図面ドキュメント): 図面ファイルそのもの。
2. Sheet(シート): 図面内の「紙」の部分。
3. Annotation(注記): 図面上に載っているあらゆる「印」。

  • Note(ノート): 私たちが文字を書き込めるテキスト。
  • Dimension(寸法): 寸値。
  • Leader Note: 引き出し線付きの注記。

今回やりたいことは、「シートの中にある膨大な注記の中から、ノートを見つけ出し、その中身をチェックして、特定の文字が含まれていたら書き換える」という作業です。

2. 実践:キーワード置換マクロのコード

それでは、実際に使えるコードを見てみましょう。難しいことは抜きにして、まずはこのコードをコピーして、SolidWorksのVBAエディタに貼り付けてみてください。

Option Explicit

''' <summary>
''' 図面内のノートを検索し、特定の文字列を置換するメインルーチン
''' </summary>
Sub Main()
    ' SolidWorksのアプリケーションオブジェクトを取得
    Dim swApp As SldWorks.SldWorks
    Set swApp = Application.SldWorks
    
    ' 現在開いているドキュメントを取得
    Dim swModel As SldWorks.ModelDoc2
    Set swModel = swApp.ActiveDoc
    
    ' ドキュメントが図面(Drawing)でない場合は終了
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを開いた状態で実行してください。", vbExclamation
        Exit Sub
    End If
    
    ' 図面ドキュメントとしてキャスト(型変換)
    Dim swDraw As SldWorks.DrawingDoc
    Set swDraw = swModel
    
    ' 現在表示されているシートを取得
    Dim swSheet As SldWorks.Sheet
    Set swSheet = swDraw.GetCurrentSheet
    
    ' --- 置換の設定(ここを書き換えて使います) ---
    Dim targetKeyword As String: targetKeyword = "設計者:"  ' 探したいキーワード
    Dim oldTextPart As String: oldTextPart = "田中"        ' 置換したい古い名前
    Dim newTextPart As String: newTextPart = "佐藤"        ' 新しい名前
    ' --------------------------------------------

    ' 置換処理の実行
    Call ReplaceNoteTextInSheet(swSheet, targetKeyword, oldTextPart, newTextPart)
    
    ' 画面を再描画して変更を反映
    swModel.ForceRebuild3 True
    
    MsgBox "置換処理が完了しました!", vbInformation
End Sub

''' <summary>
''' 指定されたシート内のノートをループし、部分一致でテキストを置換する
''' </summary>
Sub ReplaceNoteTextInSheet(swSheet As SldWorks.Sheet, keyword As String, oldText As String, newText As String)
    Dim swAnn As SldWorks.Annotation
    Dim swNote As SldWorks.Note
    Dim currentText As String
    Dim updatedText As String
    
    ' 【重要】シート上のすべての注記(Annotation)を走査する
    ' GetFirstAnnotationから順に辿っていく「リンクドリスト」という手法を使います
    Set swAnn = swSheet.GetFirstAnnotation
    
    Do While Not swAnn Is Nothing
        ' 注記の種類が「ノート(テキスト)」であるかを確認
        If swAnn.GetType = swAnnotationType_e.swAnnotationType_Note Then
            
            ' AnnotationオブジェクトからNoteオブジェクトへ変換
            Set swNote = swAnn.GetSpecificAnnotation
            
            ' 現在のノートのテキストを取得
            currentText = swNote.GetText
            
            ' 【判定】ノートの中に「キーワード」が含まれているか? (InStr関数を使用)
            ' InStrは、見つかった位置を数値で返す。0より大きければ「含まれている」という意味。
            If InStr(1, currentText, keyword, vbTextCompare) > 0 Then
                
                ' 【置換】古い文字列を新しい文字列に置き換える
                ' Replace関数は、正規表現を使わずに文字列を扱うもっとも標準的な方法です
                updatedText = Replace(currentText, oldText, newText, , , vbTextCompare)
                
                ' もし中身が変わっていたら、新しいテキストを書き込む
                If updatedText <> currentText Then
                    swNote.SetText updatedText
                End If
                
            End If
        End If
        
        ' 次の注記へ進む
        Set swAnn = swAnn.GetNext
    Loop
End Sub

3. ここがプロの視点!コードの解説とテクニック

「動いた!でも、なぜこう書くの?」という疑問に答えておきましょう。ここが、初心者から脱却するための最重要ポイントです。

① 正規表現を使わない「InStr」と「Replace」の選択

多くの高度なプログラミング本では「正規表現(RegExp)」を推奨しますが、図面のテキスト置換においては、今回使った `InStr`(部分一致判定)と `Replace`(文字列置換)の組み合わせが最強です。

  • 理由1:圧倒的な速度。正規表現エンジンを起動するオーバーヘッドがありません。
  • 理由2:デバッグの容易さ。正規表現は「なぜマッチしなかったのか」の解析が難しいですが、`InStr` なら「文字が一致しているか」が直感的にわかります。

② オブジェクトの「型」を意識する

コードの中で `swAnn.GetSpecificAnnotation` を使っていますよね?
これは、「注記(Annotation)という汎用的な箱から、ノート(Note)という具体的な中身を取り出す」という操作です。
SolidWorks APIでは、すべての注記は `Annotation` ですが、寸法(Dimension)やノート(Note)では持っているプロパティが異なります。「箱」から「中身」を取り出すイメージを持つことが、APIマスターへの近道です。

③ ライフサイクルと再描画

最後に `swModel.ForceRebuild3 True` を入れています。
APIでデータを書き換えても、画面上の表示が古いまま残ってしまうことがよくあります。「データは変わったのに、見た目が変わらない!」というエラーの9割は、この再描画の不足が原因です。

4. よくある落とし穴(エラーを未然に防ぐために)

このマクロを運用する上で、初心者が陥りやすいポイントをまとめておきます。

1. 「図面が開いていない」エラー

  • `ActiveDoc` が `Nothing` の時に処理を進めようとすると、マクロがクラッシュします。必ず `If swModel Is Nothing Then Exit Sub` のように、ガード(防護策)を入れましょう。

2. 「ノート」ではなく「寸法」を書き換えようとする

  • 図面には寸法もたくさんあります。`If swAnn.GetType = swAnnotationType_e.swAnnotationType_Note` という条件分岐を忘れると、寸法値を無理やりテキストとして書き換えようとしてエラーになります。

3. 大文字・小文字の区別

  • `vbTextCompare` というオプションを `InStr` や `Replace` に付けています。これを入れることで、「DESIGNER」と「designer」を同じものとして扱えるようになり、実務上のミスを防げます。

最後に:一歩ずつ、確実に

いかがでしたか?
「マクロの記録」で出力された、意味の分からない大量の `Select Case` や `SelectionManager` の羅列とは、全く違う景色が見えてきたのではないでしょうか。

一度に完璧なプログラムを作ろうとしなくて大丈夫です。まずは「特定の文字を書き換える」という小さな成功体験を積み重ねてください。その積み重ねが、数ヶ月後には「設計業務を丸ごと自動化する強力なツール」へと繋がっています。

もしエラーが出たら、それは「もっと詳しくオブジェクトを調べてごらん」というSolidWorksからのメッセージです。楽しんでコードを書いていきましょう!

応援していますよ!

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