Folder page - stacking

A Folder container is used to display children (Pages) inside a Folder tab.

The Folder container manages the Page containers displayed as tabs. You can add or remove and order the Pages using the right-click contextual menu on the Folder or Page object on the form.

Example

Figure: Folder and Pages


This figure shows an example of folder and page containers.

Folder Properties (by group)

Object: name, tag, style

Geometry: posX, posY, gridHeight, gridWidth

Display: hidden, fontPitch

Comment: comment, localizedStr

Page Properties (by group)

Object: name, tag, style

Display: hidden, image

Text: text, localizedStr

Comment: comment, localizedStr

Miscellaneous: action

Usage

The text property defines the label of the folder page. The image property can be used to specify which image to use as an icon.

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

To bring a folder page to the top, in your source code, use NEXT FIELD to one of the active fields of the page (The NEXT FIELD field-name instruction gives the focus to the specified field.) or use the ui.Form.ensureFieldVisible() method if the fields are disabled/unused or the ui.Form.ensureElementVisible() method if the page does not contain focusable elements.

With the tabIndex property of a field in a Page, you can define which field gets the focus when a Page is selected.