Freigeben über


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 befehl verfügbar macht, und eine sekundäre Schaltfläche, die beim Klicken auf das restliche Element oder die Befehlsauflistung in einer sich gegenseitig ausschließenden Dropdownliste angezeigt wird.

Details

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 den Menübandkatalog für geteilte Schaltflächen in Microsoft Paint.

Screenshot eines Splitbuttongallery-Steuerelements im Microsoft Paint-Menüband.

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

In der Regel wird eine Eigenschaft des Geteilten Schaltflächenkatalogs 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ächenkatalog" zugeordnet sind.

Eigenschaftsschlüssel Notizen
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ültigheit aktualisiert werden.
UI_PKEY_Label Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Ungültigheit 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::InvalidateUICommandungü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ültigheit aktualisiert werden.
UI_PKEY_SmallImage 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.

SplitButtonGallery-Markupelement

Arbeiten mit Katalogen

Katalogbeispiel