Schaltfläche "Teilen"
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ßender Werte auswählen kann, die in einer Dropdownliste angezeigt werden, die an eine sekundäre Schaltfläche gebunden ist.
Einleitung
Dieses Steuerelement ist nützlich, um eng verwandte Elemente in Fällen verfügbar zu stellen, in denen ein offensichtlicher Standardwert verfügbar ist und wo die einzelnen Elemente durch ein Bild, text oder beide dargestellt werden können.
Der folgende Screenshot veranschaulicht die Menüband-Schaltfläche "Teilen".
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 Split Button-Eigenschaft in der Menüband-Benutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Ungültigkeitsereignis wird behandelt, und die durch die 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 benötigt wird. Wenn beispielsweise eine Registerkarte aktiviert und ein Steuerelement in der Menüband-Benutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.
Anmerkung
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 eigenschaft UI_PKEY_Enabled für das Steuerelement "Geteilte Schaltfläche" 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 Status des Steuerelements "Geteilte Schaltfläche" in der Menüband-Benutzeroberfläche aktualisiert. |
| UI_PKEY_Keytip | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Ungültigheit aktualisiert werden. |