Sub AddToolbarImage( _
   ByVal lHandleOrResourceID As System.Integer, _
   ByVal lButtonCount As System.Integer, _
   ByVal eState As EdmButtonState, _
   Optional ByVal bIsIcon As System.Boolean, _
   Optional ByVal bIsHandle As System.Boolean, _
   Optional ByVal lBackgroundColorRGB As System.Integer, _
   Optional ByVal lImageID As System.Integer _
) 

void AddToolbarImage( 
   System.int lHandleOrResourceID,
   System.int lButtonCount,
   EdmButtonState eState,
   System.bool bIsIcon,
   System.bool bIsHandle,
   System.int lBackgroundColorRGB,
   System.int lImageID
)

void AddToolbarImage( 
&   System.int lHandleOrResourceID,
&   System.int lButtonCount,
&   EdmButtonState eState,
&   System.bool bIsIcon,
&   System.bool bIsHandle,
&   System.int lBackgroundColorRGB,
&   System.int lImageID
) 

Parameters

lHandleOrResourceID

Resource ID if bIsHandle = false; handle to a bitmap (bIsIcon = false) or icon (bIsIcon = true) if bIsHandle = true

lButtonCount

Number of buttons in the bitmap or icon

eState

State of the toolbar button (see Remarks)

bIsIcon

True if the image is an icon; false if it is a bitmap (see Remarks)

bIsHandle

True if lHandleOrResourceID is a handle, false if it is a resource ID

lBackgroundColorRGB

RGB value of the background color (see Remarks)

lImageID

ID of the image (see Remarks)

For a more complete description of how to use this method, see Creating a menu command.

The following snippet creates a toolbar button and adds a command in the Windows Explorer Tools menu. The button uses one icon (resource ID=101) for the cold (standard) state and another one (resource ID=102) for the hot (focus) state. Both icon files must be added using Visual Basic's resource editor before running this snippet:

Private Sub IEdmAddIn5_GetAddInInfo(poInfo As EdmLib.EdmAddInInfo, ByVal poVault As EdmLib.IEdmVault5, ByVal poCmdMgr As EdmLib.IEdmCmdMgr5)

...
poCmdMgr.AddToolbarImage 101, 1, BState_Cold, True, False, 12632256, 1
poCmdMgr.AddToolbarImage 102, 1, BState_Hot, True, False, 12632256, 1
poCmdMgr.AddCmd 1, "My Command", EdmMenu_NeverInContextMenu Or EdmMenu_HasToolbarButton, "String to show in the statusbar", "Tooltip on my command", 0, 1

End Sub

Call this method from your add-in's implementation of IEdmAddIn5::GetAddInInfo to create a toolbar button.

Images can be either bitmaps (*.BMP) or icons (*.ICO). A bitmap contains one or more buttons of the same size. An icon contains only one button.

Unlike icons, bitmaps do not contain transparent regions. In order to get transparency in bitmaps, specify in lBackgroundColorRGB the RGB color of the bitmap that should be replaced by the background color.

When you add "hot" buttons (eState = EdmButtonState.BState_Hot), they must be assigned the same image ID as the corresponding "cold" buttons (eState = EdmButtonState.BState_Cold). Additionally, if the images contain several toolbar buttons, the buttons must be ordered the same way in both images.

Toolbar buttons in Windows Explorer can have several different sizes depending on the operating system version, Internet Explorer version, and user preferences. To make the image compatible, use this method to add several versions of an image using the same image ID but with different image sizes. SOLIDWORKS PDM Professional chooses the image that best matches the system settings. If the image doesn't exactly match the button size, PDM either resizes it (if the button is smaller than the image) or centers it in the button (if the button is bigger than the image).

After calling this method to create a toolbar button, call IEdmCmdMgr5::AddCmd setting lToolbarImageID to this method's lImageID.

Return codes:

• S_OK: The method successfully executed.
• S_FALSE: One of the arguments is invalid.