| -api-id | -api-type |
|---|---|
T:Microsoft.UI.Xaml.Controls.DropDownButton |
winrt class |
Represents a button that includes a chevron to indicate a menu can be opened.
This documentation applies to WinUI 2 for UWP (for WinUI in the Windows App SDK, see the Windows App SDK namespaces).
The chevron is a visual indicator that a flyout is available with a menu of options. The DropDownButton has the same behavior as a standard Button with a flyout (only the appearance is different).
For more info and examples, see Buttons.
You can modify the default Style and ControlTemplate to give the control a unique appearance. For information about modifying a control's style and template, see XAML styles. XAML also includes resources that you can use to modify the colors of a control in different visual states without modifying the control template. Modifying these resources is preferred to setting properties such as Background and Foreground. For more info, see the Light-weight styling section of the XAML styles article.
The resources for this control are listed in the ThemeDictionaries section of the DropDownButton_themeresources.xaml file on GitHub. The ResourceKey value for each StaticResource references a brush and color in the Common_themeresources_any.xaml file.
Tip
For more info, design guidance, and code examples, see Buttons.
[!div class="nextstepaction"] Open the WinUI 2 Gallery app and see the DropDownButton in action.
The WinUI 2 Gallery app includes interactive examples of most WinUI 2 controls, features, and functionality. Get the app from the Microsoft Store or get the source code on GitHub.
<DropDownButton />