【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からのメッセージです。楽しんでコードを書いていきましょう!
応援していますよ!
