In ActiveReports, you can use the CheckBox control to represent a Boolean value in a report. By default, it appears as a small box with text to the right. If the DataField value evaluates to True, the small box appears with a check mark; if False, the box is empty. By default, the checkbox is empty.
Important Properties
| Property | Description |
|---|---|
| CheckAlignment | Gets or sets the alignment of the check box text within the control drawing area. |
| Checked | Gets or sets a value indicating whether the check box is in the checked state. You can also set the Checked property of the check box in code or bind it to a Boolean database value. |
| DataField | Gets or sets the field from the data source to bind to the control. |
| Text | Gets or sets the printed caption of the check box. |
You can double-click in the CheckBox control to enter edit mode and enter text directly in the control, or you can enter text in the Properties window or you can assign data to display in code through the Text property.
You can format text in the CheckBox control in edit mode using the ActiveReports toolbar, or you can modify properties in the Properties window. Formats apply to all of the text in the control. Text formatting changes in the Properties window immediately appear in the control, and changes made in the toolbar are immediately reflected in the Properties window.
In edit mode, you can use the following keyboard shortcuts.
| Key Combination | Action |
|---|---|
| Enter | New line. |
| Alt + Enter | Saves modifications and exits edit mode. |
| Esc | Cancels modifications and exits edit mode. |
In the End User Designer, you can disable this feature in the EditModeEntering and EditModeExit events.
With the control selected on the report, in the Commands section at the bottom of the Properties window, you can click the Property dialog command to open the dialog.
General
Name: Enter a name for the CheckBox that is unique within the report. This name is displayed in the Document Outline and in XML exports. You can only use underscore (_) as a special character in the Name field. Other special characters such as period (.), space ( ), forward slash (/), back slash (\), exclamation (!), and hyphen (-) are not supported.
Tag: Enter a string that you want to persist with the control. If you access this property in code, it is an object, but in the Properties window or Property dialog, it is a string.
Visible: Clear this check box to hide the control.
DataField: Select a field that returns a Boolean value from the data source to bind to the control. The value of this field determines how to set the Checked property at run time.
Text: Enter static text to show in the textbox. If you specify a DataField value, this property is ignored.
Check Alignment: Drop down the visual selector to choose the vertical and horizontal position for the check box within the control.
Checked: Select this check box to have the CheckBox control appear with a check mark in the box.
Appearance
Background Color: Select a color to use for the background of the textbox.
Font
Name: Select a font family name or a theme font.
Size: Choose the size in points for the font.
Style: Choose Normal or Italic.
Weight: Choose from Normal or Bold.
Color: Choose a color to use for the text.
Decoration: Select check boxes for Underline and Strikeout.
GDI Charset: Enter a value to indicate the GDI character set to use. For a list of valid values, see MSDN Font.GDICharSet Property.
GDI Vertical: Select this checkbox to indicate that the font is derived from a GDI vertical font.
Alignment
Wrap mode: Choose NoWrap, WordWrap, or CharWrap to select whether to wrap words or characters to the next line.
Enter values in points to set the amount of space to leave around the check box.