Your Ad Here

Go to: Synopsis. Flags. Return value. Python examples.

Synopsis

radioCollection( [radioCollectionName] , [collectionItemArray=boolean], [defineTemplate=string], [edit=boolean], [exists=boolean], [gl=boolean], [numberOfCollectionItems=boolean], [parent=string], [query=boolean], [select=string], [useTemplate=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

radioCollection is undoable, queryable, and editable.

This command creates a radio button collection. Collections are parented to the current default layout if no parent is specified with the -p/parent flag. As children of the layout they will be deleted when the layout is deleted. Collections may also span more than one window if the -gl/global flag is used. In this case the collection has no parent and must be explicitly deleted with the deleteUI command when it is no longer wanted.

Flags

collectionItemArray, defineTemplate, edit, exists, gl, numberOfCollectionItems, parent, query, select, useTemplate
Long name (short name) [argument types] Properties
query(q) boolean query
Puts the command in query mode so that it will return the value of the specified flag.

In query mode, this flag needs a value.
edit(e) boolean edit
Puts the command in edit mode so that it will change the values of the specified flags
exists(ex) boolean create
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
defineTemplate(dt) string create
Puts a command in a mode where any other flags and args are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
useTemplate(ut) string create
Will force the command to use a command template other than the current one.
gl(gl) boolean createquery
Set the collection to have no parent layout. Global collections must be explicitly deleted.

In query mode, this flag needs a value.
parent(p) string create
The parent of the collection. The collection will be deleted along with the parent.
select(sl) string createqueryedit
Select the specified collection item. If queried will return the name of the currently selected collection item.

In query mode, this flag needs a value.
numberOfCollectionItems(nci) boolean query
Return the number of items in this collection.

In query mode, this flag needs a value.
collectionItemArray(cia) boolean query
Return a string list giving the long names of all the items in this collection.

In query mode, this flag needs a value.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Return value


Full path name to the collection.

Python examples

import maya.cmds as cmds

cmds.window()
cmds.columnLayout( adjustableColumn=True, rowSpacing=10 )
cmds.frameLayout( label='Colors' )
cmds.columnLayout()
collection1 = cmds.radioCollection()
rb1 = cmds.radioButton( label='Red' )
rb2 = cmds.radioButton( label='Blue' )
rb3 = cmds.radioButton( label='Green' )
cmds.setParent( '..' )
cmds.setParent( '..' )

cmds.frameLayout( label='Position' )
cmds.columnLayout()
collection2 = cmds.radioCollection()
rb4 = cmds.radioButton( label='Top' )
rb5 = cmds.radioButton( label='Middle' )
rb6 = cmds.radioButton( label='Bottom' )
cmds.setParent( '..' )
cmds.setParent( '..' )

cmds.radioCollection( collection1, edit=True, select=rb2 )
cmds.radioCollection( collection2, edit=True, select=rb6 )
cmds.showWindow()

Return to Autodesk Index


Your Ad Here