Freigeben über

Schaltfläche "Drop-Down"

Die schaltfläche Drop-Down besteht aus einer Schaltfläche, auf die beim Klicken eine Dropdownliste mit sich gegenseitig ausschließenden Elementen angezeigt wird.

Details

Dieses Steuerelement ist nützlich für die Bereitstellung eng verwandter Elemente in Fällen, in denen keine offensichtliche Standardeinstellung verfügbar ist und wo die einzelnen Elemente durch ein Bild, text oder beide dargestellt werden können.

Der folgende Screenshot veranschaulicht das Menüband Drop-Down Schaltfläche in einem Beispielmenüband.

Screenshot eines Dropdownfeld-Steuerelements in einem Beispielmenüband.

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

In der Regel wird eine Drop-Down Button-Eigenschaft 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 Drop-Down Schaltflächen zugeordnet sind.

Eigenschaftsschlüssel Notizen
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 UI_PKEY_Enabled auf "true" (-1) festgelegt, wenn mindestens ein untergeordnetes Element aktiviert ist. Wichtig:
Die eigenschaft UI_PKEY_Enabled für das steuerelement Drop-Down Button 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 in der Menüband-Benutzeroberfläche aktualisiert.
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 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.

Windows Ribbon Framework-Steuerelementbibliothek

DropDownButton-Markupelement

  • Last updated on