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

概要

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

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

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

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

戻り値

string作成された toolCollection の名前。

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

フラグ

clear, collectionItemArray, defineTemplate, exists, gl, numberOfCollectionItems, parent, select, useTemplate
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
clear(cl)
2025
 boolean edit
コレクション内のすべての項目を選択解除します。
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()