Check Box

<< Click to Display Table of Contents >>

Raynet One Data Hub > 14.0 > Dashboards and Reports Customization Guide > Designing Reports > Use Report Elements > Use Basic Report Controls 

Check Box

The Check Box control displays the checkbox's state.

 

You can add this control by dragging the Check Box item from the Toolbox onto the report's area.

 

eurd-web-add-check-box-control-to-report

 

Use one of the following properties to set the checkbox's state:

 

Checked - indicates whether the checkbox is selected (displays a check mark) or not (is empty).

Check State - specifies one of the following checkbox states:

 

Icon

Check State

checkboxunchecked

Unchecked

checkboxchecked

Checked

checkboxindeterminate

Indeterminate

 

The Text property specifies the checkbox's caption. You can double-click the checkbox to invoke its in-place editor and type the desired text.

 

eurd-web-check-box-in-place-editor

 

Bind to Data

You can bind the Check State property to a data field obtained from a report's data source. Switch to the Properties panel, expand the Actions category and click the Check State property's marker. Select Check State Expression from the popup menu. Then select a data field in the invoked Expression Editor.

 

eurd-web-check-box-bind-to-data

 

The data field value determines the checkbox state in the following manner:

 

True or 1 activates the Checked state;

False or 0 activates the Unchecked state;

Any other value activates the Indeterminate state.

In the same way, click the Text property's marker, select Text Expression, then select a data field or construct a complex binding expression that involves two or more data fields.

 

eurd-web-check-box-text-expression

 

You can also drag and drop a Boolean type data field from the Field List to create a new checkbox bound to this field.

 

eurd-web-check-box-drop-field-from-field-list

 

See the Bind Report Controls to Data topic to learn more about creating data-aware controls.

 

Interactivity

Set the Edit Options | Enabled option to Yes to enable changing the checkbox state in Print Preview.

 

eurd-web-check-box-edit-options-enabled

 

The Group ID setting defines the checkbox's behavior in Print Preview:

 

When you set this property to an empty string value, a checkbox can be switched to either the "checked" and "unchecked" state independently on other available check boxes.
 
eurd-web-check-box-editing-in-print-preview
 

Otherwise, the field editor behaves like a radio button, and editors that have the same ID belong to a single logical group (that is, only one option can be selected in a group at a time).

 

Glyph Customization

The Glyph Options property provides access to glyph settings.

 

eurd-web-check-box-glyph-options

 

Alignment - specifies the glyph's alignment within the control.
 
eurd-web-check-box-glyph-options-alignment
 

Size - specifies the glyph size.

Glyph Style - specifies a predefined glyph style.
 
eurd-web-check-box-glyph-options-glyph-style
 

Custom Glyphs - specifies a custom glyph image for each checkbox state (Checked/Unchecked/Indeterminate).
 
eurd-web-check-box-glyph-options-custom-glyphs