Property Editor: Text Table

To change the properties of a Text Table, click on the Text Table template (also known as a Text Grid) and select the Properties menu option to display the Text Table Property Editor. Alternatively, right-click and select Properties from the right-click menu.

The properties of the Text Table template are identical to those of the Property Editor: Text Column, except that the values are displayed in columns using a table format, and the text cannot be wrapped.

A Text Table template can be used to display a table of values, e.g. samples with assay results:

General

On the General tab, identify the template object and specify size, position, border and visibility options.

Identity

The Name attribute is used to identify the template in the Templates list. Template names must be unique. Choose a short but descriptive name which includes the template type and data category.

To avoid potential problems, avoid using spaces or special characters in template names.

Optionally enter a Description that describes what data is associated with the template object.

Size and Position

The template position is specified relative to the top left corner of the drawing area. The left co-ordinate (X) gives the offset from the left edge of the drawing area to the left edge of the template. The top co-ordinate (Y) gives the offset in millimetres from the top of the drawing area to the top of the template. These measurements do not include the page margins. Furthermore, scale bars have annotation margins which are also not included in the measurements. The co-ordinates of a scale bar refer to the top left corner of the bar itself.

Use the Width and Height properties of the object  to adjust the size of the template object in the report. Keep the aspect ratio the same in order to prevent distortion of the image.

Border Style

Specify whether or not a rectangular border should be drawn around the template object. If you choose to draw a border, choose a single or double line style.

Visibility

Select the Hide this object option to hide the template object. The template will still be available for selection in the Templates list, but will not be visible in the report.

Data

In the Data tab, click the Add button on the toolbar to specify the source datasets that will be used to retrieve field values.

Primary Data Source

A ' data-aware' template type, derives its data from one or more datasets. Select a source dataset and a source column (field) from the drop-down list.

Lookup Data Source and Formatting

The Graphic Reporter supports "on-the-fly" decoding, eliminating the need for decoded extract tables. During the decoding process, the coded value of the source field is translated to its associated description by performing a code lookup against a nominated code table. All the parameters needed for this process must be defined at design time, including:

  • the Datasource name (which must be included as one of the datasets in the report);
  • the Code column (field in the lookup table) that is used as the lookup key;
  • the Description column (field in the lookup table) that contains the full description for the code.

Formatting

Optionally, specify a default value for the column you have selected. The default value is displayed on the report when the primary data source returns the data.

The formatting and decoding parameters displayed above are applicable to the chosen Column (LITH1).

The code in this field will be translated to its full description using the QueryLkpLith dataset, using CODE as the matching key field and returning the content of field DESCR as the text to display.

Formatting is done implicitly using separate Width, Precision, Prefix and Suffix fields (which can be blank). The Format string is compiled according to the following rule: Prefix + %[Width].[Precision][Type] + Suffix.

Options for Thousand and Decimal separators are also available.

Annotation

In the Annotation tab, select the text position of the annotation relative to the column (or text table cell).

Select the Font Style, Font Size, and Text Colour to be used for the scale bar annotation.

You can also set the Line spacing of the text, the Minimum cell height, and the Text margin.

Colours

In the Colours tab, set the pen and brush colour and style options. A preview icon is displayed to the left of the colour, width, and style input boxes.

Pen Settings

The Line colour is the Colour used to draw the border and other lines making up the template. The Line style is the (solid, dot, dash etc.) line style and width used to draw the border and other lines making up the template.

Only solid lines are supported for line widths greater than 1.

You can choose to add Join lines at the left, right, or both, edges of the column, and draw a horizontal line between the entries.

Brush Settings

Set the brush (fill) Colour and style options. The brush colour is the colour used to render the background of the template. The fill style is the hatch or stipple used for the background.

Scaling

A scaled template is usually associated with at least one scale bar.

Note: Text columns and Event graphic columns can be scaled vertically but not horizontally.

Dataset with Vertical Scaling columns

The field values used for scaling are retrieved from the scaling dataset. The dataset is usually the same as the primary dataset. If not, then the scaling dataset should have a one-to-one relationship with the primary dataset.

Primary and Secondary Scaling columns

When the system draws a template, it uses the values of the nominated scaling fields (retrieved from the scaling dataset) to determine the offsets along the associated vertical scale bar.

Allow overflow pages

If this option is not selected, lines of text that do not fit into the available space are lost. To prevent this from happening and optimise the use of available space, select the Allow overflow pages option.

An example here shows how lines have been moved up to make room for more text at the bottom of the page.

Note: When a text table is not vertically scaled, the height of each individual row is determined by the font size.