ActiveReports 19 User Guide
Report Authors / Report Controls / Report Controls in Section Report / CrossSectionBox
In This Topic
CrossSectionBox
In This Topic

In section reports, you can use the CrossSectionBox report control to display a frame that runs from a header section through its related footer section, spanning all details that come between.

CrossSectionBox Section Report Control 

You can place the CrossSectionBox control in the header section in the designer. On adding the control in the footer section, it automatically associates itself with the related header section in the Report Explorer. The control automatically spans intervening sections to end in the related footer section. Move and sizing handles for cross-section controls are not available; you need to use Properties panel instead.

Important Properties

Clicking the four-way arrow selects the control and reveals its properties.

Property Description
Radius Sets the radius of each corner for the RoundRect shape type. You can select Default, TopLeft, TopRight, BottomLeft or BottomRight. Selecting Default sets the radius of all the corners of the CrossSectionBox control to a specified percentage. Default value is 0 (pt).
BackColor Sets the back color.

Caution:

  • The CrossSectionBox and CrossSectionLine are not supported in multi-column reports where a GroupHeader section has the ColumnLayout property set to True.
  • The CrossSectionBox and CrossSectionLine controls are drawn across multiple sections. Therefore, it is not possible to change the control's appearance, etc. in the event of a section. The appearance of the CrossSection control can be dynamically changed only in the ReportStart event.

CrossSectionBox Dialog Properties

You can set the CrossSectionBox properties in the CrossSectionBox dialog. To open it, with the CrossSectionBox selected on the report, under the Properties panel, click the Property dialog link.

Name: Enter a name for the control 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 (/), backslash (\), 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 panel or Property dialog, it is a string.

Visible: Clear this check box to hide the control.