IToolbar::AddBitmap

[This is preliminary documentation and subject to change.]

Allows a snap-in to add an image to the toolbar.

HRESULT AddBitmap(
  int nImages,     // Index of bitmaps images
  HBITMAP hbmp,    // Handle to the bitmap
  int cxSize,      // Height of the bitmap
  int cySize,      // Width of the bitmap
  COLORREF crMask  // Specifies color to generate a mask
);
 

Parameters

nImages

[in] Index of images available. Specifies the number of images in the bitmap being passed in hbmp.

hbmp

[in] Handle of the bitmap to be added to the toolbar.

cxSize

[in] Height of the bitmap to be added, in pixels. (In beta 1 we only support a cxSize of 16).

cySize

[in] Width of the bitmap to be added, in pixels. (In beta 1 we only support a cySize of 16).

crMask

[in] Color used to generate a mask to overlay the images on the toolbar buttons.

Return Values

S_OK

The toolbar was added successfully.

See Also

IToolbar