Function AddMenuItem4( _
   ByVal DocumentType As System.Integer, _
   ByVal Cookie As System.Integer, _
   ByVal MenuItem As System.String, _
   ByVal Position As System.Integer, _
   ByVal MenuCallback As System.String, _
   ByVal MenuEnableMethod As System.String, _
   ByVal HintString As System.String, _
   ByVal BitmapFilePath As System.String _
) As System.Integer

Dim instance As ISldWorks
Dim DocumentType As System.Integer
Dim Cookie As System.Integer
Dim MenuItem As System.String
Dim Position As System.Integer
Dim MenuCallback As System.String
Dim MenuEnableMethod As System.String
Dim HintString As System.String
Dim BitmapFilePath As System.String
Dim value As System.Integer
 
value = instance.AddMenuItem4(DocumentType, Cookie, MenuItem, Position, MenuCallback, MenuEnableMethod, HintString, BitmapFilePath)

System.int AddMenuItem4( 
   System.int DocumentType,
   System.int Cookie,
   System.string MenuItem,
   System.int Position,
   System.string MenuCallback,
   System.string MenuEnableMethod,
   System.string HintString,
   System.string BitmapFilePath
)

System.int AddMenuItem4( 
&   System.int DocumentType,
&   System.int Cookie,
&   System.String^ MenuItem,
&   System.int Position,
&   System.String^ MenuCallback,
&   System.String^ MenuEnableMethod,
&   System.String^ HintString,
&   System.String^ BitmapFilePath
) 

Parameters

DocumentType

Document type to add the menu item as defined by swDocumentTypes_e

Cookie

Cookie as defined in ISwAddin::ConnectToSW

MenuItem

Menu string ("menuItem@menuString"); SOLIDWORKS creates menu items only if they do not already exist

NOTES:  

• If you do not specify menuString, then the menu item appears on the Tools menu below the Xpress Products menu item.
• Use the & symbol to include an accelerator key, e.g., "MyItem@&File" adds MyItem to the File menu with an accelerator key. To display the accelerator key, press the Alt key. The accelerator key is underlined.

Position

Position where to add the new menu item; the first item is at position 0; if -1 is specified for Position, then the new menu item is added to the bottom of the list; this argument specifies the position of the menu item in relation to its immediate parent menu.

MenuCallback

Function to call when this menu item is selected (see Remarks)

MenuEnableMethod

Optional function that controls the state of the menu item (See Remarks)

If specified:

• SOLIDWORKS calls this function before displaying the menu.

• Display of the menu item is controlled by the return value of MenuEnableMethod.

If MenuEnableMethod returns...	Then SOLIDWORKS...
0	Deselects and disables the menu item
1	Deselects and enables the menu item; this is the default menu state if no update function is specified
2	Selects and disables the menu item
3	Selects and enables the menu item

HintString

Text to show in the SOLIDWORKS status bar when the user moves the pointer over this menu item; if you specify HintString, then it must be preceded by a comma

BitmapFilePath

Path and filename of bitmap

Return Value

See Add-in Callback and Enable Methods to learn how to specify MenuCallback and MenuEnableMethod.

For information about using this method with the ISwAddin object, see Using ISwAddin to Create a SOLIDWORKS Add-in.

The bitmap must be 16w x 16h x 256 colors.

You can add a new menu item to any one of the four SOLIDWORKS frames (main, part, assembly, or drawing). To do this, call this method with the appropriate argument in the DocumentType parameter. For example, if you want your menu item to be available when a part document is active, then call this method and pass swDocPART as the first argument. After you have added your menu item to the part frame, you do not need to do it again during the current SOLIDWORKS session. Once a part document is activated by the user, SOLIDWORKS automatically displays your menu item.

To add a menu separator:

• leave the text for the menu item blank, so that the menu string for the MenuItem argument starts with the at-sign symbol ( @):
  
  "@subMenuString@menuString"

• specify an existing method for the MenuCallback argument. This method is never called, so its implementation can be empty.

• specify empty strings for the MenuEnableMethod, HintString, and bitmapFilePath arguments.

Read about Add-in Shortcut Menus.