4D v14.3

FORM GOTO PAGE

Home

 
4D v14.3
FORM GOTO PAGE

FORM GOTO PAGE 


 

FORM GOTO PAGE ( pageNumber {; *} ) 
Parameter Type   Description
pageNumber  Longint in Form page to display
Operator in 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 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.

Example  

The following example is an object method for a button. It displays a specific page, page 3:

 FORM GOTO PAGE(3)

 
PROPERTIES 

Product: 4D
Theme: Forms
Number: 247

 
HISTORY 

Modified: 4D 2004.3
Renamed: 4D v12
Modified: 4D v13

 
SEE ALSO 

FORM FIRST PAGE
FORM Get current page
FORM LAST PAGE
FORM NEXT PAGE
FORM PREVIOUS PAGE

 
ARTICLE USAGE

4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)

Inherited from : FORM GOTO PAGE ( 4D v12.4)
Parent of : FORM GOTO PAGE ( 4D v14 R3)