TB_GETBUTTONINFO

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The TB_GETBUTTONINFO message retrieves information for a button.

On Windows Mobile devices, the TB_GETBUTTONINFO message 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 TBBUTTONINFO structure that receives the button information. The cbSize and dwMask members 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 TBBUTTONINFO structure:

    • 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