4D v16.3
FORM GOTO PAGE
- 4D Language Reference
-
- Forms
-
- CALL FORM
- Current form name
- FORM FIRST PAGE
- FORM Get current page
- FORM GET HORIZONTAL RESIZING
- FORM GET OBJECTS
- FORM GET PARAMETER
- FORM GET PROPERTIES
- FORM GET VERTICAL RESIZING
- FORM GOTO PAGE
- FORM LAST PAGE
- FORM LOAD
- FORM NEXT PAGE
- FORM PREVIOUS PAGE
- FORM SCREENSHOT
- FORM SET HORIZONTAL RESIZING
- FORM SET INPUT
- FORM SET OUTPUT
- FORM SET SIZE
- FORM SET VERTICAL RESIZING
- FORM UNLOAD
FORM GOTO PAGE
| FORM GOTO PAGE ( pageNumber {; *} ) | ||||||||
| Parameter | Type | Description | ||||||
| pageNumber | Longint |
|
Form page to display | |||||
| * | Operator |
|
Change page of current subform | |||||
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.
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 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.
The following example is an object method for a button. It displays a specific page, page 3:
FORM GOTO PAGE(3)
FORM FIRST PAGE
FORM Get current page
FORM LAST PAGE
FORM NEXT PAGE
FORM PREVIOUS PAGE
Product: 4D
Theme: Forms
Number:
247
Modified: 4D 2004.3
Renamed: 4D v12
Modified: 4D v13
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
