IToolbar::SetButtonState-Methode (mmc.h)
Die IToolbar::SetButtonState-Methode ermöglicht es einem Snap-In, ein Attribut einer Schaltfläche festzulegen.
Syntax
HRESULT SetButtonState(
[in] int idCommand,
[in] MMC_BUTTON_STATE nState,
[in] BOOL bState
);
Parameter
[in] idCommand
Ein eindeutiger Wert, den das Snap-In mithilfe der InsertButton- oder AddButtons-Methode mithilfe der MMCBUTTON-Struktur einer Schaltfläche zugeordnet hat.
[in] nState
Ein -Wert, der den für die Schaltfläche festzulegenden Zustand angibt. Dies kann eine der folgenden Optionen sein:
ENABLED
Die Schaltfläche akzeptiert Benutzereingaben. Eine Schaltfläche, die diesen Zustand nicht aufweist, akzeptiert keine Benutzereingaben und wird abgeblendet angezeigt.
AKTIVIERT
Die Schaltfläche hat das Format CHECKED und wird gedrückt.
HIDDEN
Die Schaltfläche ist nicht sichtbar und kann keine Benutzereingaben empfangen.
UNBESTIMMTEN
Die Schaltfläche wird abgeblendet angezeigt.
BUTTONPRESSED
Die Schaltfläche wird gedrückt.
[in] bState
Ein -Wert, der angibt, ob der in nState identifizierte Zustand auf TRUE oder FALSE festgelegt ist. TRUE legt den Schaltflächenzustand auf den durch nState identifizierten Zustand fest, und FALSE löscht den Zustand (sofern er bereits festgelegt ist).
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Hinweise
Snap-Ins sollten keine Schaltflächenzustände festlegen, bis die Symbolleiste mithilfe von IControlbar::Attach angefügt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | mmc.h |
| DLL | Mmcndmgr.dll |