CATIA

CATIAマクロの主役はSelectionオブジェクト——現場で使う選択テクニック集

2025.01.15 / 読了目安 9分 / 執筆: Qronix 開発チーム

#CATIA#現場主義#CATIAマクロ

CATIAのVBAマクロで最も出番が多いオブジェクトは何か。私たちの答えはSelectionだ。対象を集め、ユーザーに選ばせ、コマンドに引き渡す。マクロの実用性は選択の設計で決まると言っていい。累計500本超のツールを作ってきた現場から、Selectionの実戦テクニックをコード付きでまとめる。

ノギスでの計測Photo: Unsplash
CONTENTS
1. なぜSelectionがマクロの主役なのか 2. Searchをコードから使う——一括選択の破壊力 3. フィルタ付きユーザー選択——SelectElement2で誤選択を防ぐ 4. 選択結果の安全な処理——Clearの規律 5. 現場で効く小技集——選択を「見せる」使い方

なぜSelectionがマクロの主役なのか

CATIAマクロの処理は、突き詰めれば「対象を決めて、何かをする」の繰り返しだ。この「対象を決める」を一手に担うのがSelectionオブジェクトで、ActiveDocument.Selectionで取得できる。地味な存在だが、実務のマクロでこれを使わないものはほとんどない。

Selectionには二つの顔がある。一つはプログラムから対象を集める入れ物としての顔。SearchやAddで要素を溜め、まとめて処理する。もう一つはユーザーとの対話窓口としての顔。SelectElement2系のメソッドで「選んでください」と促し、人の判断をマクロに取り込む。

どちらの顔も、使い方を誤ると「たまに変な動きをするマクロ」の原因になる。選択の設計が甘いマクロは、想定外の要素を巻き込んで暴走する。この記事では、私たちが全ツールで守っている選択の作法を順に紹介する。

Selectionを使う処理の基本形Clear前の選択の残骸を消すSearch / SelectElem…条件検索または対話で対象を集める件数確認と退避0件分岐と配列への退避を忘れない処理してClear実行後は選択を明示的に始末する
開始と終了のClearが暴走を防ぐ

Searchをコードから使う——一括選択の破壊力

手作業で数百個の要素を選ぶ作業は、Selection.Searchで一撃になる。検索文字列はCATIA画面の編集メニューにある検索コマンドと同じ文法で、例えば「Name=*BRKT*,all」なら名前にBRKTを含む要素を全階層から集める。画面で試して当たりを付けてからコードに移すのが定石だ。

検索条件は名前だけでなく、タイプ・色・レイヤー・パラメータ値まで指定できる。「'Part'の'穴'」のようにタイプで絞る、特定色の面だけ集める、といった条件を組み合わせれば、目視では不可能な精度と速度で対象が揃う。

注意点は検索スコープだ。末尾の「,all」は文書全体、「,in」は現在編集中の作業対象内、「,sel」は現在の選択の中から絞り込む。スコープを省略したり誤ったりすると、意図しない階層の要素まで巻き込む。Searchを書くときは、条件よりスコープを先に確認する癖をつけたい。

マクロの実用性は、
選択の設計で決まる。

手選択とSearchの作業時間画面で手選択約30分・漏れリスク大目視依存で再現性なしSelection.Search1秒・漏れなし条件が残るので再実行も一瞬
名前条件で300要素を選ぶ場合の体感比較

フィルタ付きユーザー選択——SelectElement2で誤選択を防ぐ

ユーザーに要素を選ばせる場面では、SelectElement2にフィルタを渡す。許可するタイプの配列を第一引数に指定すると、それ以外の要素はそもそも選べなくなる。面だけ、エッジだけ、Part文書だけ。誤選択の可能性を、コードの側で最初から潰しておくわけだ。

フィルタなしで選ばせて後からタイプ判定する書き方も可能だが、私たちは推奨しない。ユーザーは必ず想定外のものを選ぶ。選ばせてから「それは選べません」と怒るより、選べないようにしておく方が、使う側の体験も実装の堅牢性も上だ。

戻り値の確認も必須だ。SelectElement2は結果を文字列で返し、正常選択なら「Normal」、ESCキーでの中断なら「Cancel」が返る。この判定を省いたマクロは、ユーザーがキャンセルした瞬間に実行時エラーで落ちる。キャンセルは異常ではなく、正規の操作として設計に織り込む。

選択結果の安全な処理——Clearの規律

Selectionは文書ごとに1つしかない共有資源だ。前の処理の選択が残ったままSearchやAddをすると、意図しない要素が混ざる。だから処理の開始時にClear、終了時にもClear。この規律だけで、選択がらみの不具合の大半は消える。

