Drop-Down Katalog
Der Drop-Down Katalog besteht aus einer Schaltfläche, die beim Klicken eine Dropdownliste mit einer Sammlung sich gegenseitig ausschließenden Elementen oder Befehlen anzeigt.
Details
Dieses Steuerelement eignet sich zum Verfügbarmachen verwandter Elemente oder Befehle, bei denen kein offensichtlicher Standardwert vorhanden ist, und die einzelnen Elemente können durch ein Bild, einen Text oder beides dargestellt werden.
Unterstützung für vertikale und eckige Greifstangen oder das Ändern der Größe von Griffen wird über das DropDownGallery.MenuLayout-Element bereitgestellt.
Der folgende Screenshot veranschaulicht das Menüband Drop-Down Katalog in Microsoft Paint.
Drop-Down-Katalogeigenschaften
Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Drop-Down Katalogsteuerelements.
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 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 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 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. |