【入門編】【初心者向け】図面シート名(Sheet1, Sheet2…)をアセンブリ構成部品の名称に連動させて一括リネームするVBA – SolidWorks VBA解析バイブル

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

マクロ記録の先へ。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` で完了を伝えています。
大量の処理を行うマクロでは、処理の途中で何度もメッセージが出るとユーザーはストレスを感じます。「一連の処理が終わったタイミングで、一言だけ報告する」。これが、現場で愛されるツールを作るためのマナーです。

まとめ:次の一歩へ

お疲れ様でした!これであなたは、単にボタンを押すだけのユーザーから、「図面の構造を理解し、操作するエンジニア」へと一歩踏み出しました。

今回学んだ「階層を辿る」という考え方は、図面だけでなく、アセンブリの構成部品を制御したり、カスタムプロパティを一括書き換えしたりする際にも、全く同じように使えます。

「仕組み(オブジェクトモデル)を理解すれば、もう怖くない」

この言葉を胸に、次は「特定のコンフィギュレーション名を取得してシート名にする」といった、より高度な改造にも挑戦してみてください。もし行き詰まったら、またここに戻ってきてくださいね。

応援しています!

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