Skip to main content
A newer version of this page is available. .
Bar

BarButtonStyle Enum

Specifies the BarButtonItem control style.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

public enum BarButtonStyle

Members

Name Description
Default

Applies the Default style to the BarButtonItem component. The default style means that the link represents a regular push button.

DropDown

Applies the DropDown style to the BarButtonItem component.

Check

Applies the Check style to the BarButtonItem component.

CheckDropDown

Combines Check and DropDown styles. The target bar button item supports checked/unchecked states and has an assigned drop-down control.

Related API Members

Remarks

The BarButtonItem.ButtonStyle property can contain BarButtonStyle enumeration members. The property determines the BarButtonItem control’s functionality.

The Check style allows the BarButtonItem component to be checked. Since there are two types of item containers supported by the DevExpress Ribbon, Menu and Docking Library, there are two types of display for checked items.

  1. within the popup or dropdown menu:

    Check Style within Popup

    or without images:

    Check Style within Popup wo Images

  2. within the toolbar:

    Check Style within Bar

    or without images:

    Check Style within Bar wo Images

The DropDown style allows the BarButtonItem component to contain a Dropdown control. Specify the BarButtonItem.DropDownControl to assign a dropdown to the item. To determine the property, you must have a PopupControlContainer or PopupMenu component within the project.

The Dropdown control is a PopupControlContainer with a ListBox control:

DropDown PopupControlContainer

The Dropdown control is a PopupMenu:

DropDown PopupMenu

The CheckDropDown style combines both Check and DropDown styles. A button with this style applied can display a drop-down control and supports checked/unchecked visual states.

XtraBars - CheckDropDown Button Style

The Default style determines a simple toolbar button or menu item. It can contain a descriptive image and caption.

See Also