[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Gauges
  [Expand]Vertical Grid
  [Collapse]Data Editors
   [Expand]ASPxBinaryImage
   [Expand]Product Information
   [Expand]ASPxButton
   [Expand]Common Concepts
    ASPxButtonEdit
   [Expand]ASPxCalendar
    ASPxCheckBox
    ASPxCheckBoxList
   [Expand]ASPxColorEdit
   [Expand]ASPxComboBox
   [Expand]ASPxDateEdit
   [Expand]ASPxDropDownEdit
   [Expand]ASPxFilterControl
   [Expand]ASPxHyperLink
    ASPxImage
    ASPxLabel
   [Expand]ASPxListBox
   [Expand]ASPxMemo
   [Expand]ASPxProgressBar
    ASPxRadioButton
   [Expand]ASPxRadioButtonList
   [Expand]ASPxSpinEdit
    ASPxTextBox
    ASPxTimeEdit
   [Expand]ASPxTokenBox
   [Expand]ASPxTrackBar
    ASPxValidationSummary
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

ASPxCheckBox

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.

Is this topic helpful?​​​​​​​