Menu.AddCommandItem
 
 
 

Menu.AddCommandItem

Description

Adds a menu item at the end of the menu and attaches a command. The command is fired when the menu item is selected. You can attach any native or custom commands you want to a menu item. If your menu is attached to a contextual menu and one of your command's arguments takes the selected object(s) by default, then the currently selected objects is passed to your command. The target object under the cursor is also passed in as part of the selected objects. However if no objects are selected, then only the target is passed in. See ArgumentCollection.AddWithHandler for defining a custom command's argument that takes the selected objects by default.

Tip: See any of the examples for creating a Simple Menu plug-in to see this method in action.

Note: This method could return an invalid object in python, use Menu.AddCommandItem2 instead.

C# Syntax

MenuItem Menu.AddCommandItem( String in_pLabel, Object in_cmd );

Scripting Syntax

oReturn = Menu.AddCommandItem( Label, Command );

Return Value

The newly created MenuItem object.

Parameters

Parameter Type Description
Label String The menu item label.
Command String or Command The name of a command or a command object that will be invoked when the menu item is selected. This is the real name (SIObject.Name) of the command, not the Command.ScriptingName. You can find the Name of a command by running it and then checking the Edit menu (where the Name of the last executed command always appears after 'Repeat' and 'Undo'). Commands are also listed by name in the customize toolbar dialog and the scene explorer.

See Also

MenuItem Command Command.Enabled Command.ScriptingName MenuItem.Command ArgumentCollection.AddWithHandler siMenuAnchorPoints Definition Callbacks for Menus Simple Menu plug-in example