Unterteilte Schaltfläche
Die Schaltfläche Teilen 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 von sich gegenseitig ausschließenden Werten auswählen kann, die in einer Dropdownliste angezeigt werden, die an eine sekundäre Schaltfläche gebunden ist.
Einführung
Dieses Steuerelement ist nützlich, um eng verwandte Elemente in Fällen verfügbar zu machen, in denen ein offensichtlicher Standardwert verfügbar ist und die einzelnen Elemente durch ein Bild, Text oder beides dargestellt werden können.
Der folgende Screenshot veranschaulicht die Schaltfläche zum Teilen des Menübands.

Eigenschaften der geteilten Schaltfläche
Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Split Button-Steuerelement.
In der Regel wird eine Split Button-Eigenschaft in der Menübandbenutzeroberfläche aktualisiert, indem der befehl, der dem Steuerelement zugeordnet ist, 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übandbenutzeroberflä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 Schaltfläche teilen zugeordnet sind.
| Eigenschaftsschlüssel | Hinweise |
|---|---|
| UI_PKEY_Enabled | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. Wenn alle untergeordneten Elemente deaktiviert sind, legt das Framework UI_PKEY_Enabled false (0) fest. Wenn ein oder mehrere untergeordnete Elemente aktiviert sind, wird andernfalls UI_PKEY_Enabled auf true (-1) festgelegt. [!Important] |
| UI_PKEY_Keytip | 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. |