The Line report control can be used to visually separate data regions in a report layout. You can set properties in the Properties grid or the Line Dialog to control the appearance of the line, and to control when the line is rendered.
Important Properties
| Property | Description |
|---|---|
| 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. |
Properties for the Line are available in the Line dialog. To open it, with the Line control selected on the report, under the Properties Window, click the Property dialog link.
The Line dialog lets you set properties on the report control with the following pages.
General
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 (/), back slash (\), exclamation (!), and hyphen (-) are not supported.
Visibility
The Visibility page of the Line dialog allows you to control the following items:
Initial visibility
Visibility can be toggled by another report control: Select this check box to display a toggle image next to another report control. 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.
Navigation
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.