Form file structure / LAYOUT section |
Defines a page of a folder tab in a FOLDER parent container.
PAGE [identifier] [ ( attribute [,...] ) ] layout-container [...] END
A PAGE container can only be a child of a FOLDER container.
By default PAGE containers are used to group elements for decoration only.
With the TABINDEX form field attribute, you can define which field gets the focus when a folder page is selected.
The TEXT attributes defines the label of the folder page.
The IMAGE attribute can be used to specify which image to use as an icon.
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. However, this feature should be used with care: It exists to implement different singular dialog statements (such as INPUT) in each folder page. You should rather use a DIALOG statement to control all folder pages simultaneously.
To bring a folder page to the top, use 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 elements.
FOLDER PAGE p1 ( TEXT="Global info" ) GRID { ... } END END PAGE p2 ( IMAGE="list" ) TABLE { ... } END END END