Go to: Synopsis. Return value. Flags. Python examples.
menu( [string] , [allowOptionBoxes=boolean],
[deleteAllItems=boolean],
[docTag=string], [enable=boolean], [familyImage=string], [helpMenu=boolean], [itemArray=boolean], [label=string], [mnemonic=string], [numberOfItems=boolean], [parent=string], [postMenuCommand=script],
[postMenuCommandOnce=boolean],
[tearOff=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
menu is undoable, queryable, and editable.
This command creates a new menu and adds it to the default window's
menubar if no parent is specified. The menu can be
enabled/disabled. Note that this command may also be used on menu
objects created using the command menuItem -sm/subMenu true.
| string |
Full path name to the menu. |
In query mode, return type is based on queried flag.
allowOptionBoxes, deleteAllItems, docTag, enable,
familyImage, helpMenu, itemArray, label,
mnemonic, numberOfItems, parent, postMenuCommand, postMenuCommandOnce, tearOff
| Long name (short name) |
Argument types |
Properties |
enable(en) |
boolean |
   |
|
Enables/disables the menu. |
|
|
boolean |
|
|
Indicates that this menu is the help menu and will be the right
most menu in the menu bar. On Unix systems the help menu is also
right justified in the menu bar. |
|
label(l) |
string |
|
|
The text that is displayed for the menu. If no label is
supplied then the menuName will be used. |
|
mnemonic(mn) |
string |
|
|
Set the Alt key to post that menu. The character specified must
match the case of its corresponding character in the menu item
text, but selection from the keyboard is case insensitive. |
|
parent(p) |
string |
|
|
Specify the window that the menu will appear in. |
|
tearOff(to) |
boolean |
|
|
Makes the menu tear-off-able. |
|
allowOptionBoxes(aob) |
boolean |
|
|
Deprecated. All menus now always allow option boxes. Indicate
whether the menu will be able to support option box menu
items. |
|
numberOfItems(ni) |
boolean |
|
|
Return number of items in the menu. |
|
itemArray(ia) |
boolean |
|
|
Return string array of the menu item names. |
|
postMenuCommand(pmc) |
script |
|
|
Specify a script to be executed when the menu 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 every time the menu is shown. |
|
deleteAllItems(dai) |
boolean |
|
|
Delete all the items in this menu. |
|
familyImage(fi) |
string |
|
|
The filename of the icon associated with the menu. This icon
will be used if a menu item does not have an icon image
defined. |
|
docTag(dtg) |
string |
|
|
Attaches a tag to the menu. |
|
| 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. |
import maya.cmds as cmds
cmds.window( menuBar=True, width=200 )
cmds.menu( label='File', tearOff=True )
cmds.menuItem( label='New' )
cmds.menuItem( label='Open' )
cmds.menuItem( label='Save' )
cmds.menuItem( divider=True )
cmds.menuItem( label='Quit' )
cmds.menu( label='Help', helpMenu=True )
cmds.menuItem( 'Application..."', label='"About' )
cmds.columnLayout()
cmds.button()
cmds.button()
cmds.button()
cmds.showWindow()