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

概要

toolCollection( [string] , [collectionItemArray=boolean], [defineTemplate=string], [exists=boolean], [gl=boolean], [numberOfCollectionItems=boolean], [parent=string], [select=string], [useTemplate=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

ツール ボタン コレクションを作成するコマンドです。-p/parent フラグで親を指定しない場合、現在の既定のレイアウトがコレクションの親になります。クラスタはレイアウトの子なので、レイアウトが削除されるとクラスタもいっしょに削除されます。-gl/global フラグを使用しない場合は、コレクションを複数のウィンドウにスパンさせることもできます。この場合、コレクションには親がなく、不要になったら「deleteUI」コマンドでコレクションを明示的に削除する必要があります。

戻り値

string作成された toolCollection の名前。

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

collectionItemArray, defineTemplate, exists, gl, numberOfCollectionItems, parent, select, useTemplate
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
collectionItemArray(cia) boolean query
このコレクションにあるすべてのオブジェクトのロング ネームを示す文字列リストを返します。
defineTemplate(dt) string create
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
exists(ex) boolean create
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
gl(gl) boolean createquery
コレクションが親のレイアウトを持たないように設定します。このフラグはコレクションの作成時に指定しなければなりません。照会、編集できません。したがって、グローバル コレクションは明示的に削除する必要があります。
numberOfCollectionItems(nci) boolean query
このコレクションにあるオブジェクトの数を返します。
parent(p) string create
コレクションを関連付けるための親を指定します。コレクションは、親と一緒に削除されます。このフラグはコレクションの作成時に指定しなければなりません。編集はできません。
select(sl) string createqueryedit
指定したコレクション オブジェクトを選択します。照会すると、現在選択されているコレクション オブジェクトの名前を返します。
useTemplate(ut) string create
コマンドに、現在以外のコマンド テンプレートの使用を強制します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

cmds.window()
cmds.columnLayout()
cmds.toolCollection()
cmds.toolButton( tool='selectSuperContext', toolImage1=('selectSuperContext', 'aselect.xpm') )
cmds.toolButton( tool='moveSuperContext', toolImage1=('moveSuperContext', 'move_M.png') )
cmds.toolButton( tool='scaleSuperContext', toolImage1=('scaleSuperContext', 'scale_M.png') )
cmds.showWindow()