BarButtonItem.ButtonStyle Property
Get or sets the button item’s style which determines how the current bar button item functions.
Namespace: DevExpress.XtraBars
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
#Declaration
[Browsable(true)]
public override BarButtonStyle ButtonStyle { get; set; }
#Property Value
Type | Description |
---|---|
Bar |
A Bar |
Available values:
Name | Description |
---|---|
Default | Applies the Default style to the Bar |
Drop |
Applies the Drop |
Check | Applies the Check style to the Bar |
Check |
Combines Check and Drop |
#Remarks
By default, the ButtonStyle property is set to BarButtonStyle.Default and the item links act like regular push buttons.
Set this property to BarButtonStyle.Check to make the item links act as check items (buttons which have normal (elevated) and pressed states).
For BarButtonItem objects and their descendants, the ButtonStyle can be set to BarButtonStyle.DropDown. In this mode, you can implement a dropdown functionality for the BarButtonItem. Assign a control or menu to the BarButtonItem.DropDownControl property, and this will be displayed as a dropdown when the button (or its dropdown arrow) is clicked. The following image shows a custom dropdown control displayed for a Zoom button:
See the BarButtonItem.DropDownControl topic, to learn which controls can be used as dropdowns.
When the ButtonStyle property is set to DropDown, a corresponding button displays a dropdown arrow. Clicking it invokes the associated dropdown control. However, by default, clicking the button itself doesn’t open the dropdown, but only fires the BarItem.ItemClick event. To hide the dropdown arrow and invoke the dropdown control when the button is clicked, set the BarButtonItem.ActAsDropDown property to true.
The CheckDropDown style combines both Check and DropDown styles, giving a drop-down control to the bar button item and allowing it to support checked/unchecked states.