FGL_SCR_SIZE()

Returns the size of the specified screen array in the current form.

Syntax

FGL_SCR_SIZE(
   screen-array STRING )
  RETURNING result INTEGER
  1. screen-array is the name of a screen-array in the current displayed form.

Usage

The FGL_SCR_SIZE() function takes the name of a screen array as parameter identifying an array in the currently opened form and returns an integer that corresponds to the number of screen records in that screen array.

This function is typically used with traditional text mode forms having screen arrays with a constant size, to display data in screen array rows with the DISPLAY TO instruction.

For modern GUI applications, think of using the UNBUFFERED mode in dialogs, to get automatic form field synchronization with program variables.

Error -1108 will be raised if the passed screen-array does not exits in the current form, and error -1114 is returned if no form is currently displayed.