SCROLL

The SCROLL instruction moves data rows up or down in a screen array.

Syntax

SCROLL field-list { UP | DOWN } [ BY lines ]
where field-list is:
{ field-name
| table-name.*
| table-name.field-name
| screen-array[line].*
| screen-array[line].field-name
| screen-record.*
| screen-record.field-name
} [,...]
  1. field-name is the identifier of a field of the current form.
  2. table-name is the identifier of a database table of the current form.
  3. screen-record is the identifier of a screen record of the current form.
  4. screen-array is the name of the screen array used of the current form.
  5. lines is an integer expression that specifies how far (in lines) to scroll the display.

Usage

The SCROLL instruction specifies vertical movements of displayed values in all or some of the fields of a screen array within the current form.

The fields to be scrolled can be specified individually or by referencing a screen record or screen array, eventually with the .* notation to specify all fields.

The SCROLL instruction is supported for applications running in TUI mode, to scroll screen array rows when no interactive instruction is executing. In a GUI application, use a TABLE container with a DISPLAY ARRAY instruction.