CLEAR SCREEN ARRAY
The CLEAR SCREEN ARRAY
instruction clears
the values of all rows of the form list identified by the specified
screen array.
Syntax
CLEAR SCREEN ARRAY screen-array.*
- 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.
CLEAR SCREEN ARRAY
clears the field values and resets the TTY attributes to
NORMAL
.The CLEAR SCREEN ARRAY
instruction is usually not needed if the program is
always in the context of a dialog controlling the
form fields.
Example
...
DISPLAY ARRAY cust_arr TO sa.*
...
CLEAR SCREEN ARRAY sa.*
...