menu

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

Synopsis

menu [-allowOptionBoxes boolean] [-defineTemplate string] [-deleteAllItems] [-docTag string] [-enable boolean] [-exists] [-familyImage string] [-helpMenu boolean] [-itemArray] [-label string] [-ltVersion string] [-mnemonic string] [-numberOfItems] [-parent string] [-postMenuCommand script] [-postMenuCommandOnce boolean] [-tearOff boolean] [-useTemplate string] [-version string] [-visible boolean] [string]

menu is undoable, queryable, and editable.

Return value

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

Flags

Long name (short name)	Argument types	Properties
-allowOptionBoxes(-aob)	boolean
Deprecated. All menus now always allow option boxes. Indicate whether the menu will be able to support option box menu items.
-defineTemplate(-dt)	string
Puts the 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.
-deleteAllItems(-dai)
Delete all the items in this menu.
-docTag(-dtg)	string
Attaches a tag to the menu.
-enable(-en)	boolean
Enables/disables the menu.
-exists(-ex)
Returns whether the specified object exists or not. Other flags are ignored.
-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.
-helpMenu(-hm)	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.
-itemArray(-ia)
Return string array of the menu item names.
-label(-l)	string
The text that is displayed for the menu. If no label is supplied then the menuName will be used.
-ltVersion(-lt)	string
This flag is used to specify the Maya LT version that this control feature was introduced, if the version flag is not specified, or if the version flag is specified but its argument is different. This value is only used by Maya LT, and otherwise ignored. The argument should be given as a string of the version number (e.g. "2014", "2015"). Currently only accepts major version numbers (e.g. 2014.5 should be given as "2014").
-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.
-numberOfItems(-ni)
Return number of items in the menu.
-parent(-p)	string
Specify the window that the menu will appear in.
-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.
-tearOff(-to)	boolean
Makes the menu tear-off-able.
-useTemplate(-ut)	string
Forces the command to use a command template other than the current one.
-version(-ver)	string
Specify the version that this menu feature was introduced. The argument should be given as a string of the version number (e.g. "2014", "2015"). Currently only accepts major version numbers (e.g. 2014.5 should be given as "2014").
-visible(-vis)	boolean
Shows/hides 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 be used more than once in a command.

MEL examples

window -menuBar true -width 200;
menu -label "File" -tearOff true;
    menuItem -label "New";
    menuItem -label "Open";
    menuItem -label "Save";
    menuItem -divider true;
    menuItem -label "Quit";
menu -label "Help" -helpMenu true;
    menuItem -label "About Application...";
columnLayout;
    button; button; button;
showWindow;