Panel: row

Syntax

row {
    sub_panel>
    ...
}

Description

Row constraint. No panel is created. Child sub-panels within it are automatically stacked horizontally.

Membership

• Panel window

• Tab window

Parameters

None

Switches

• -bc=<color>
  The default background color for children of the row.

• -cr=<file(s)>
  The default image file for children of the row displayable in image form. This should be a Fire image file with multiple cameos. Child sub-panels can then reference cameos within the file via the -cam switch.

• -eq
  Space the sub-panel children equally within the row. This is usually used in combination with the -full switch. Sub-panel justifications and gaps are ignored when this is present.

• -fo=<font>
  The default font for children of the row. This must be a fixed font.

• -full
  Set the width of the row (in pixels) to be the full width of the row’s column parent. The default is for the width to be computed from the sum of the widths of all its child sub-panels.

• -g=<num>
  The default spacing in pixels to be used between adjacent child sub-panels. If omitted, the gap of the parent row or column is used.

• -j=<just>
  The justification of the row within its parent row or column. Within a parent row the value should be one of L, M, R. Within a parent column the value should be one of T, M or B. The default in both cases is M.

• -tc=<color>
  The default text color for children of the row.

Callbacks

None

Notes

No sub-panels are created by the row statement. It is merely a device for controlling the horizontal layout of other sub-panels.

Examples

Create a panel window containing a multi-line text input field and a row with a labelled single-line text field to illustrate the -full feature.

window w = wpanel {
    a: text -r=5,-c=50
    row -full {
        label 'File:'
        f: text -er
    }
}

Create a panel window to illustrate the equal spacing of sub-panels.

window w = wpanel {
    g: wgraphic -dim=<400,200>
    row -full,-eq,-fo=xitalic {
        b1: button 'Apply'
        b2: button 'Cancel'
        b3: button 'Close'
    }
}