PAGE item type

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: This feature should be used with care: It exists to implement different singular dialog statements (such as INPUT) in each folder page. You should 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 two different ways:

As a PAGE container in a LAYOUT tree, within a grid-based layout.
As a PAGE stack item, inside a STACK container, within a stack-based layout.