PAGE container

Defines a page of a folder tab in a FOLDER parent container.

Syntax

PAGE [identifier] [ ( attribute [,...] ) ]
  layout-container
  [...] 
END
  1. identifier defines the name of the element.
  2. attribute is an attribute for the element.
  3. layout-container is another child container.

Attributes

ACTION, COMMENT, HIDDEN, IMAGE, STYLE, TAG, TEXT.

Can hold

VBOX, HBOX, GROUP, FOLDER, GRID, SCROLLGRID, TABLE, TREE

Usage

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