The next table presents the properties of the Table Records widget.

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Mandatory

TableRecords<n>

 

This name represents the widget in the Scope Tree where it aggregates its runtime properties.

See rules for naming elements.

Source Record List

The list of records to display to end-users.

A copy of the Source Record List will be created and stored in an implicit variable within the Table Records itself.

Mandatory

 

The Source Record List is copied into the Table Records implicit variable after the screen Preparation finishes, and whenever a screen action is executed.

Empty Message

 

Message presented when there are no records to show. This message is displayed in the first row of this widget.

Optional

 

No items to show...

 

 

Line Count

Indicates the maximum number of rows that can be displayed in this widget.

Mandatory

50

 

Start Index

Indicates the position from where the widget starts displaying. This property is very useful to iterate over the Source Record List, displaying n records at a time.

Mandatory

0

This property should be set through the Start Index runtime property or by using an input parameter of the screen.

Width

Indicates the width of the widget. You can change the width by editing this property or by resizing it using the Grid in the Content Canvas.

Optional

 

The value of this property can be in columns, pixels, points, or percentage.

Margin Left

Indicates the width of the left margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels, points, or percentage.

If not defined and the widget style defines a margin-left then this margin is applied to the widget.

Margin Top

Indicates the height of the top margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels or points.

If Auto is selected and the widget style defines a margin-top then this margin is applied to the widget.

Cell Height

Indicate the height, in number of pixels, of the cells.

Optional

 

 

Cell Spacing

Indicates the number of pixels between the cells.

Optional

0

 

Show Header

 

Indicates whether the header row is displayed at the top of the widget.

Mandatory

Yes

 

 

Style

Drop-down list with the styles that can be applied to the contents of the table records.

Optional

TableRecords

Learn more about styles sheets.

Double-click on the property and the Style Sheet Editor is opened with the current style already selected.

Header Style

Drop-down list with the styles that can be applied to the header row (column headings).

Optional

TableRecords_Header

Learn more about style sheets.

Odd Line Style

Drop-down list with the styles that can be applied to the odd numbered lines.

Optional

Data

Learn more about style sheets.

Even Line Style

Drop-down list with the styles that can be applied to the even numbered lines.

Optional

DataAlternate

Learn more about style sheets.

Extended Properties - Additional properties for attributes and/or events that implement specific behaviors of your widget.

Name

Name of the attribute that the HTML element can accept as specified in the HTML language reference.

NA

 

This property is added to the <table> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

Value

The value for the attribute.

NA

 

This property is added to the <table> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

See Also

About Table Records Widget