menuItem

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

Synopsis

menuItem( [menuItemName] , [allowOptionBoxes=boolean], [altModifier=boolean], [annotation=string], [boldFont=boolean], [checkBox=boolean], [collection=string], [command=string], [commandModifier=boolean], [ctrlModifier=boolean], [data=int], [divider=boolean], [docTag=string], [dragDoubleClickCommand=string], [dragMenuCommand=string], [echoCommand=boolean], [enable=boolean], [enableCommandRepeat=boolean], [familyImage=string], [image=string], [imageOverlayLabel=string], [insertAfter=string], [isCheckBox=boolean], [isOptionBox=boolean], [isRadioButton=boolean], [italicized=boolean], [keyEquivalent=string], [label=string], [mnemonic=string], [optionBox=boolean], [optionModifier=boolean], [parent=string], [postMenuCommand=string], [postMenuCommandOnce=boolean], [radialPosition=string], [radioButton=boolean], [shiftModifier=boolean], [subMenu=boolean], [tearOff=boolean])

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

menuItem is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
label(l)	string
The text that appears in the item. In query mode, this flag needs a value.
divider(d)	boolean
Creates a divider menu item. In query mode, this flag needs a value.
checkBox(cb)	boolean
Creates a check box menu item. Argument specifies the check box value. In query mode, this flag needs a value.
isCheckBox(icb)	boolean
Returns true if the item is a check box item. In query mode, this flag needs a value.
radioButton(rb)	boolean
Creates a radio button menu item. Argument specifies the radio button value. In query mode, this flag needs a value.
isRadioButton(irb)	boolean
Returns true if the item is a radio button item. In query mode, this flag needs a value.
optionBox(ob)	boolean
Indicates that the menu item will be an option box item. This item will appear to the right of the preceeding menu item.
isOptionBox(iob)	boolean
Returns true if the item is an option box item. In query mode, this flag needs a value.
enable(en)	boolean
Enable state for the menu item. A disabled menu item is dimmed and unresponsive. An enabled menu item is selectable and has normal appearance. In query mode, this flag needs a value.
parent(p)	string
Specify the menu that the item will appear in.
insertAfter(ia)	string
Specify After which item the new one will be placed. If this flag is not specified, item is added at the end of the menu. Use the empty string "" to insert before the first item of the menu. WARNING: This flag is known to cause problems with tear off menus. It is recommended that you do not use it with menus that are tear off enabled. In other words, the parent menu should not have its -to/tearOff flag set.
collection(cl)	string
To explicitly add a radio menu item to a collection.
image(i)	string
The filename of the icon associated with the menu item. If the menu containing the menu item is being edited with a menuEditor widget, then the menuEditor will use this icon to represent the menu item. This icon will be displayed on the shelf when the menu item is placed there. In query mode, this flag needs a value.
imageOverlayLabel(iol)	string
Specify a short (5 character) text string to be overlayed on top of the icon associated with the menu item. This is primarily a mechanism for differentiating menu items that are using a Family icon due to the fact that an icon image had not been explicitly defined. The image overlay label will not be used if an icon image is defined for the menu item. In query mode, this flag needs a value.
familyImage(fi)	string
Get the filename of the family icon associated with the menu. The family icon will be used for the shelf unless an icon is specified with the -image flag. In query mode, this flag needs a value.
mnemonic(mn)	string
Set the Alt key to activate that item. The character specified must match the case of its corresponding character in the menu item text, but selection from the keyboard is case insensitive. In query mode, this flag needs a value.
allowOptionBoxes(aob)	boolean
In the case of submenu items this flag specifies whether the submenu will be able to support option box menu items. An error results if an option box item is added to a menu that doesn't allow them. This flag may be queried and must be specified when the submenu item is created. This flag is ignored for non-submenu items. The default value is false. In query mode, this flag needs a value.
subMenu(sm)	boolean
Indicates that the item will have a submenu. Subsequent menuItems will be added to the submenu until setParent -menu is called. Note that a submenu item creates a menu object and consequently the menu command may be used on the submenu item. In query mode, this flag needs a value.
tearOff(to)	boolean
For the case where the menu item is a sub menu this flag will make the sub menu tear-off-able. Note that this flag has no effect on the other menu item types.
annotation(ann)	string
Annotate the menu item with an extra string value. In query mode, this flag needs a value.
docTag(dt)	string
Attaches a tag to the menu item. In query mode, this flag needs a value.
data(da)	int
Attaches a piece of user-defined data to the menu item.
radialPosition(rp)	string
The radial position of the menu item if it is in a Marking Menu. Radial positions are given in the form of a cardinal direction, and may be "N", "NW", "W", "SW", "S", "SE", "E" or "NE".
command(c)	string
Attaches a command/script that will be executed when the item is selected. Note this command is not executed when the menu item is in an optionMenu control.
dragMenuCommand(dmc)	string
If the menu item is put on the shelf then this command will be invoked when the corresponding shelf object is clicked. In query mode, this flag needs a value.
dragDoubleClickCommand(ddc)	string
If the menu item is put on the shelf then this command will be invoked when the corresponding shelf object is double clicked. In query mode, this flag needs a value.
postMenuCommand(pmc)	string
Specify a script to be executed when the submenu is about to be shown.
postMenuCommandOnce(pmo)	boolean
Indicate the -pmc/postMenuCommand should only be invoked once. Default value is false, ie. the -pmc/postMenuCommand is invoked everytime the sub menu is shown. In query mode, this flag needs a value.
keyEquivalent(ke)	string
Specify the accelerator character. This character is combined with the modifier keys specified with the -alt/altModifier, -opt/optionModifier, -ctl/ctlModifier, -cmd/commandModifier and -sh/shiftModifier to form the complete accelerator sequence that you can type to execute the menu item. Note that only regular menu items, radio menu items and check box menu items can have an accelerator. In query mode, this flag needs a value.
altModifier(alt)	boolean
optionModifier(opt)	boolean
Specify this flag if the Alt (or option) modifier is part of the accelerator sequence. In query mode, this flag needs a value.
ctrlModifier(ctl)	boolean
Specify this flag if the Cntl modifier is part of the accelerator sequence. In query mode, this flag needs a value.
commandModifier(cmd)	boolean
Specify this flag if the command modifier is part of the accelerator sequence. This is only available on systems which have a separate command key. In query mode, this flag needs a value.
shiftModifier(sh)	boolean
Specify this flag if the Shift modifier is part of the accelerator sequence. In query mode, this flag needs a value.
enableCommandRepeat(ecr)	boolean
This flag only affects menu items to which a command can be attached. Specify true and the command may be repeated by executing the command repeatLast. This flag is true by default for all items except for option box items. In query mode, this flag needs a value.
echoCommand(ec)	boolean
Specify whether the action attached with the -c/command flag should echo to the command output areas when invoked. This flag is false by default and must be specified with the -c/command flag. In query mode, this flag needs a value.
italicized(it)	boolean
Specify if text should be italicized. Only supported in menus which use the marking menu implementation. Default is false. In query mode, this flag needs a value.
boldFont(bld)	boolean
Specify if text should be bold. Only supported in menus which use the marking menu implementation. Default is false for Windows, and true for all other platforms. 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

Python examples

import maya.cmds as cmds

cmds.window( menuBar=True, width=200 )
cmds.menu( label='Stuff', allowOptionBoxes=True )
cmds.menuItem( subMenu=True, label='Colors' )
cmds.menuItem( label='Blue' )
cmds.menuItem( label='Green' )
cmds.menuItem( label='Yellow' )
cmds.setParent( '..', menu=True )
cmds.menuItem( divider=True )
cmds.radioMenuItemCollection()
cmds.menuItem( label='Yes', radioButton=False )
cmds.menuItem( label='Maybe', radioButton=False )
cmds.menuItem( label='No', radioButton=True )
cmds.menuItem( divider=True )
cmds.menuItem( label='Top', checkBox=True )
cmds.menuItem( label='Middle', checkBox=False )
cmds.menuItem( label='Bottom', checkBox=True )
cmds.menuItem( divider=True )
cmds.menuItem( label='Option' )
cmds.menuItem( optionBox=True )
cmds.columnLayout()
cmds.button()
cmds.button()
cmds.button()
cmds.showWindow()