RAD routine: as.insert

A RAD routine used to insert a NULL element. It is used in conjunction with as.copy, as.delete, and as.move.

Routine

as.insert

Parameters

The following parameters are valid for the as.insert 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

Data is not normally passed to this parameter. The default is the result of executing the cursor.field.name(1) function. The application as.get.name then executes against this result.

Note You can pass the name of a specific arrayed structure. If the data passed to this parameter does not contain commas, it is considered an arrayed structure name. If a comma is found, the application as.get.name executes against the data.

index number No

The number of lines (height property) in the subform that displays the arrayed structure. For example, if the arrayed structure subform has data on lines 1 and 2, then this 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 = the number of lines in the subform, and 1 indicates a data type of number.