This message loads bitmaps into a toolbar control’s image list.
At a Glance
| Header file: | Commctrl.h |
| Windows CE versions: | 2.0 and later |
Syntax
Parameters
iBitmapID
Identifier of a bitmap that contains the images to be loaded. If hinst is HINST_COMMCTRL, this parameter specifies a set of standard toolbar button bitmaps, shown in the following list. Otherwise, this parameter must be the identifier of a bitmap resource that will be added to the image list as a single image.
| Value | Description |
| IDB_STD_LARGE_COLOR | Standard bitmaps in large size |
| IDB_STD_SMALL_COLOR | Standard bitmaps in small size |
| IDB_VIEW_LARGE_COLOR | View bitmaps in large size |
| IDB_VIEW_SMALL_COLOR | View bitmaps in small size |
hinst
Program instance handle to the calling application. This parameter can be HINST_COMMCTRL to load a standard image list.
Return Values
Returns an INT value that represents the count of images in the image list, not including the one just added. Returns zero if the toolbar has no image list or if the existing image list is empty.
Remarks
If your application specifies HINST_COMMCTRL, then you must use the proper image index values when you prepare TBBUTTON structures prior to sending the TB_ADDBUTTONS message. For a list of image index values for these preset bitmaps, see “Toolbar Standard Button Image Index Values.”
Windows CE does not support IDB_HIST_LARGE_COLOR and IDB_HIST_SMALL_COLOR values for the iBitmapID parameter.