Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message adds one or more images to the list of button images available for a toolbar.

Syntax 

TB_ADDBITMAP 
wParam = (WPARAM) 
nButtons; 

lParam = (LPARAM)(LPTBADDBITMAP) 
lptbab;

Parameters

wParam

Not used.

nButtons

Number of button images in the bitmap. If lptbabspecifies a system-defined bitmap, this parameter is ignored.

lptbab

Long pointer to a TBADDBITMAPstructure that contains the identifier of a bitmap resource and the handle to the module instance with the executable file that contains the bitmap resource.

Return Value

The index of the first new image indicates success. –1 indicates failure.

Remarks

The bitmap specified in the lptbabparameter can contain multiple images. The number of images in the bitmap must be specified in the nButtonsparameter.

The bitmap width should be nButtonsmultiplied by the image width, and the bitmap height should be equal to the image height.

The default image width is 16 pixels and the default image height is 15 pixels. The default image width and height can be changed using TB_SETBITMAPSIZE. If the size of the bitmap is not the default or if you have multiple images in a bitmap, you must call TB_SETBITMAPSIZE to change the default size settings.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also