Kontrollkästchen
Das Kontrollkästchen ist ein Steuerelement, auf das der Benutzer klicken kann, um eine Eingabe für eine Anwendung bereitzustellen. Das -Steuerelement stellt einen Umschaltzustand bereit, der visuell dargestellt wird.
Details
Das Kontrollkästchen unterstützt keinen bildungs- oder unbestimmten Zustand.
Der folgende Screenshot veranschaulicht das Menüband-Kontrollkästchen-Element.

Kontrollkästcheneigenschaften
Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Kontrollkästchen-Steuerelement.
In der Regel wird eine Check Box-Eigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invalidierungsereignis wird von der IUICommandHandler::UpdateProperty-Rückrufmethode behandelt und die Eigenschaft aktualisiert.
Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung fragt einen aktualisierten Eigenschaftswert ab, bis die Eigenschaft vom Framework benötigt wird. Beispielsweise, wenn eine Registerkarte aktiviert und ein Steuerelement auf der Menüband-Benutzeroberfläche angezeigt wird oder wenn eine QuickInfo angezeigt wird.
Hinweis
In einigen Fällen kann eine Eigenschaft über die IUIFramework::GetUICommandProperty-Methode abgerufen und mit der IUIFramework::SetUICommandProperty-Methode festgelegt werden.
In der folgenden Tabelle sind die Eigenschaftenschlüssel aufgeführt, die dem Kontrollkästchen-Steuerelement zugeordnet sind.
| Eigenschaftenschlüssel | Hinweise |
|---|---|
| UI_PKEY_BooleanValue | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.[!Note] |
| UI_PKEY_Enabled | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_Label | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_LabelDescription | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_LargeHighContrastImage | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_LargeImage | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_SmallHighContrastImage | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch Invalidierung aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Invalidierung aktualisiert werden. |