RAD routine: as.move

A RAD routine used to move an element from one position in an array to another by creating a copy and then deleting the original. This routine is used in conjunction with as.copy, as.insert, and as.delete.

Routine

as.move

Parameters

The following parameters are valid for the as.move 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 as.get.name application 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.