- 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.
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.
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.
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
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.