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.

Screenshot eines Splitbutton-Steuerelements in einem Beispielband.

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]
Die UI_PKEY_Enabled-Eigenschaft für das Split Button-Steuerelement sollte ungültig gemacht werden, nachdem mindestens ein untergeordnetes Objekt aktiviert oder deaktiviert wurde. Dadurch wird sichergestellt, dass das Framework den aktualisierten Eigenschaftswert abfragt und den Zustand des Split Button-Steuerelements in der Menübandbenutzeroberfläche aktualisiert.


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.

Windows Menüband-Framework-Steuerelementbibliothek

SplitButton-Markupelement