screenRecords
ScreenRecords allows passing values to a screen record by creating a correspondence between a screen record and a program record.
A screen record is a set of fields on a screen form that can be referenced as a single object.
4GL automatically creates a default screen record which includes form fields that are connected to the same database (or are not connected to any data base). As our forms are FormOnly, all the fields in them belong to the default FormOnly record which comprises all the form fields which are not linked to any database. You don’t have to specify this default screen record, because it is created automatically.
The members of a screen record are form fields, and like in the program record, they are called members.
Screen records are listed as the first-level children of the ScreenRecords group in the Form Structure:
There are screen records that are created automatically and change when the form content is changed. The main default screen record is the FormOnly screen record. Any form widget, to which the input is possible, is added to the FormOnly screen record. This means, that widgets designed only for data display or user manipulation (label, button, progressbar) are not included to the FormOnly screen record.
There are also screen records automatically created for form tables and tree tables. They include the fields that fill the table columns. The changes in the table structure are reflected in these screen records content. If a column is added or deleted from the table or a tree table, the corresponding field is added or deleted from the table screen record. The identifiers of tables and their screen records are identical and bound. The changes in one lead to the changes in the other.
To add a new screen record, click the Add button next to the ScreenRecords group name in the Form Structure.
This will create an empty screen record with a default identifier:
To add a field to the screen record, select the screen record from the list of screen records in the Form Structure, find the Fields property in the Properties view, and type in or paste a comma-separated list:
Alternatively, click the More button in the property cell and add fields, one field per line:
