RAD routine: as.options

A RAD routine used to display all available arrayed structure options one rio (Record Display/Input) Command panel.

Note The as.options routine provides the control needed to copy, insert, delete, and move fields. It is not necessary to run as.copy, as.move, as.insert, and as.delete in conjunction with this routine.

Routine

as.options

Parameters

The following parameters are valid for the as.options routine:

Name Data type Required Description
file record No The file variable currently being edited. The value is always $file when called from Format Control.
name character No Passes the name of the current form. If left blank, the default is the result of executing the current.format() function.
cond.input Boolean No

Allows the user to edit the data record when the Arrayed structure maintenance options are displayed. The default value is true.

Note When calling the application from Format Control, the value must be passed as a data type of 4 (logical) by using the following syntax:

val(“false”, 4)
index number No

The number of lines in the subform that displays the arrayed structure. For example, if the arrayed structure subform has data on lines 1 and 2, then the parameter is 2. The default value is 1.

Note This is not the window size that displays the arrayed structure.

When calling the application from Format Control, the value must be passed as a number by using the following syntax:

val("n", 1)

Where:

The value of n is the number of lines in the subform, and one (1) indicates a data type of number.