ActiveReports Developer 7
See Also Support Forum
ActiveReports Developer 7 > ActiveReports Developer Guide > Concepts > Page Report Concepts > Page Report Toolbox > Container

Glossary Item Box

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.


Name: Enter a name for the container that is unique within the report. This name can be called in code.

Page breaks:

  • Insert a page break before this container: Insert a page break before the container.
  • Insert a page break after this container: Insert a page break after the container.



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

Image: Enter an image to use for the background of the container.


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

When you select a checkbox next to a corner of the rectangle in the dialog, a yellow diamond appears. Drag the yellow diamond to change the shape of the corner.

Use the same radius on specified corners: Select this option to apply the same radius to all selected corners of the rectangle.

Use different radius on specified corners: Select this option to apply a different radius to each selected corner of the rectangle.


Initial visibility

  • Visible: The container is visible when the report runs.
  • Hidden: The container is hidden when the report runs.
  • Expression: Use an expression with a Boolean result to decide whether the container is visible. True for hidden, False for visible.

Visibility can be toggled by another report control: 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 report control that toggles the visibility of the container. The user can click the toggle item to show or hide this container.


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.

ShowData Output

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

  • Element name: Enter a name to be used in the XML output for this container.
  • Output: Choose Auto, Yes, No, or Contents only to decide whether to include the contents of this container in the XML output. Choosing Auto exports the contents of the container only when the value is not a constant.

See Also

©2014. ComponentOne, a division of GrapeCity. All rights reserved.