IToolbar::SetButtonState method (mmc.h)
The IToolbar::SetButtonState method enables a snap-in to set an attribute of a button.
Syntax
HRESULT SetButtonState(
[in] int idCommand,
[in] MMC_BUTTON_STATE nState,
[in] BOOL bState
);
Parameters
[in] idCommand
A unique value that the snap-in has associated with a button using the InsertButton or AddButtons method using the MMCBUTTON structure.
[in] nState
A value that specifies the state to be set for the button. Can be any one of the following:
ENABLED
The button accepts user input. A button that does not have this state does not accept user input and appears dimmed.
CHECKED
The button has the CHECKED style and is being pressed.
HIDDEN
The button is not visible and cannot receive user input.
INDETERMINATE
The button appears dimmed.
BUTTONPRESSED
The button is being pressed.
[in] bState
A value that specifies whether the state identified in nState is set to TRUE or FALSE. TRUE sets the button state to the state identified by nState and FALSE clears the state (if it is already set).
Return value
This method can return one of these values.
Remarks
Snap-ins should not set button states until the toolbar has been attached using IControlbar::Attach.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |