CommandBar_AddBitmap (Compact 2013)

3/28/2014

This function adds one or more images to the list of button images available for use in the command bar.

Syntax

int CommandBar_AddBitmap(
  HWND hwndCB, 
  HINSTANCE hInst, 
  int idBitmap, 
  int iNumImages, 
  int iImageWidth, 
  int iImageHeight
); 

Parameters

• hwndCB
  Handle to the command bar's window. This handle is returned by the CommandBar_Create function when the command bar is created.

• hInst
  Handle to an instance of the executable module that contains the bitmap resource.

• idBitmap
  Identifier of the bitmap resource that contains the button images. If you specify HINST_COMMCTRL in the hInst parameter, you can use system-defined button bitmaps by specifying one of the following values.

  Value	Description
  IDB_STD_SMALL_COLOR	Adds small, color standard bitmaps.
  IDB_VIEW_SMALL_COLOR	Adds small, color view bitmaps.

• iNumImages
  Integer that specifies the number of button images in the bitmap. This can be zero if the bitmap being added is one of the system defined bitmaps - standard or view.

• iImageWidth
  Reserved, set this value to zero.

• iImageHeight
  Reserved, set this value to zero.

Return Value

The index of the first new image indicates success. A value of -1 indicates failure.

Remarks

Each button image should be 16x16 pixels in size.

The following values can be used as indexes to the standard and view bitmaps:

Requirements

See Also

Reference

Command Bars Functions
CommandBar_Create