This document describes the XRCheckBox control and explains its main features.
The XRCheckBox control displays True/False or Checked/Unchecked/Indeterminate values in a report.
You can add this control by dragging the XRCheckBox item from the DX:18.2: Report Controls Toolbox tab onto the report.
Use one of the following properties to set the checkbox's state:
XRCheckBox.CheckState - specifies one of the following checkbox states:
The XRControl.Text property specifies the checkbox's caption. You can double-click the checkbox to invoke its in-place editor and type the desired text.
The XRCheckBox.RightToLeft option allows you to align the control content for right-to-left writing systems.
You can bind the XRCheckBox.CheckState property to a data field obtained from a report's data source. Click the control's smart tag, expand the Expression drop-down list for the CheckState property and select the required data field.
The data field value determines the checkbox state in the following manner:
In the same way, expand the Expression drop-down list for the Text property and bind it to the desired data field.
Clicking the Expression option's ellipsis button invokes the Expression Editor, in which you can construct a complex binding expression involving two or more data fields.
You can also drag and drop a Boolean type data field from the Field List to create a new checkbox bound to this field.
See the Bind Report Controls to Data topic to learn more about available data binding modes and creating data-aware controls.
The CheckEditOptions.GroupID setting defines the checkbox's behavior in Print Preview:
When you set this property to null or an empty string value, a checkbox can be switched to either the "checked" and "unchecked" state independently on other available checkboxes.