Schaltfläche (Windows-Menübandframework)

Die Schaltfläche ist ein Steuerelement, auf das der Benutzer klicken kann, um eine Eingabe für eine Anwendung bereitzustellen.

• Introduction (Einführung)
• Schaltflächeneigenschaften
• Zugehörige Themen

Einführung

Der folgende Screenshot enthält drei Beispiele für das Menübandschaltfläche-Element.

Schaltflächeneigenschaften

Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Button-Steuerelement.

In der Regel wird eine Button-Eigenschaft in der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invaliditätsereignis 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 Button-Steuerelement zugeordnet sind.

Eigenschaftenschlüssel	Hinweise
UI_PKEY_Enabled	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_Label	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_LabelDescription	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_LargeHighContrastImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_LargeImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_SmallHighContrastImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_SmallImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_TooltipDescription	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_TooltipTitle	Kann nur durch ungültige Aktualisierung aktualisiert werden.

 

Zugehörige Themen

Windows Ribbon Framework-Steuerelementbibliothek

Schaltflächenmarkierungselement