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.v20.1.dll


public override BarButtonStyle ButtonStyle { get; set; }
Public Overrides Property ButtonStyle As BarButtonStyle

Property Value

Type Description

A BarButtonStyle value that determines how this item functions.


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.

XtraBars - CheckDropDown Button Style

See Also