Drop-Down-Schaltfläche

Die Drop-Down-Schaltfläche 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 in Fällen verfügbar zu machen, in denen kein offensichtlicher Standardwert verfügbar ist und die einzelnen Elemente durch ein Bild, Text oder beides dargestellt werden können.

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

Screenshot eines Dropdownbutton-Steuerelements in einem Beispielband.

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übandbenutzeroberfläche aktualisiert, indem der befehl, der dem Steuerelement zugeordnet ist, 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übandbenutzeroberflä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 Eigenschaftsschlüssel aufgeführt, die dem Steuerelement schaltflächenDrop-Down zugeordnet sind.

Eigenschaftsschlü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 false (0) fest. Wenn ein oder mehrere untergeordnete Elemente aktiviert sind, wird andernfalls UI_PKEY_Enabled auf true (-1) festgelegt.
[!Important]
Die UI_PKEY_Enabled-Eigenschaft für das schaltflächenDrop-Down-Steuerelement sollte ungültig gemacht werden, nachdem ein oder mehrere untergeordnete Elemente aktiviert oder deaktiviert wurden. Dadurch wird sichergestellt, dass das Framework den aktualisierten Eigenschaftswert abfragt und den Zustand des Steuerelements Drop-Down Schaltfläche auf der Menübandbenutzeroberfläche aktualisiert.


UI_PKEY_ItemsSource Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_Label Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_SelectedItem Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
[!Note]
Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommandungültig gemacht wird, fragt das Framework diese Eigenschaft ab, wenn als Wert von flags übergeben UI_INVALIDATIONS_VALUE wird.

UI_PKEY_SmallHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_SmallImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Ungültigkeit aktualisiert werden.

Windows Menüband-Framework-Steuerelementbibliothek

DropDownButton-Markupelement