FORM GOTO PAGE
FORM GOTO PAGE ( pageNumber {; *} )
| Parameter | Type | Description | |
|---|---|---|---|
| pageNumber | Integer | → | Form page to display |
| * | Operator | → | Change page of current subform |
Description
FORM GOTO PAGE changes the currently displayed form page to the form page specified by pageNumber.
If no form is displayed or loaded by the FORM LOAD command, or if pageNumber corresponds to the current page of the form, FORM GOTO PAGE does nothing. If pageNumber is greater than the number of pages, the last page is displayed. If pageNumber is less than one, the first page is displayed.
The * parameter is useful when the command is called in the context of a page type subform containing several pages. In this case, when you pass this parameter, the command changes the page of the current subform (the one that called the command). By default, when the * parameter is omitted, the command is always applied to the parent form.
About form page management commands
Automatic action buttons perform the same tasks as the FORM FIRST PAGE, FORM LAST PAGE, FORM NEXT PAGE, FORM PREVIOUS PAGE and FORM GOTO PAGE commands that you can apply to objects such as tab controls, drop-down list boxes, and so on. Whenever appropriate, use automatic action buttons instead of commands.
Page commands can be used with input forms or with forms displayed in dialogs. Output forms use only the first page. A form always has at least one page—the first page. Remember that regardless of the number of pages a form has, only one form method exists for each form.
- Use the FORM Get current page command to find out which page is being displayed.
- Use the On Page Change Form event code that is generated each time the current page of the form changes.
Note: When designing a form, you can work with pages 1 through X, as well as with page 0, in which you put objects that will appear in all of the pages. When using a form, and therefore when calling page commands, you work with pages 1 through X; page 0 is automatically combined with the page being displayed.
Example
The following example is an object method for a button. It displays a specific page, page 3:
FORM GOTO PAGE(3)
See also
FORM FIRST PAGE
FORM Get current page
FORM LAST PAGE
FORM NEXT PAGE
FORM PREVIOUS PAGE
Properties
| Command number | 247 |
| Thread safe | ✗ |