Move Statement

Format

move ʃtoʅ field_name ʃadvance ‖ skipʅ;

Description

The move statement allows movement to a field without regard to whether it is before or after the current field. This is particularly useful in an OnKey or userbar function because you may not know at what point the function will be called. The field_name is either the name of a field or is a string variable specifying the name of the field.

Movement to a field before the current field acts exactly like a reenter statement. The action of move to a field after the current field depends on the optional keywords advance or skip. If no keyword is specified, or if skip is coded, then forward movement acts exactly like a skip statement, skipping past fields. If advance is coded, then forward movement acts exactly like an advance statement, moving over fields.

Example

function numeric OnKey(numeric keystroke)

if keystroke = 2070 then // Ctrl+F
// move to the first person
move to NAME(1) advance;

elseif keystroke = 2076 then // Ctrl+L
// move to the last person
move to NAME(totocc(PERSON_REC000)) advance;

else
OnKey = keystroke;

endif;

end;