• 2 minutes to read

The ASPxCheckBox control is a check editor that allows end-users to select yes/no or true/false conditions. A check state can be switched by clicking the editor with the mouse or by pressing the SPACE key when the editor has focus.


ASPxCheckBox offers the following features:

  • Three State Support

    By default, a check box can be set to either the checked or unchecked check state. Additionally, you can enable the third grayed (indeterminate) state using the ASPxCheckBox.AllowGrayed property.

  • Native Rendering

    ASPxCheckBox supports native rendering as a native HTML input element of the checkbox type. When the native HTML mode is enabled, the control appearance depends on how a client browser renders native HTML elements. This reduces the render size and improves the editor's overall performance. Set the ASPxCheckBox.Native property value to true to enable native rendering.

  • Custom Images

    By default, a check box edit region (check mark) is represented by an image within the ASPxCheckBox editor. It is possible to assign your own images to be displayed for different check box states.


  • Two Appearance Styles for iOS Theme

    ASPxCheckBox can be displayed as a toggle switch in iOS DevExpress theme. To enable this appearance, set the editor's SkinID property to Switch.


  • Built-in Validation

    The ASPxCheckBox control allows you to perform data validation both on the client and server side. See the Validation topic to learn more.

  • Full-Featured Client-Side API

    ASPxCheckBox provides you with a comprehensive client-side API. This API is implemented using JavaScript and is exposed via the ASPxClientCheckBox object. The ASPxClientCheckBox object serves as the client-side equivalent of the ASPxCheckBox control.

    You can operate with the editor values using the following methods.

    Method Description
    ASPxClientCheckBox.GetChecked Returns a value indicating whether the check box editor is checked.
    ASPxClientCheckBox.GetCheckState Returns a value which specifies a check box checked state.
    ASPxClientCheckBox.GetText Returns the text displayed within the editor.
    ASPxClientCheckBox.SetChecked Sets a value which specifies the checked status of the check box editor.
    ASPxClientCheckBox.SetCheckState Sets a value specifying the state of a check box.
    ASPxClientCheckBox.SetText Sets the text to be displayed within the editor.