Paradigm Support Desk

Report Designer Table Control

The Table control is designed to arrange information in a tabular layout. It may contain any number of Rows comprised of individual Cells. Both Rows and Cells can be selected and customized individually. In most aspects, a Cell is similar to a Label, but can also contain other controls (e.g. Picture Box or Rich Text).

When a Table is dropped onto a band from the Toolbox, it has one row and three columns. If you click and drag over several bands, the resulting table will be split by the bands into several tables. This creates a table header and the detail table with one mouse move.

When you drag and drop an entire data table from the Field List, a Table with cells bound to the corresponding data fields is created automatically.

A table's elements are managed by using its Context Menu.

On the Property Grid, the Table Control's properties are grouped as follows.

1. Appearance

  • Background Color
    Specifies the background color for the control. This option is also available in the Formatting Toolbar.
  • Borders, Border Colour and Border Width
    Specify border settings for the control.
  • Font
    Specifies the font settings for the control. Some of these settings are available in the Formatting Toolbar.
  • Foreground Color
    Specifies the text colour for the control. This option is also available in the Formatting Toolbar
  • Padding
    Specifies indent values which are used to render the contents of a Tables cells.
  • Style Priority
    Provides access to the settings that determine which properties of a style assigned to a control should override the corresponding properties of a control.
  • Styles
    Gets a set of styles for the control.
  • Text Alignment
    Allows you to change the alignment of a Tables text. This option is also available in the Formatting Toolbar.
  • Location
    Specifies the floating-point representation of the coordinates of the control's upper-left corner.
  • Size
    Gets or sets the size of the control.
  • Right to Left
    Specifies the content orientation within the XRTable's cells

2. 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.
  • Anchor Horizontally
    Specifies the horizontal anchoring type of a report control.
  • Can Publish
    Specifies whether or not a report control is displayed in a printed or exported document.
  • Keep Together
    Specifies whether the contents of a Table can be horizontally split across pages. In other words, if a Table occupies more space than remains on the page, this property specifies whether the Table should be split between the current page and the next, or whether it will be printed entirely on the next page. This property is in effect only when a Table's content does not fit on the current page. If it does not fit on the next page then the Table will be split despite this property's value.
  • Process Hidden Cell Mode
    Specifies how to distribute the space that remains after some of the row's visible cells are hidden. Affects only the table row whose cells were hidden.
  • Scripts
    This property contains events, which you can handle with the required scripts.
  • Visible
    Specifies whether the control should be visible in print preview.

3. Data

  • Tag
    This property allows you to add some additional information to the control, for example its ID, by which it can then be accessible via scripts.

4. Miscellaneous

  • (Name)
    Determines a controls name, by which it can be accessed in the Report Explorer, Property Grid or via scripts.
  • Snap Line Margin
    Specifies the margin (in report measurement units), which is to be preserved around the control when it is aligned using Snap Lines, or when other controls are aligned next to it.
  • Bookmark and Parent Bookmark
    These properties are intended for the creation of a hierarchy structure within a report called a document map. For an explanation and help, refer to Add Bookmarks. If the current report has a data source, the Bookmark property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and in the Bookmark.Binding drop-down selector, select the required data field.

Paradigm is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.