Share via

TB_SETBUTTONINFO

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The TB_SETBUTTONINFO message sets the information for an existing button.

On a Windows Mobile device, the TB_SETBUTTONINFO message 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 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.

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

    • fsState (TBSTATE_ENABLED and TBSTATE_HIDDEN only)
    • 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