ジャンプ先: 概要. 戻り値. キーワード. 関連項目. フラグ. MEL 例.

概要

containerBind [-allNames] [-bindingSet string] [-bindingSetConditions] [-bindingSetList] [-force] [-preview]

containerBind は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

コンテナに対して自動バインド操作を行うコンテナ コマンドに付属するアクセサリ コマンドです。コンテナのパブリッシュ済みインタフェースは、コネクトされているコンテナ テンプレートに bindingSet を使用することでバインドできます。

戻り値

none

戻り値の型は照会モードでは照会フラグが基になります。

キーワード

bind, container

関連項目

container, containerProxy, containerPublish, containerTemplate

フラグ

allNames, bindingSet, bindingSetConditions, bindingSetList, force, preview
ロング ネーム(ショート ネーム) 引数型 プロパティ
-force(-f) create
このフラグを使用して、通常であれば実行されない操作を強制実行します。
-preview(-p) create
このフラグは、バインド操作のプレビューを提供しますが、操作を実際には実行しません。バインド操作の影響を受けるパブリッシュ済みの名前ごとに publishedName/boundName のペアのリストが返されます。 バインド操作の結果、パブリッシュ済みの名前が変わらない場合はリスト表示されません。 バインドされたがバインド解除されてしまうパブリッシュ済みの名前も表示され、コネクトされた boundName は空文字列で示されます。
-allNames(-all) create
コンテナ上にあるすべてのパブリッシュ済みの名前をバインド操作時に考慮するように指定します。デフォルトでは、バインドされていないパブリッシュ済みの名前のみが操作の対象になります。「all」に「force」オプションを追加で指定することで、バインド操作実行前に既存のバインドされたパブリッシュ済みの名前がリセット(またはバインド解除)されます。パブリッシュ済みの名前に対し適切なバインドがない場合は、バインドされていない状態のままになります。
-bindingSet(-bs) string query
バインド操作や照会操作で使用するテンプレート バインド セットの名前を指定します。 このフラグは照会モードでは使用できません。

このフラグは照会モードでは値が必要になります。

-bindingSetList(-bsl) queryedit
照会モードで使用すると、コネクトされたコンテナ テンプレートに定義されている使用可能なバインド セットのリストが返されます。
-bindingSetConditions(-bsc) query
照会モードで使用すると、指定したテンプレート バインド セットにあるバインド セットの条件エントリのリストが返されます。 このリストには、各バインド セットのエントリに対する、すべてのパブリッシュ済みの名前と条件文字列のペアが含まれます。 このフラグはコネクトされたバインド セットの全エントリを返し、コンテナにあるパブリッシュ済みの名前のリスト、バインド状態の有無など、各エントリの有効性は考慮しません。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL 例

// query the template binding sets available for this container
//
containerBind -query -bindingSetList container1;
// attempt to bind published names on the container
// using matching information in the bindingSet specified.
// By default only unbound names are considered.
//
containerBind -bindingSet "MayaBindings" container1;
// Attempt to bind all published names on the container
// using matching information in the bindingSet specified.
// Previously bound names will only be re-bound if the bindingSet
// produces an appropriate match.
//
containerBind -bindingSet "MayaBindings" -allNames container1;
// Forcibly re-bind all published names on the container
// using matching information in the bindingSet specified.
// All previously bound names will be unbound and will only
// be re-bound if the binding set produces an appropriate match.
//
containerBind -bindingSet "MayaBindings" -force -allNames container1;
// preview what the results of a binding operation would be, but do
// not actually perform it.
containerBind -preview -bindingSet "MayaBindings" -force -all container1;