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 der sich gegenseitig ausschließenden Werte, die in einer Dropdownliste angezeigt werden, die an eine sekundäre Schaltfläche gebunden ist.

Einführung

Dieses Steuerelement ist nützlich für die Darstellung eng verwandter Elemente in Fällen, in denen eine offensichtliche Standardeinstellung verfügbar ist und wo die einzelnen Elemente durch ein Bild, einen Text oder beides dargestellt werden können.

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

screen shot of a splitbutton control in a sample ribbon.

Eigenschaften der geteilten Schaltfläche

Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Steuerelement "Geteilte Schaltfläche".

In der Regel wird eine Eigenschaft "Geteilte Schaltfläche" auf der Menüband-Benutzeroberfläche aktualisiert, indem der Befehl, der dem Steuerelement zugeordnet ist, durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Ungültigkeitsereignis wird behandelt, und die von der 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 erforderlich ist. Wenn beispielsweise eine Registerkarte aktiviert ist und ein Steuerelement in 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 "Geteilte Schaltfläche" zugeordnet sind.

Eigenschaftsschlüssel Notizen
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 UI_PKEY_Enabled auf true (-1) festgelegt, wenn mindestens ein untergeordnetes Element aktiviert ist.
[! Wichtig]
Die UI_PKEY_Enabled-Eigenschaft für das Steuerelement "Geteilte Schaltfläche" sollte ungültig sein, nachdem mindestens ein untergeordnetes Element aktiviert oder deaktiviert wurde. Dadurch wird sichergestellt, dass das Framework den aktualisierten Eigenschaftswert abfragt und den Status des Steuerelements "Geteilte Schaltfläche" auf der Menüband-Benutzeroberfläche aktualisiert.


UI_PKEY_Keytip Kann nur über ungültige Aktualisierungen aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur über ungültige Aktualisierungen aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur über ungültige Aktualisierungen aktualisiert werden.

Windows Menüband-Framework-Steuerelementbibliothek

SplitButton-Markupelement