AddCommandItem (Menu)
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.
Scripting Syntax
Menu.AddCommandItem( Label, Command )
C# Syntax
MenuItem Menu.AddCommandItem( String in_pLabel, Object in_cmd );Parameters
|
Parameter |
Type |
Description |
|
Label |
The menu item label. |
|
|
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. |
Return Value
The newly created MenuItem object.
See Also
|
|
|
|
Autodesk Softimage v7.5