TB_SETBUTTONINFO message

Sets the information for an existing button in a toolbar.

Parameters

wParam

Button identifier.

lParam

Pointer to a TBBUTTONINFO structure that contains the new button information. The cbSize and dwMask members of this structure must be filled in prior to sending this message.

Return value

Returns nonzero if successful, or zero otherwise.

Remarks

Text is commonly assigned to buttons when they are added to a toolbar by specifying the index of a string in the toolbar's string pool. If you use a TB_SETBUTTONINFO to assign new text to a button, it will permanently override the text from the string pool. You can change the text by calling TB_SETBUTTONINFO again, but you cannot reassign the string from the string pool.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
TB_SETBUTTONINFOW (Unicode) and TB_SETBUTTONINFOA (ANSI)

See also

Reference

TB_ADDBUTTONS

TB_GETBUTTONINFO

TB_GETBUTTONTEXT

TB_GETSTRING

TB_INSERTBUTTON