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

Property

Description

Optionality

Default value

Obs.

Name

Internal name that identifies the widget.

Mandatory

ListRecords<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 List Records itself.

Mandatory

 

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

Empty Message

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

Optional

 

 

Line Separator

Indicates how the records are displayed in the widget. The possible values are:

  • None: all the records are displayed on one line.

  • New Line: each record is presented on a separate line.

  • Bullets: each record is presented on a separate line with a bullet.

Mandatory

New Line

 

Line Count

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

Mandatory

100

 

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.

Style

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

Optional

 

Learn more about styles sheets.

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

Empty Message Style

Drop-down list with the styles that can be applied to the whole widget.

Optional

 

Learn more about styles 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 <span> 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 <span> HTML tag that corresponds to this widget.

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

See Also

About List Records Widget