ActiveReports 13
CheckBox (Page Report)
ActiveReports 13 > ActiveReports User Guide > Concepts > Page Report/RDL Report Concepts > Toolbox > CheckBox (Page Report)

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 value evaluates to True, the small box appears with a check mark; if False, the box is empty. By default, the checkbox is empty.

Checkbox Dialog

Properties for the CheckBox are available in the Checkbox dialog. To open it, with the CheckBox control selected on the report, under the Properties Window, click the Property dialog link.

The Checkbox dialog lets you set properties on the report control with the following pages.

Note: You can select the <Expression...> option in many of these properties to create an expression to determine the value. For properties with enumerated values, the values are listed under Constants in the Fields tree view on the left side of the Expression Editor. You can also access the Expression Editor from the context menu of the CheckBox control.

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.

Tooltip: Enter the value or expression you want to appear when a user hovers the cursor over the checkbox in the viewer at run time.

Value: Enter an expression or a static label, or choose a field expression from the drop-down list. You can access the expression editor by selecting <Expression...> in the list. The value of this expression or text is displayed in the report to the right of the checkbox.

Visibility

Initial visibility

Visibility can be toggled by another report control: Select this checkbox to specify a report control to use as a toggle to show or hide the checkbox. Then specify the TextBox control to display with a toggle image button. When the user clicks the TextBox control, the checkbox changes between visible and hidden.

Appearance

Border

Style: Select a style for the border.

Width: Enter a value in points to set the width of the border.

Color: Select a color to use for the border, or select the <Expression...> option to open the Expression Editor and create an expression that evaluates to a .NET color.

Background

Color: Select a color to use for the background of the checkbox.

Image: Enter an image to use for the background of the checkbox.

Font

Family: Select a font family name or a theme font.

Size: Choose the size in points for the font or use a theme.

Style: Choose Normal or Italic or select a theme.

Weight: Choose an enumerated weight value or select a theme.

Color: Choose a color to use for the text.

Decoration: Choose from None, Underline, Overline, or LineThrough.

Format

Format code: Select one of the common numeric formats provided or use a custom .NET formatting code to format dates or numbers. For more information, see MSDN's Formatting Types topic.

Line Spacing: This property sets the space between lines of text.

Line height: This property sets the height of each line of text.

Note: This property only affects HTML output.

Character Spacing: This property sets the space between characters of text.

Text direction and writing mode

Direction: Choose LTR for left to right, or RTL for right to left.

Mode: Choose lr-tb for left right top bottom (normal horizontal text) or tb-rl for top bottom right left (vertical text on its side).

Alignment

Alignment

Vertical alignment: Choose Top, Middle, Bottom, or the <Expression...> option.

Horizontal alignment: Choose General, Left, Center, Right, Justify, or the <Expression...> option.

Justification method: Choose Auto, Distribute, DistributAllLines, or the <Expression...> option.

Wrap mode: Choose NoWrap, WordWrap, or CharWrap.

Note: You must select Justify in the Horizontal alignment property to enable the Justification method property options.

Amount of space to leave around report control

Data Output

Element Name: Enter a name to be used in the XML output for this checkbox.

Output: Choose Auto, Yes, or No to decide whether to include this checkbox in the XML output. Auto exports the contents of the checkbox only when the value is not a constant.

Render as: Choose Auto, Element, or Attribute to decide whether to render checkboxes as Attributes or Elements in the exported XML file. Auto uses the report's setting for this property.

Attribute example: <table1 checkbox3="Report created on: 7/26/2005 1:13:00 PM">

Element example: <table1> <checkbox3>Report created on: 7/26/2005 1:13:28 PM</checkbox3>

See Also