CLEAR SCREEN ARRAY

Syntax

CLEAR SCREEN ARRAY screen-array.*

1. screen-array is a screen array specified in the form.

Usage

After executing a DISPLAY ARRAY or INPUT ARRAY instruction, values remain in the form list identified by the screen array.

The CLEAR SCREEN ARRAY instruction automatically clears all rows of the list, regardless of the view: a TABLE, TREE, SCROLLGRID, or in a matrix of fields (an old-style/text-mode static screen array).

The CLEAR SCREEN ARRAY instruction replaces code which clears each individual row through the use of a loop:

-- Clearing each row individually
FOR i=1 TO <screen-array-length>
  CLEAR screen-array[i].*
END FOR
-- Unique instruction to clear a list
CLEAR SCREEN ARRAY screen-array.*

Using the CLEAR SCREEN ARRAY instruction eliminates the need for calculating the screen array length, a value which can change when using a TABLE container, that can be resized.

The CLEAR SCREEN ARRAY instruction clears the field values and resets the TTY attributes to NORMAL.

The CLEAR SCREEN ARRAY instruction is not needed if the program is always in the context of a dialog controlling the form fields.