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_GETBUTTONINFOmessage retrieves information for a button.

On Windows Mobile devices, the TB_GETBUTTONINFOmessage retrieves information for a button on a soft key bar. The information can include the ID, text, and state of the button, as well as the handle of the pop-up menu associated with the button.

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

Syntax 

TB_GETBUTTONINFO

wParam = (WPARAM) (int) 
iID;

lParam = (LPARAM) (LPTBBUTTONINFO) 
lptbbi;

Parameters

iID

Button identifier.

lptbbi

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

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

  • fsState

  • idCommand

  • lParam

  • pszText

Return Value

Returns true if the message succeeds, or false if an error occurs.

Requirements

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