CATIAマクロの主役はSelectionオブジェクト——現場で使う選択テクニック集
CATIAのVBAマクロで最も出番が多いオブジェクトは何か。私たちの答えはSelectionだ。対象を集め、ユーザーに選ばせ、コマンドに引き渡す。マクロの実用性は選択の設計で決まると言っていい。累計500本超のツールを作ってきた現場から、Selectionの実戦テクニックをコード付きでまとめる。
Photo: UnsplashなぜSelectionがマクロの主役なのか
CATIAマクロの処理は、突き詰めれば「対象を決めて、何かをする」の繰り返しだ。この「対象を決める」を一手に担うのがSelectionオブジェクトで、ActiveDocument.Selectionで取得できる。地味な存在だが、実務のマクロでこれを使わないものはほとんどない。
Selectionには二つの顔がある。一つはプログラムから対象を集める入れ物としての顔。SearchやAddで要素を溜め、まとめて処理する。もう一つはユーザーとの対話窓口としての顔。SelectElement2系のメソッドで「選んでください」と促し、人の判断をマクロに取り込む。
どちらの顔も、使い方を誤ると「たまに変な動きをするマクロ」の原因になる。選択の設計が甘いマクロは、想定外の要素を巻き込んで暴走する。この記事では、私たちが全ツールで守っている選択の作法を順に紹介する。
Searchをコードから使う——一括選択の破壊力
手作業で数百個の要素を選ぶ作業は、Selection.Searchで一撃になる。検索文字列はCATIA画面の編集メニューにある検索コマンドと同じ文法で、例えば「Name=*BRKT*,all」なら名前にBRKTを含む要素を全階層から集める。画面で試して当たりを付けてからコードに移すのが定石だ。
検索条件は名前だけでなく、タイプ・色・レイヤー・パラメータ値まで指定できる。「'Part'の'穴'」のようにタイプで絞る、特定色の面だけ集める、といった条件を組み合わせれば、目視では不可能な精度と速度で対象が揃う。
注意点は検索スコープだ。末尾の「,all」は文書全体、「,in」は現在編集中の作業対象内、「,sel」は現在の選択の中から絞り込む。スコープを省略したり誤ったりすると、意図しない階層の要素まで巻き込む。Searchを書くときは、条件よりスコープを先に確認する癖をつけたい。
マクロの実用性は、
選択の設計で決まる。
フィルタ付きユーザー選択——SelectElement2で誤選択を防ぐ
ユーザーに要素を選ばせる場面では、SelectElement2にフィルタを渡す。許可するタイプの配列を第一引数に指定すると、それ以外の要素はそもそも選べなくなる。面だけ、エッジだけ、Part文書だけ。誤選択の可能性を、コードの側で最初から潰しておくわけだ。
フィルタなしで選ばせて後からタイプ判定する書き方も可能だが、私たちは推奨しない。ユーザーは必ず想定外のものを選ぶ。選ばせてから「それは選べません」と怒るより、選べないようにしておく方が、使う側の体験も実装の堅牢性も上だ。
戻り値の確認も必須だ。SelectElement2は結果を文字列で返し、正常選択なら「Normal」、ESCキーでの中断なら「Cancel」が返る。この判定を省いたマクロは、ユーザーがキャンセルした瞬間に実行時エラーで落ちる。キャンセルは異常ではなく、正規の操作として設計に織り込む。
選択結果の安全な処理——Clearの規律
Selectionは文書ごとに1つしかない共有資源だ。前の処理の選択が残ったままSearchやAddをすると、意図しない要素が混ざる。だから処理の開始時にClear、終了時にもClear。この規律だけで、選択がらみの不具合の大半は消える。
取得した要素はsel.Item2(i).Valueで実体にアクセスするが、ループ処理中に選択内容を変えるとインデックスがずれる。安全にやるなら、先に全要素を配列やコレクションに退避してからループする。選択の入れ物と処理の対象を分離するのがコツだ。
もう一つ、VisPropertiesの存在も覚えておきたい。Selectionを介して色や表示状態を一括変更できるプロパティで、Searchと組み合わせると「条件に合う要素を全部赤にする」ような可視化ツールが数行で書ける。チェック結果の見える化に重宝する。
現場で効く小技集——選択を「見せる」使い方
最後に小技を3つ。1つ目、処理対象をいきなり変更せず、まずSearchで選択状態にして件数をメッセージ表示し、ユーザーの確認を取ってから実行する。選択のハイライトがそのままプレビューになり、安心感がまるで違う。
2つ目、チェック系マクロの結果報告は、NG要素をSelectionに残して終わる。ユーザーはマクロ終了後、ハイライトされた要素を見るだけで問題箇所に飛べる。レポートファイルより速い『答えの見せ方』だ。
3つ目、選択件数ゼロの分岐を必ず書く。Searchの結果が0件のとき、無言で終わるマクロは「動いていないのか、対象がないのか」をユーザーに悩ませる。0件なら0件と明示的に伝える。こうした小さな作法の積み重ねが、現場に信頼されるマクロとそうでないマクロを分ける。
同じような自働化を検討中でしたら、一度話を聞かせてください。ヒアリングと自働化設計書の提案までは無料で行っています。使えるものが無ければ、無いとお伝えします。
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 SubSub 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