Common Report Control Properties

Unless indicated otherwise, the control properties in the following list are common to all report controls. A property marked with an asterisk (*) can have its default value set in the Tools > Options > Report Writer > Default dialog. For a description of this interface, see Establishing Report and Control Defaults.

(Name)

The default name is derived from your report name. For example, for Report1, the default name for the first label would be Report1-RwLa-1. You can change this name if desired.

Border Color

This property is not available for the check box, line, or radio button report controls.

A drop-down box allows for the selection of non-zero values from 1 to 16 that correspond to border colors. The default value for this property is 0.

When the Border Style property is set to Boxed, the Border Color and Border Width properties combine to determine the presentation of the border around the report control.

Border Style

This property is not available for the check box, line, or radio button report controls.

A drop-down box allows for the selection of Boxed or No Box. For most controls, the default value for this property is Boxed. However, for the label and table report controls, the default value is No Box. Also, note that the No Box setting is ignored by the report box control.

When this property is set to Boxed, the Border Color and Border Width properties combine to determine the presentation of the border around the report control.

Border Width

This property is not available for the check box, line, or radio button report controls.

The Border Width property allows for the entry of an integer between 1 and 20, representing a width measurement in pixels. The default value for this property is None.

When the Border Style property is set to Boxed, the Border Color and Border Width properties combine to determine the presentation of the border around the report control.

Color*

The default value for this property is foreground black on background white.

The Value cell for this property has an ellipsis push button that opens the Color Setting dialog. Foreground and background colors can be set in this interface. The Color property setting of a report control overrides the Color setting of its parent section.

Color Variable*

The Value cell for this property has an ellipsis push button that opens the Select Variable interface. If a variable is selected in this dialog, subtle modifications to the generated code occur, such that it references the Color Variable instead of the Color value directly. This property has no initial default value.

Column

This property determines the location of the report control with respect to the left margin of the page. The unit of measure (inches or centimeters) is set in the Tools > Options > Report Writer > General interface.

Font*

This property is not available for the box, image, line, and occurs report controls.

A drop-down box displays several choices for font. The default value is Default Font. The push button in the Value cell causes the Font dialog to appear.

The Font property setting for a report control overrides the Font property setting of its parent section.

Hyperlink

This property applies to report date time controls, entry fields, images, and labels. It is used to assign a hyperlink to the control when it is displayed in a Web browser. A hyperlink may reference either a local HTML file or a Web site.

To reference a local HTML file, click the ellipsis push button in the Value cell to display the Open dialog box. Navigate to the location of the local file and select it.

To reference a Web site, enter the entire address in the Value cell (e.g., https://www.microfocus.com). If you omit the http:// prefix, AcuBench interprets the entry as a file name. In the latter case, the result is a File not found error message when you attempt to access the link.

This property has no default value.

Hyperlink Variable

This property applies to report date time controls, entry fields, images, and labels. The Value cell for this property has an ellipsis push button that opens the Select Variable interface. If a variable is selected in this dialog, subtle modifications to the generated code occur, such that it references the Hyperlink Variable instead of the Hyperlink value directly. This property has no default value.

Line

The Line property determines the location of the report control with respect to the beginning of the parent section. The unit of measure (inches or centimeters) is set in the Tools > Options > Report Writer > General interface.

Lines

This property is not available for the line report control.

The Lines property represents the height of the report control.

Note that the standard unit of measure used by Lines is set in the Tools > Options > Report Writer > General dialog. In this dialog, you can select Inch (the default) or Centimeter in the Unit frame.

Print Condition

A print condition can be used to make the printing of a report control conditional. Print conditions are discussed in detail in Setting Print Conditions.

Size

This property represents the width of the report control.

Note that the standard unit of measure used by Size is set in the Tools > Options > Report Writer > General dialog. In this interface, you can select Inch (the default) or Centimeter in the Unit frame.

Title

This property determines the text portion of the report check box, label, or radio button.

Title Variable

This property applies to the report check box, label, and radio button controls. The Value cell for this property has an ellipsis push button that opens the Select Variable interface. If a variable is selected in this dialog, subtle modifications to the generated code occur, such that it references the Title Variable, instead of the Title value directly. This property has no default value.

Visible*

A drop-down box allows the selection of TRUE or FALSE. Selecting FALSE inhibits the printing of the report control. The default value is 1:TRUE.

Visible Variable*

The Value cell for this property has an ellipsis push button that opens the Select Variable interface. If a variable is selected in this dialog, subtle modifications to the generated code occur, such that it references the Visible Variable instead of the Visible value directly. This property has no initial default value.