TB_CHANGEBITMAP message

Changes the bitmap for a button in a toolbar.

Parameters

wParam

Command identifier of the button that is to receive a new bitmap.

lParam

Zero-based index of an image in the toolbar's image list. The system displays the specified image in the button. Set this parameter to I_IMAGECALLBACK, and the toolbar will send the TBN_GETDISPINFO notification to retrieve the image index when it is needed.

Version 5.81. Set this parameter to I_IMAGENONE to indicate that the button does not have an image. The button layout will not include any space for a bitmap, only text.

Return value

Returns TRUE if successful, or FALSE otherwise.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Commctrl.h