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

The TB_SETBUTTONINFOmessage sets the information for an existing button.

On a Windows Mobile device, the TB_SETBUTTONINFOmessage sets the information for an existing button on a soft key bar. The information can include the ID, text, and state of the button.

Note:
Beginning with Windows Mobile 6.5.3, soft keys are replaced by touchable tiles on Windows Mobile Professional phones.

Syntax 

TB_SETBUTTONINFO

wParam = (WPARAM) (int) 
iID;

lParam = (LPARAM) (LPTBBUTTONINFO) 
lptbbi;

Parameters

iID

Button identifier.

lptbbi

Long pointer to a TBBUTTONINFOstructure that contains the new button information. The cbSizeand dwMaskmembers of this structure must be filled in prior to sending this message.

Windows Mobile Standard supports setting the following information in the Windows Embedded CE TBBUTTONINFOstructure:

  • fsState( TBSTATE_ENABLEDand TBSTATE_HIDDENonly)

  • idCommand

  • pszText

Return Value

Nonzero indicates success. Zero indicates otherwise.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

TBBUTTONINFO