ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

removeMultiInstance [-allChildren boolean] [-break boolean] attribute

removeMultiInstance は、取り消し可能、照会不可能、および編集不可能です。

multiElement の特定のインスタンスを除去します。出力アトリビュートは、ノードが次回実行された際に再生成されるので、入力アトリビュートのみに便利です。このコマンドはインスタンスを除去し、オプションでそのインスタンスの入出力接続をすべて切断します。-b true フラグを使用して接続を切断しない場合、接続が存在すると、このコマンドはエラーになります。

戻り値

boolean(インスタンスが除去された場合は true、何らかの問題がある場合は false (アトリビュートが接続されているが、-b true が指定されなかった場合など))

フラグ

allChildren, break
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-allChildren(-all) boolean create
引数が true の場合は、複数の親のすべての子を削除します。
-break(-b) boolean create
この引数を true にすると、アトリビュートのすべての接続が切断されてから要素が除去されます。false にした場合、要素が接続されていると、このコマンドはエラーになります。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// This will remove the element with index 4 from the input of
// the choice node as long as there are no incoming or outgoing
// connections to the attribute.
//
removeMultiInstance choice.input[4];

// This will remove the element with index 100 from the input of
// the choice node, breaking any existing connections first.
//
removeMultiInstance -b true choice.input[100];