Skip to main content
Version: Next

GOTO OBJECT

GOTO OBJECT ( {* ;} object )

ParameterTypeDescription
*OperatorIf specified = object is an object name (string) If omitted = object is a field or a variable
objectField, VariableObject name (if * specified) or Field or Variable (if * omitted) to go to

Description

The GOTO OBJECT 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).

The GOTO OBJECT command can be used in the context of a subform. When it is called from a subform, it first looks for the object in the subform, then, if the search does not find anything there, it extends the search to objects of the parent form.

Example 1

The GOTO OBJECT command can be used in both ways:

 GOTO OBJECT([People]Name) // Field Reference
 GOTO OBJECT(*;"AgeArea") // Object Name

Example 2

You don't want any object of the form to have the focus:

 GOTO OBJECT(*;"")

Example 3

See the example for the REJECT command.

See also

CALL SUBFORM CONTAINER
REJECT

Properties

Command number206
Thread safe