The Line control allows you to draw vertical, horizontal or diagonal lines that visually separate or highlight areas within a section on a report. You can also use the Line report control to visually separate data regions in a report layout.
Important Properties
Clicking the four-way arrow selects the control and reveals its properties.
| Property |
Description |
| AccessibleDescription |
Enter the alternative description of the control for use by accessibility client application. The property on exporting the report adds the ‘alternative text’ in PDF and ‘alt’ attribute in HTML. |
| LineColor |
Gets or sets the color of the line. |
| LineStyle |
Gets or sets the pen style used to draw the line. The line styles include Transparent, Solid, Dash, Dot, DashDot, DashDotDot, or Double. |
| LineWidth |
Gets or sets the pen width of the line in points. |
| Visibility |
Indicates whether the line is visible or hidden. |
| LayerName |
Gets or sets the name of the containing layer. |
| EndPoint |
Set the vertical and horizontal end points of the line. |
| Location |
Gets or sets the position of the top-left corner of the report item in relation to its container. |
Line Dialog Properties
You can set the Line properties in the Line dialog. To open it, with the Line selected on the report, under the Properties panel, click the Property dialog link.
Name: Enter a name for the line that is unique within the report. This name can be called in code. You can only use underscore (_) as a special character in the Name field. Other special characters such as period (.), space ( ), forward slash (/), backslash (\), exclamation (!), and hyphen (-) are not supported.
The Visibility page of the Line dialog allows you to control the following items:
Initial visibility
- Visible: The line is visible when the report runs.
- Hidden: The line is hidden when the report runs.
- Expression: Use an expression with a Boolean result to decide whether the line is visible. True for hidden, False for visible.
Visibility can be toggled by another report item: Select this check box to display a toggle image next to another report item. This enables the drop-down box below where you can specify the TextBox control that toggles the visibility of the line. The user can click the toggle item to show or hide this line.
Document map label: Enter an expression to use as a label to represent this item in the table of contents (document map).
Bookmark ID: Enter an expression to use as a locator for this line. You will then be able to provide a bookmark link to this item from another report control using a Jump to bookmark action.
