PAGE item type

Defines the content of a folder page.

PAGE item basics

A PAGE form item type groups other form elements together, to define a folder page of a parent FOLDER form item.

Defining an PAGE

A PAGE form item can only be a child of a FOLDER form item.

By default, PAGE form items are used to group elements for decoration only.

Note: Use the TABINDEX attribute of form fields inside the folder page, to define which field gets the focus when a folder page is selected.

The TEXT attributes defines the label of the folder page. Consider using localized strings for this attribute.

The IMAGE attribute can be used to specify which image to use as an icon.

Detecting folder page selection

If needed, you can use the ACTION attribute to bind an action to a folder page. When the page is selected, the program gets the corresponding action event.

Note: Binding a folder page to an ON ACTION handler with the ACTION attribute is supported to implement different singular dialog statements (INPUT) to handle each folder page. This was the old method to control folder pages. It is now recommended that you use a DIALOG statement, to control all folder pages simultaneously.

Bring a folder page to the top

To bring a folder page to the top, use the NEXT FIELD program instruction to give the focus to one of the active fields of the page, or use the ui.Form.ensureFieldVisible() method if the fields are disabled/unused, or use the ui.Form.ensureElementVisible() method if the page does not contain focusable form items.

For more details, see Giving the focus to a form element.

Where to use a PAGE

A PAGE form item can be defined in different ways:
  1. As a PAGE container in a LAYOUT tree, within a grid-based layout.
  2. As a PAGE stack item, inside a STACK container, within a stack-based layout.