Unterteilte Schaltfläche

Die Geteilte Schaltfläche ist ein zusammengesetztes Steuerelement, mit dem der Benutzer einen Standardwert auswählen kann, der an eine primäre Schaltfläche gebunden ist, oder aus einer Liste sich gegenseitig ausschließenden Werten auswählen kann, die in einer Dropdownliste angezeigt werden, die an eine sekundäre Schaltfläche gebunden ist.

• Introduction (Einführung)
• Eigenschaften der geteilten Schaltfläche
• Zugehörige Themen

Einführung

Dieses Steuerelement ist nützlich, um eng verwandte Elemente verfügbar zu halten, wenn ein offensichtlicher Standardwert verfügbar ist und die einzelnen Elemente durch ein Bild, einen Text oder beides dargestellt werden können.

Der folgende Screenshot veranschaulicht die Schaltfläche "Menüband teilen".

Eigenschaften der geteilten Schaltfläche

Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Steuerelement Schaltfläche teilen.

In der Regel wird eine Split 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 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 Steuerelement Für geteilte Schaltflächen zugeordnet sind.

Eigenschaftenschlüssel	Hinweise
UI_PKEY_Enabled	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. Wenn alle untergeordneten Elemente deaktiviert sind, legt das Framework UI_PKEY_Enabled auf false (0) fest. Andernfalls wird, wenn mindestens ein untergeordnetes Element aktiviert ist, UI_PKEY_Enabled auf TRUE (-1) festgelegt. Wichtig: Die UI_PKEY_Enabled-Eigenschaft für das Steuerelement Schaltfläche teilen sollte ungültig werden, nachdem mindestens ein untergeordnetes Element aktiviert oder deaktiviert wurde. Dadurch wird sichergestellt, dass das Framework den aktualisierten Eigenschaftswert abfragt und den Zustand des Steuerelements geteilte Schaltfläche auf der Menübandbenutzeroberfläche aktualisiert.
UI_PKEY_Keytip	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.

Zugehörige Themen

Windows-Menüband-Framework-Steuerelementbibliothek

SplitButton-Markupelement