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

CheckButton Class

The button that supports two states - elevated and depressed. It is possible to prevent the button from receiving focus on a click. Multiple buttons can be combined into a radio group, in which only a single button is checked simultaneously.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.1.dll


[SmartTagAction(typeof(CheckButtonActions), "Checked", "Checked", SmartTagActionType.RefreshContentAfterExecute)]
[SmartTagAction(typeof(CheckButtonActions), "Unchecked", "Unchecked", SmartTagActionType.RefreshContentAfterExecute)]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "CheckButton")]
public class CheckButton :


On clicking the CheckButton control, the button is pressed and remains in this state until the button is clicked again.


The button’s check state is specified by the CheckButton.Checked property. To respond to changes in the button’s state, handle the CheckButton.CheckedChanged event.

Multiple CheckButton controls can be combined into a logical group of mutually exclusive buttons. In this group, only one button can be in the depressed state at one time. Clicking another button unchecks the currently checked button, and checks the clicked button. To combine buttons into a group, use their CheckButton.GroupIndex properties.

To prevent the button from receiving focus on clicking, use the inherited SimpleButton.AllowFocus property.

See Also