BarButtonStyle Enum

Specifies the BarButtonItem control style.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.dll

Declaration

C#

public enum BarButtonStyle

VB.NET

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

The following properties accept/return BarButtonStyle values:

• BarBaseButtonItem.ButtonStyle
• BarButtonItem.ButtonStyle

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:

   

   or without images:

   

2. within the toolbar:

   

   or without 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:

The Dropdown control is a 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.

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