Drop-Down-Katalog

Der Drop-Down-Katalog besteht aus einer Schaltfläche, mit der beim Klicken eine Dropdownliste mit einer Sammlung von sich gegenseitig ausschließenden Elementen oder Befehlen angezeigt wird.

Details

Dieses Steuerelement ist nützlich, um verwandte Elemente oder Befehle verfügbar zu machen, bei denen es keinen offensichtlichen Standardwert gibt und die einzelnen Elemente durch ein Bild, text oder beides dargestellt werden können.

Unterstützung für vertikale und eckige Ziehpunkte oder Ziehpunkte zur Größenänderung wird über das Element DropDownGallery.MenuLayout bereitgestellt.

Der folgende Screenshot veranschaulicht das Menüband Drop-Down Gallery in Microsoft Paint.

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

Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Drop-Down Gallery-Steuerelement.

In der Regel wird eine Drop-Down 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 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ü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 Drop-Down Gallery-Steuerelement zugeordnet sind.

Eigenschaftenschlüssel Hinweise
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 Invalidierung aktualisiert werden.
UI_PKEY_Label Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_SelectedItem(nur für einen Elementkatalog gültig)
Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
[!Note]
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 der Flagsübergeben wird.

UI_PKEY_SmallHighContrastImage Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_SmallImage Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur durch Invalidierung aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Invalidierung aktualisiert werden.

Windows Menüband-Framework-Steuerelementbibliothek

DropDownGallery-Markupelement

Arbeiten mit Katalogen

Katalogbeispiel