Schaltfläche "Drop-Down"
Die schaltfläche Drop-Down besteht aus einer Schaltfläche, die beim Klicken eine Dropdownliste mit sich gegenseitig ausschließenden Elementen anzeigt.
Details
Dieses Steuerelement ist nützlich, um eng verwandte Elemente verfügbar zu halten, wenn keine offensichtliche Standardeinstellung verfügbar ist und die einzelnen Elemente durch ein Bild, einen Text oder beides dargestellt werden können.
Der folgende Screenshot veranschaulicht die Schaltfläche "Menüband Drop-Down" in einem Beispielmenüband.
Eigenschaften der Drop-Down-Schaltfläche
Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Drop-Down Button-Steuerelement.
In der Regel wird eine Drop-Down Button-Eigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invalidation-Ereignis 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 Button-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. Wenn alle untergeordneten Elemente deaktiviert sind, legt das Framework UI_PKEY_Enabled auf false (0) fest. Andernfalls wird, wenn mindestens ein untergeordnetes Element aktiviert ist, UI_PKEY_Enabled auf TRUE (-1) festgelegt. Wichtig: Die UI_PKEY_Enabled-Eigenschaft für das Drop-Down Button-Steuerelement sollte ungültig werden, nachdem mindestens ein untergeordnetes Element aktiviert oder deaktiviert wurde. Dadurch wird sichergestellt, dass das Framework den aktualisierten Eigenschaftswert abfragt und den Status des Drop-Down Button-Steuerelements auf der Menübandbenutzeroberfläche aktualisiert. |
| UI_PKEY_ItemsSource | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_Label | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_LargeHighContrastImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_LargeImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_SelectedItem | 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 aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch Ungültige aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Ungültige aktualisiert werden. |