MMCBUTTON

[This is preliminary documentation and subject to change.]

The MMCBUTTON structure contains values used to create buttons on a toolbar. This structure is similar to the TBBUTTON structure discussed in the Platform SDK topics related to common controls.

typedef struct _MMCBUTTON
{
    int      nBitmap ; 
    int      idCommand;
    BYTE     fsState;
    BYTE     fsType;
        LPOLESTR     lpButtonText;
    LPOLESTR     lpTooltipText;
} MMCBUTTON;
typedef MMCBUTTON* LPMMCBUTTON;

Members

nBitmap

Specifies the zero-based index of a button image.

idCommand

Specifies the command identifier returned when a button is clicked. This can be any integer value the user wants.

fsState

Specifies the button-state flags. This member can be any of the following values:

Value	Meaning
TBSTATE_CHECKED	The button has the TBSTYLE_CHECKED style and is being pressed.
TBSTATE_ENABLED	The button accepts user input. A button that does not have this state does not accept user input and is grayed.
TBSTATE_HIDDEN	The button is not visible and cannot receive user input.
TBSTATE_INDETERMINATE	The button is grayed.
TBSTATE_PRESSED	The button is being pressed.
TBSTATE_WRAP	A line break follows the button. The button must also have the TBSTATE_ENABLED.

fsType

Specifies the button style. This member can be a combination of the following values:

Value	Meaning
TBSTYLE_BUTTON	Creates a standard push button.
TBSTYLE_CHECK	Creates a button that toggles between the pressed and not-pressed states each time the user clicks it. The button has a different background color when it is in the pressed state.
TBSTYLE_CHECKGROUP	Creates a check button that stays pressed until another button in the group is pressed.
TBSTYLE_GROUP	Creates a button that stays pressed until another button in the group is pressed.
TBSTYLE_SEP	Creates a separator, providing a small gap between button groups. A button that has this style does not receive user input.

lpButtonText

Pointer to the text associated with a particular instance of the MMCBUTTON structure.

lpTooltipText

Pointer to the text for a particular tooltip.

See Also

IToolbar