Panel: separator

Syntax

{<name>:} separator

Description

Separator sub-panel. A decorative separating line between other sub-panels.

Membership

• Panel window

• Tab window

• Menupane

Parameters

• <name>
  A name to be given to the sub-panel for reference purposes.

Switches

• -h=<num>
  The height of the separator in pixels. Using this switch indicates that the separator is a vertical line.

• -link=<text>
  The resize linkage for the panel. This ties panel edges to one or more edges of the parent window, with the result that when the parent window gets resized, the panel gets automatically resized as well. <text> is a combination of the characters L, R, T, B and M. A value of "LRTB" means that the left, right, top and bottom edges of a sub-panel are linked to its parent. The default value is "TL", which links the left and top edges to the parent window but does no resizing because its right and bottom edges are not linked. Note that the linkage is to edges of the parent window, not to column/row extremities. More complicated linkage requirements should be done via the window.resize callback on the parent window.

• -w=<num>
  The width of the separator in pixels. Using this switch indicates that the separator is a horizontal line.

Callbacks

None

Notes

If no dimensions are supplied (-h or -w) the relevant width/height is computed from its parent row/column.

Examples

Create a panel window containing two rows, each containing a labeled text input sub-panel. Use a separator between rows.

window w = wpanel {
    row -full {
        label 'Name:'
        nam: text -bc=white,-c=32
    }
    separator ;# Column mode, separator is horizontal.
    row -full {
        label 'Address:'
        add: text -r=5,-c=48,-bc=white
    }
}

Create a panel window containing two separated check-buttons.

window w = wpanel {
    row {
        save: check_button 'Auto-Save',-q
        separator ;# row mode, separator is vertical
        bakup: check_button 'Keep Back-ups',-q
    }
}