User Tools

Site Tools


SUB PANE

Guide Section: An EASAP GUI
EASAP Tree: USER INTERFACE > FORM LIST or TABBED PANE LIST > FORM or TABBED PANE


A SUB PANE creates a rectangular area in the GUI to group data entry and display objects.

A common use case use involves an arrangement of other SUB PANEs in a rectangular table.

For example to create a parent SUB PANE or LAYOUT PANEL with 2 rows x 3 columns (eg. for six child GUI objects):

  • Set:
    Layout: GRID
    Grid: 2, 3
    Show Border: FALSE

SUB PANE
Optional Parameters:
Border:Enter a literal string or SCALAR and/or LIST references for a label to display at the top of a SUB PANE
Show if:Enter a logical expression to apply to this object and any child objects
This object is shown if this object's and every parent's Show if: is true (ie. parent of parent, and so on up the Tree)
Default: true
Enable if:Enter a logical expression or leave blank to inherit expression from the first non-blank parent Enable if:
If expression is true object is enabled, otherwise object is greyed-out and disabled
Default: <blank> (ie. inherit expression from parent, or if parent is <blank>, parent of parent…, up the Tree)
Top level Enable if: is true by default, thus a chain of objects with the default Enable if: <blank> are enabled
Layout:Specify placement of child objects within a SUB PANE
Default: VERTICAL, HORIZONTAL, HORIZONTAL FLOW, or GRID (in which case Grid: must be set)
Grid: If Layout: GRID, Grid: will define the dimensions of a ' rows x columns ' grid for child objects using integers in the form ' rows, columns ' (eg. ' 5, 7 'for a 'calendar month grid of days')
Show Border:Show border rectangle
Default: TRUE, FALSE
Label Width:Set a width in pixels for all object labels in SUB PANE
Style:Set a literal string, a USER INTERFACE STYLE or SCALAR reference that controls the visual appearance of this SUB PANE
Column Widths: Row Heights:Fixed by the Excel Range Wizard in 'Spreadsheet compatibility' mode.
To modify these values, convert the SUB PANE: right-click it and select: Change Object Type > to LAYOUT PANEL
The new object will have Style: settings imported from Excel but now modifiable by an Author
Style to Child:Set to TRUE so child objects inherit the Style: of this SUB PANE
Default: FALSE
Each child's Style: must be left blank or else it will take precedence over the parent's Style:
Show If Mode:Set to ROW HIDING so the entire row of objects will be hidden when Show If: is false
This prevents a GRID layout from collapsing
Default: NORMAL, ROW HIDING
Rowspan:Set a number of cells to span vertically downward in a parent LAYOUT PANEL or SUB PANE with Layout: GRID
Colspan:Set a number of cells to span horizontally across to the right in a parent LAYOUT PANEL or SUB PANE with Layout: GRID