Table

The Table control is used to arrange the report information in a tabular layout.

When a Table control is dropped onto a report's band from the Toolbox, it becomes a table of one row and three columns. If the user clicks and drags over several bands, the resulting table will be split by the bands into several tables. This enables the creation of a table header in the header band and the table's body, with one mouse move.

A Table control bound to data is created automatically when a data table is dragged and dropped from the Field List window.

Manage a Table's elements by using its Context Menu.

A Table control consists of Table Row controls, each representing one table row. Each Table Row consists in turn of Table Cell controls, each representing one table cell. They can be selected and customized individually (see Table Row and Table Cell).

To select the Table control in Reporting, use the Report Explorer or the dropdown menu of the Property Grid.

In the Property Grid, the Table control's properties are divided into the following groups:

Appearance

• Background Color

  Specifies the background colour for the control. This option is also available on the Formatting Toolbar ().

• Borders, Border Color and Border Width

  Specifies border settings for the control.

• Font

  Specifies the font settings for the control. Some of these settings are available on the Formatting Toolbar.

• Foreground Color

  Specifies the text colour for the control. This option is also available on the Formatting Toolbar ().

• Formatting Rules

  Displays the Formatting Rules Editor, used to choose which rules should be applied to the control during report generation, and define the precedence of the applied rules. for further information, refer to Conditionally Change a Control's Appearance.

• Padding

  Specifies indent values which are used to render the contents of the control.

• Style Priority

  Used to define the priority of various style elements (such as background colour, border colour, ). for further information on style inheritance, refer to Styles Concepts.

• Styles

  This property is used to define odd and even styles for the control, as well as to assign an existing style to the control (or a newly created one). for further information on style inheritance, refer to Styles Concepts.

• Text Alignment

  Used to change the alignment of Table text. This option is also available on the Formatting Toolbar.

Behavior

• Anchor Vertically

  Specifies the vertical anchoring style of a Table, so that after page rendering it stays attached to the top control, bottom control, or both.

• Keep Together

  Specifies whether the contents of the control can be horizontally split across pages. In other words, if the control occupies more space than remains on the page, this property specifies whether this control should be split between the current page and the next, or whether it will be printed entirely on the next page. If a control does not fit on the next page either, then the control will be split despite this property's value.

• Scripts

  This property contains events, which can be handled with the scripts. for further information on scripting, refer to Handle Events via Scripts.

• Visible

  Specifies whether the control should be visible when the report is previewed.

Data

• Tag

  This property enables users to add additional information to the control; for example its Id, by which it can then be accessed by scripts.

  If the current report has a data source, the Tag property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and from the Tag.Binding dropdown list, select the required data field.

Design

• (Name)

  Determines a control's name, by which it can be accessed in the Report Explorer, the Property Grid and via scripts.

Layout

• Location

  Specifies the control's location, in report measurement units.

• Size

  Specifies the control's size, in report measurement units.