Share via

TB_ADDBITMAP

  • Article

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

TB_ADDBITMAP wParam = (
WPARAM) nButtons; 
lParam = (LPARAM)(LPTBADDBITMAP) lptbab;

Parameters

  • nButtons
    Number of button images in the bitmap. If lptbab specifies a system-defined bitmap, this parameter is ignored.
  • lptbab
    Long pointer to a TBADDBITMAP structure 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 Values

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

Remarks

The bitmap specified in the lptbab parameter can contain multiple images. The number of images in the bitmap must be specified in the nButtons parameter.

The bitmap width should be nButtons multiplied 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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreateWindowEx, TBADDBITMAP, TB_BUTTONSTRUCTSIZE, TB_SETBITMAPSIZE

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.