ActiveReports 12
Container
ActiveReports 12 > ActiveReports User Guide > Concepts > Page Report/RDL Report Concepts > Toolbox > Container

The Container report control is a container for other items. There are a number of ways in which you can use it to enhance your reports.

Visual Groupings

You can place report controls within the Container to group them visually, and to make it easier at design time to move a group of report controls.

Note: Drawing a container around existing items does not contain them. Instead you must drag the items into the container.

You can use a container as a border for your report pages, and set border properties to create purely visual effects within your report, and even display an image behind a group of report controls by setting the BackgroundImage property of the Container.

Anchoring Items

Probably the best usage of the Container report control is to anchor report controls which may otherwise be pushed down by a vertically expanding data region. For example, if you have a group of textboxes below a table with some of them to the left or right, any of them directly below the table are pushed down below the expanded table at run time, while the upper textboxes remain where you placed them at design time. To prevent this from happening, place the group of textboxes within a container.

Container Dialog

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

The Container 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.

General

Name: Enter a name for the container 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.

Page breaks:

Appearance

Background

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

Image: Specify the background image of container using Expression or Data Visualizer, or directly open the image file on your system or server.

Note: For Page/RDL reports, if the Hatch and Gradient background styles are set using Data Visualizers, these are not displayed at design time.

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.

Rounded Rectangle: Specify the radius for each corner of the shape independently. Drag the handlers available at each corner of the shape to set the value of the radius at each corner.

Note: To enable specific corners, check the CheckBox available near each corner of the Container control.

Visibility

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 container. The user can click the toggle item to show or hide this container.

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 container. You will then be able to provide a bookmark link to this item from another report control using a Jump to bookmark action.

Data Output

The Data Output page of the Container dialog allows you to control the following properties when you export to XML:

See Also