マクロ記録の先へ。SolidWorks VBAで「図面シート名」をモデル名と同期させる極意
こんにちは。設計自動化の世界へようこそ。
「マクロの記録」ボタンを押し、自分が操作した手順がコードとして書き出されるのを見て、「おお、これで自動化ができるぞ!」と胸を躍らせた経験は、誰にでもあるはずです。でも、書き出されたコードを眺めてみて、こう思ったことはありませんか?
*「……これ、どういう意味なんだろう?」*
*「もっとスマートに、一括で処理する方法があるはずなのに」*
もしそう感じているなら、おめでとうございます。あなたは今、「操作の記録者」から「システムの設計者(アーキテクト)」へと進化する境界線に立っています。
今日扱うテーマは、実務で非常にニーズの高い「図面シート名を、参照しているモデル(部品やアセンブリ)の名前で自動リネームする」というものです。
単にコードを提示するだけではありません。SolidWorks APIの「構造」を理解し、なぜそのコードが必要なのか、その本質を伝授します。ここをクリアすれば、あなたのVBAスキルは一段上のステージへ上がりますよ。
1. 思考の準備:SolidWorks APIの「階層構造」を理解する
プログラミング、特にAPI操作において最も重要なのは、「オブジェクトの親子関係(階層構造)」を頭に叩き込むことです。
SolidWorksを一つの巨大な「箱」だと考えてください。
図面ファイルを操作する場合、その中身は以下のような入れ子構造になっています。
1. DrawingDoc (図面ファイル):一番外側の箱
2. Sheet (シート):図面の中にある「ページ」
3. View (ビュー):シートの上に置かれた「モデルを映す窓」
4. ModelDoc2 (モデル):窓の向こう側にある「実際の部品やアセンブリ」
今回の目的は、「シートの名前を、そのシートにあるビューが参照しているモデルの名前で書き換える」ことです。
つまり、辿るルートはこうなります。
[DrawingDoc] $\rightarrow$ [Sheet] $\rightarrow$ [View] $\rightarrow$ [ModelDoc2] $\rightarrow$ [Name]
このルートを正確に辿れるようになれば、どんな自動化も怖くありません。
2. 実装コード:シート名一括リネーム・マクロ
それでは、実際のコードを見ていきましょう。初心者の方でも読みやすいよう、丁寧なコメントを添えています。
Option Explicit
' ==============================================================================
' テーマ: 図面シート名を、各シート内のモデル名に基づいて一括リネームする
' 概要: 図面の全シートをスキャンし、最初のビューが参照しているモデル名を取得して
' シート名を書き換えます。
' ==============================================================================
Sub RenameSheetsByModelName()
' --- 1. 変数の宣言 ---
' SolidWorksの各種オブジェクトを定義します(これらはAPI操作の基本パーツです)
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swSheet As SldWorks.Sheet
Dim swView As SldWorks.View
Dim swModelView As SldWorks.ModelDoc2 ' ビューが参照しているモデル用
Dim vSheetNames As Variant
Dim i As Integer
Dim modelName As String
' --- 2. SolidWorksへの接続 ---
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc ' 現在開いているドキュメントを取得
' 図面ファイルが開かれていない場合は終了
If swModel Is Nothing Then
MsgBox "図面ファイルを開いてから実行してください。", vbExclamation
Exit Sub
End If
' ドキュメントが図面(Drawing)であるかチェック
If swModel.GetType <> swDocDRAWING Then
MsgBox "このマクロは図面ファイル専用です。", vbExclamation
Exit Sub
End If
' 図面オブジェクトとしてセット
Set swDraw = swModel
' --- 3. シートのループ処理 ---
' 全シートの名前を取得して配列に格納します
vSheetNames = swDraw.GetSheetNames
For i = 0 To UBound(vSheetNames)
' 対象のシートをアクティブにする
swDraw.ActivateSheet vSheetNames(i)
Set swSheet = swDraw.GetCurrentSheet
' --- 4. ビューの探索 ---
' ここが重要:図面における「最初のビュー」は、実は「シートそのもの」を指しています。
' そのため、GetFirstViewの「次」を取得する必要があります。
Set swView = swDraw.GetFirstView ' これは「シート」を指す特殊なビュー
Set swView = swView.GetNextView ' これで「初めてのモデルビュー」に到達
' ビューが存在するかチェック(空のシート対策)
If Not swView Is Nothing Then
' ビューが参照しているモデルを取得
Set swModelView = swView.GetModelDoc2
If Not swModelView Is Nothing Then
' モデルの名前を取得(拡張子なしで取得したい場合は加工が必要)
' ここではシンプルにファイル名を取得します
modelName = swModelView.GetTitle
' もしファイル名に ".sldprt" などが含まれている場合は置換(任意)
modelName = Replace(modelName, ".sldprt", "")
modelName = Replace(modelName, ".sldasm", "")
' --- 5. シート名の書き換え ---
' シート名を新しいモデル名に変更
swSheet.SetName modelName
End If
Else
' ビューがない(空の)シートの場合は何もしない
Debug.Print "Sheet: " & vSheetNames(i) & " にはビューが見つかりませんでした。"
End If
Next i
' 完了通知
MsgBox "シート名の更新が完了しました!", vbInformation
End Sub
3. アーキテクトの視点:ここが「プロ」への分かれ道
コードをただコピペするだけでは、本当の力にはなりません。このコードの中に隠された「設計の勘所」を解説します。
① 「最初のビュー」の罠(The First View Trap)
初心者の方が最も陥りやすいエラーがこれです。
SolidWorksのAPIでは、`swDraw.GetFirstView` を実行したとき、返ってくるのは「モデルの投影図」ではなく、「シートそのもの(Sheet View)」なのです。
もし、`GetNextView` を使わずにそのままモデル名を取得しようとすると、エラーになるか、意図しない動作をします。
「最初のビューはシートである」。この仕様を知っているかどうかが、APIマスターへの第一歩です。
② エラーハンドリングの重要性
実務の図面には、必ずと言っていいほど「ビューが一つも配置されていない空のシート」や「参照モデルがリンク切れしているシート」が存在します。
コード内で `If Not swView Is Nothing Then` とチェックを入れているのは、「想定外のデータでマクロを止まらせないため」です。
完璧なコードとは、動くコードではなく、「止まらないコード」のことです。
③ パフォーマンスとユーザー体験
最後に `MsgBox` で完了を伝えています。
大量の処理を行うマクロでは、処理の途中で何度もメッセージが出るとユーザーはストレスを感じます。「一連の処理が終わったタイミングで、一言だけ報告する」。これが、現場で愛されるツールを作るためのマナーです。
まとめ:次の一歩へ
お疲れ様でした!これであなたは、単にボタンを押すだけのユーザーから、「図面の構造を理解し、操作するエンジニア」へと一歩踏み出しました。
今回学んだ「階層を辿る」という考え方は、図面だけでなく、アセンブリの構成部品を制御したり、カスタムプロパティを一括書き換えしたりする際にも、全く同じように使えます。
「仕組み(オブジェクトモデル)を理解すれば、もう怖くない」
この言葉を胸に、次は「特定のコンフィギュレーション名を取得してシート名にする」といった、より高度な改造にも挑戦してみてください。もし行き詰まったら、またここに戻ってきてくださいね。
応援しています!
