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

Synopsis

radioMenuItemCollection [-defineTemplate string] [-exists] [-global boolean] [-parent string] [-useTemplate string] [string]

radioMenuItemCollection is undoable, queryable, and editable.

This command creates a radioMenuItemCollection. Attach radio menu items to radio menu item collection objects to get radio button behaviour. Radio menu item collections will be parented to the current menu if no parent is specified with the -p/parent flag. As children of the menu they will be deleted when the menu is deleted. Collections may also span more than one menu if the -g/global flag is used. In this case the collection has no parent menu and must be explicitly deleted with the deleteUI command when it is no longer wanted.

Return value

stringFull path name to the collection.

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

Flags

defineTemplate, exists, global, parent, useTemplate
Long name (short name) Argument types Properties
-exists(-ex) 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
Force the command to use a command template other than the current one.
-global(-gl) boolean createquery
Set the collection to have no parent menu. Global collections must be explicitly deleted.
-parent(-p) string create
The parent of the collection. The collection will be deleted along with the parent.

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 be used more than once in a command.

MEL examples

window -menuBar true;
    menu -label "Position";
        radioMenuItemCollection;
        menuItem -label "Top"    -radioButton off;
        menuItem -label "Middle" -radioButton off;
        menuItem -label "Bottom" -radioButton on;
    menu -label "Number";
        radioMenuItemCollection;
        menuItem -label "One"   -radioButton on;
        menuItem -label "Two"   -radioButton off;
        menuItem -label "Three" -radioButton off;
showWindow;