version 11 (Modified)
GOTO AREA ({*; }object)
Parameter | Type | Description | |
* | * | If specified = object is an object name (string) | |
If omitted = object is a field or a variable | |||
object | Field | Variable | Object name (if * specified) or | |
Field or Variable (if * omitted) to go to |
Description
The GOTO AREA command is used to select the data entry object object as the active area of the form. It is equivalent to the user's clicking on or tabbing into the field or variable.
If you specify the optional * parameter, you indicate an object name (a string) in object. If you omit the optional * parameter, you indicate a field or a variable in object. In this case, specify a field or variable reference (field or variable objects only) instead of a string. For more information about object names, see the section Object Properties.
To remove any focus in the current form, call the command while passing an empty object name in object (see example 2).
Note: This command only functions in input forms. It has no effect on data entry areas located in subform List forms.
Examples
1. The GOTO AREA command can be used in both ways:
GOTO AREA ([People]Name) ` Field Reference GOTO AREA (*;"AgeArea") ` Object Name
2. You don't want any object of the form to have the focus:
GOTO AREA (*;"")3. See the example for the command REJECT.
See Also