component::AddControlAction

特定の操作のコールバックをコントロールに追加します。

On this page	入力出力
Since	21.0

コントロールアクションをコントロールに追加します。コントロールアクションとは、コントロールを操作した時に発動される追加動作のことです。例えば、コントロールが選択された時に他のコントロールの可視性を変更することができます。コントロールアクションは、カスタムPythonコールバックにすることもできます。

このノードの graph ポートおよび control ポートはインプレースポートです。つまり、コピーを作成せずにグラフとコントロールが更新されます。

入力 ¶


                *graph:
                    ApexGraphHandle

Required

コントロールを含んだグラフ。


                *control:
                    ApexNodeID

Required

アクションを追加するコントロール。


                trigger:
                    String

action が発動されるコントロール操作。

操作	説明
`box_selected`	コントロールがボックス選択されるとアクションが発動されます。
`drag`	コントロールがプライマリコントロールの時にそのコントロールをドラッグしている間に継続的にアクションを実行します。 Warning これにより、パフォーマンスに悪影響を及ぼす可能性があります。
`enddrag`	マウスドラッグ終了時にコントロールがプライマリコントロールである場合にアクションが発動されます。
`scroll`	マウスホイールイベントの発生後にアクションが発動されます。
`selection`	ボタンクリックと同様に、コントロールが単一選択として選択された直後にアクションが発動されます。
`startdrag`	ユーザがコントロールのドラッグを開始する直前にそのコントロールがプライマリコントロールである場合にアクションが発動されます。


                action:
                    String

trigger の後に実行されるアクション。

アクション	説明
`pinchannels`	アニメーションエディタ内の複数のコントロールのアニメーションチャンネルをピン留めします。コントロールは、 pattern 入力ポートにAPEXパスパターンで指定します。このアクションが再び発動されると、アニメーションチャンネルのピン留めが解除されます。
`python`	pythonsnippet 入力ポートで指定されたカスタムPythonスニペットを実行します。このPythonコールバックには、以下の変数を介したAnimateステートへの自動バインディングが用意されています: `apex`: APEXモジュール。 `state`: APEX Animateステートモジュール。 `device`: 修飾キーに関する情報を取得できるUIEventデバイスクラスです。 `hou`: 標準Houdini Pythonモジュール。
`select`	コントロールを操作した後に複数のコントロールを選択します。これらのコントロールは、 pattern 入力ポートにAPEXパスパターンで指定します。
`setvisible`	複数のコントロールの表示/非表示を切り替えます。これは、選択セットでコントロールの表示/非表示を更新する操作に似ています。これらのコントロールは、 pattern 入力ポートにAPEXパスパターンで指定します。
`snap`	mapping_a と mapping_b で定義されたマッピングを使用して、スペーススイッチのスナップ操作を実行します。これらのマッピングはトランスフォームのマッピングを定義しており、 enableparm によってアクティブなマッピングが決定されます。


                pattern:
                    String

action 入力ポート内のselect、setvisible、pinchannelsのアクションで使用されるターゲットコントロールを指定したAPEXパスパターン。


                mapping_a:
                    Dict

snap action 用の最初のスペーススイッチマッピング。


                mapping_b:
                    Dict

snap action 用の2番目のスペーススイッチマッピング。


                parm:
                    String

snapおよびpinchannelsのアクションで使用されるパラメータ名。


                enableparm:
                    String

snap action 用の有効化パラメータ名。スペーススイッチのような設定の場合、これは、 mapping_a か mapping_b のどちらを使用するかを定義します。


                pythonsnippet:
                    String

python action を使用した時に実行されるカスタムPythonコード。


                reset_a:
                    StringArray

snap action で mapping_a を使用した時にデフォルト値にリセットされるコントロールチャネル名ペアの配列。


                reset_b:
                    StringArray

snap action で mapping_b を使用した時にデフォルト値にリセットされるコントロールチャネル名ペアの配列。


                setparmvalue:
                    Bool

Trueに設定すると、 enableparm で定義されたsnap action パラメータの値が設定されます。デフォルトはTrueです。

出力 ¶


                *graph:
                    ApexGraphHandle

入力グラフのパススルー。


                *control:
                    ApexNodeID

プロパティが更新されたコントロールノード。

入力 ¶

出力 ¶

APEXノード