ASPxCheckBox

• Aug 01, 2019
• 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.