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.

Screenshot eines Kontrollkästchen-Steuerelements im Microsoft Paint-Menüband.

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]
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 der Flagsübergeben wird.

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.

Windows Menüband-Framework-Steuerelementbibliothek

CheckBox-Markupelement