containerBind

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

概要

containerBind([allNames=boolean], [bindingSet=string], [bindingSetConditions=boolean], [bindingSetList=boolean], [force=boolean], [preview=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

戻り値

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

キーワード

関連項目

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# query the template binding sets available for this container
#
cmds.containerBind(container1, query=1, bindingSetList=1)
# attempt to bind published names on the container
# using matching information in the bindingSet specified.
# By default only unbound names are considered.
#
cmds.containerBind(container1, bindingSet="MayaBindings")
# 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.
#
cmds.containerBind(container1, bindingSet="MayaBindings", allNames=1)
# 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.
#
cmds.containerBind(container1, bindingSet="MayaBindings", allNames=1, force=1)
# preview what the results of a binding operation would be, but do
# not actually perform it.
cmds.containerBind(container1, bindingSet="MayaBindings", preview=1, allNames=1, force=1)