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 tertiären oder unbestimmten Zustand.
Der folgende Screenshot veranschaulicht das Menüband-Kontrollkästchen-Element.
Eigenschaften des Kontrollkästchens
Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Kontrollkästchen-Steuerelement.
In der Regel wird eine Kontrollkästcheneigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invalidation-Ereignis wird von der IUICommandHandler::UpdateProperty-Rückrufmethode behandelt und die Eigenschaft aktualisiert.
Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung wird nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework erforderlich ist. Beispielsweise, wenn eine Registerkarte aktiviert ist 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.
Hinweis: Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommand ungültig wird, fragt das Framework diese Eigenschaft ab, wenn UI_INVALIDATIONS_VALUE als Wert von Flags übergeben wird. |
| UI_PKEY_Enabled | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_Label | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_LabelDescription | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_LargeHighContrastImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_LargeImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_SmallHighContrastImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Ungültige aktualisiert werden. |