Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Kontrollkästchen ist ein Steuerelement, auf das der Benutzer klicken kann, um einer Anwendung Eingaben 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ästchen-Eigenschaft auf der Menüband-Benutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Ungültigkeitsereignis wird behandelt, und die durch die IUICommandHandler::UpdateProperty Rückrufmethode definierten Eigenschaftenaktualisierungen.
Die IUICommandHandler::UpdateProperty- Rückrufmethode wird nicht ausgeführt, und die Anwendung wird nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework benötigt wird. Wenn beispielsweise eine Registerkarte aktiviert und ein Steuerelement in der Menüband-Benutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.
Anmerkung
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.
| Eigenschaftsschlüssel | Notizen |
|---|---|
| UI_PKEY_BooleanValue | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
Hinweis: Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommandungü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ültigheit aktualisiert werden. |
| UI_PKEY_Label | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_LabelDescription | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_LargeHighContrastImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_LargeImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_SmallHighContrastImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Ungültigheit aktualisiert werden. |