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.

Einführung

Der folgende Screenshot enthält drei Beispiele für das Menüband-Schaltflächenelement.

Screenshot der Schaltflächensteuerelemente im Microsoft Wordpad-Menüband.

Schaltflächeneigenschaften

Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Schaltflächen-Steuerelement.

In der Regel wird eine Button-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 Button-Steuerelement zugeordnet sind.

Eigenschaftenschlüssel Hinweise
_Benutzeroberflächen-PKEY _ aktiviert Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
_PKEY-Keytip der Benutzeroberfläche _ Kann nur durch Ungültigkeit aktualisiert werden.
_ _ UI-PKEY-Bezeichnung Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ LabelDescription Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ LargeHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ LargeImage Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ SmallHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ SmallImage Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ TooltipDescription Kann nur durch Ungültigkeit aktualisiert werden.
UI _ PKEY _ TooltipTitle Kann nur durch Ungültigkeit aktualisiert werden.

Windows Menüband-Framework-Steuerelementbibliothek

Markupelement für Schaltflächen