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


iconTextRadioCollection( [string] , [collectionItemArray=boolean], [disableCommands=boolean], [gl=boolean], [numberOfCollectionItems=boolean], [parent=string], [select=string])

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

iconTextRadioCollection is undoable, queryable, and editable.

This command creates a cluster for iconTextRadioButtons. Clusters will be 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. Clusters may also span more than one window if the -g/global flag is used. In this case the cluster has no parent so must be explicitly deleted with the 'deleteUI' command.

Return value

stringThe name of the iconTextRadioCollection created.

In query mode, return type is based on queried flag.


collectionItemArray, disableCommands, gl, numberOfCollectionItems, parent, select
Long name (short name) Argument types Properties
gl(gl) boolean createquery
Set the collection to have no parent layout. If the collection has a parent layout then it will be deleted with that layout, otherwise if it is specified to be global it must be explicitly deleted.
parent(p) string create
Set the specified layout to be the parent layout of the cluster.
select(sl) string createqueryedit
Select the specified collection item. If queried will return the name of the currently selected collection item.
disableCommands(dcm) boolean edit
Allows a particular iconTextRadioButton in the collection to be selected without invoking the commands attached to the -cc/changeCommand, -onc/onCommand, or -ofc/offCommand flags. This flag is only meaningful when used in conjuction with the -edit and -select flags.
numberOfCollectionItems(nci) boolean query
Returns the number of items that are in this collection.
collectionItemArray(cia) boolean query
Returns a string list giving the long names of all the items in this collection.

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.

Python examples

import maya.cmds as cmds

cmds.window( tlc=(100, 400) )
cmds.columnLayout( adj=True )
cmds.iconTextRadioCollection( 'itRadCollection' )
cmds.iconTextRadioButton( st='textOnly', i1='sphere.png', l='sphere' )
cmds.iconTextRadioButton( st='iconOnly', i1='spotlight.png', l='spotlight' )
cmds.iconTextRadioButton( st='iconAndTextHorizontal', i1='cone.png', l='cone' )
cmds.iconTextRadioButton( st='iconAndTextVertical', i1='cube.png', l='cube' )