Katalog für geteilte Schaltflächen

Der Katalog für geteilte Schaltflächen ist ein zusammengesetztes Steuerelement, das eine primäre Schaltfläche enthält, die ein einzelnes Standardelement oder einen Befehl verfügbar macht, und eine sekundäre Schaltfläche, die beim Klicken den Rest des Elements oder der Command-Auflistung in einer sich gegenseitig ausschließenden Dropdownliste anzeigt.

• Details
• Eigenschaften des Katalogs für geteilte Schaltflächen
• Zugehörige Themen

Details

Dieses Steuerelement ist nützlich für das Verfügbarmachen eng verwandter Elemente in Fällen, in denen 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 den Katalog für geteilte Menübandschaltflächen in Microsoft Paint.

Eigenschaften des Katalogs für geteilte Schaltflächen

Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Steuerelement Split Button Gallery.

In der Regel wird eine Split Button Gallery-Eigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invaliditätsereignis 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 Split Button Gallery zugeordnet sind.

Eigenschaftenschlüssel	Hinweise
UI_PKEY_BooleanValue	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_Categories	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_ItemsSource	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_Label	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_LargeHighContrastImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_LargeImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_SelectedItem(nur gültig für einen Elementkatalog)	Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. Hinweis: Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommand ungültig wird, fragt das Framework diese Eigenschaft ab, wenn UI_INVALIDATIONS_VALUE als Wert von Flags übergeben wird.
UI_PKEY_SmallHighContrastImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_SmallImage	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_TooltipDescription	Kann nur durch ungültige Aktualisierung aktualisiert werden.
UI_PKEY_TooltipTitle	Kann nur durch ungültige Aktualisierung aktualisiert werden.

Zugehörige Themen

SplitButtonGallery-Markupelement

Arbeiten mit Galerien

Katalogbeispiel