取得した要素はsel.Item2(i).Valueで実体にアクセスするが、ループ処理中に選択内容を変えるとインデックスがずれる。安全にやるなら、先に全要素を配列やコレクションに退避してからループする。選択の入れ物と処理の対象を分離するのがコツだ。

もう一つ、VisPropertiesの存在も覚えておきたい。Selectionを介して色や表示状態を一括変更できるプロパティで、Searchと組み合わせると「条件に合う要素を全部赤にする」ような可視化ツールが数行で書ける。チェック結果の見える化に重宝する。

Selection を書くときに守る作法✓処理の入口と出口で Clear する✓Search は条件よりスコープ(all / in / sel)を先に確認する✓SelectElement2 にはフィルタを渡し、選べないようにしておく✓戻り値が Normal か Cancel かを必ず判定する✗選択0件のときに無言で終わる
図3: 選択がらみの不具合は、この5つでほとんど消える。

現場で効く小技集——選択を「見せる」使い方

最後に小技を3つ。1つ目、処理対象をいきなり変更せず、まずSearchで選択状態にして件数をメッセージ表示し、ユーザーの確認を取ってから実行する。選択のハイライトがそのままプレビューになり、安心感がまるで違う。

2つ目、チェック系マクロの結果報告は、NG要素をSelectionに残して終わる。ユーザーはマクロ終了後、ハイライトされた要素を見るだけで問題箇所に飛べる。レポートファイルより速い『答えの見せ方』だ。

3つ目、選択件数ゼロの分岐を必ず書く。Searchの結果が0件のとき、無言で終わるマクロは「動いていないのか、対象がないのか」をユーザーに悩ませる。0件なら0件と明示的に伝える。こうした小さな作法の積み重ねが、現場に信頼されるマクロとそうでないマクロを分ける。

同じような自働化を検討中でしたら、一度話を聞かせてください。ヒアリングと自働化設計書の提案までは無料で行っています。使えるものが無ければ、無いとお伝えします。

Searchで集めてから終えるまでマクロ開始開始時にSelectionをClearSearchで集めるスコープを確認選択件数は0件?0件だと明示して伝える件数を表示してユーザーの確認を取る要素を配列に退避しループで処理チェック系マクロ?NG要素を選択に残す終了時にClear終了0件1件以上はいいいえ
図4: 開始時のClear、0件の分岐、確認してからの実行、NG要素を選択に残す終わり方を1本で示す。
VBA参考実装例:Searchで条件に合う要素を一括選択する
Sub CATMain()
    ' 名前に"BRKT"を含む要素を全階層から集めて件数を報告する
    Dim sel As Selection
    Set sel = CATIA.ActiveDocument.Selection

    sel.Clear   ' 前の選択の残骸を必ず消す

    ' 画面の検索コマンドと同じ文法。",all"は文書全体がスコープ
    sel.Search "Name=*BRKT*,all"

    If sel.Count2 = 0 Then
        ' 0件は0件と明示的に伝える(無言で終わらせない)
        MsgBox "対象が見つかりませんでした。"
        Exit Sub
    End If

    ' 選択状態がそのままプレビューになる
    Dim ans As Integer
    ans = MsgBox(sel.Count2 & " 件を選択しました。" & vbCrLf & _
                 "ハイライトを確認して処理を続けますか?", vbYesNo)
    If ans = vbNo Then
        sel.Clear
        Exit Sub
    End If

    ' ここに一括処理を書く(色変更・出力など)
    ' 例: sel.VisProperties.SetRealColor 255, 0, 0, 1

    sel.Clear   ' 終了時もClearして始末する
End Sub
VBA参考実装例:フィルタ付きでユーザーに面だけを選ばせる
Sub CATMain()
    ' SelectElement2のフィルタで、面以外は最初から選べなくする
    Dim sel As Selection
    Set sel = CATIA.ActiveDocument.Selection
    sel.Clear

    Dim filter(0) As Variant
    filter(0) = "Face"   ' 許可タイプは面のみ(EdgeやVertexは弾く)

    Dim status As String
    status = sel.SelectElement2(filter, _
             "チェックしたい面を選択してください(ESCで中断)", False)

    ' キャンセルは異常ではなく正規の操作として扱う
    If status <> "Normal" Then
        MsgBox "選択がキャンセルされました。処理を中断します。"
        Exit Sub
    End If

    Dim pickedFace As Object
    Set pickedFace = sel.Item2(1).Value

    MsgBox "選択された面: " & pickedFace.Name

    sel.Clear   ' 使い終わったら必ずClear
End Sub
Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →