Panel: window

Syntax

{<name>:} window {<dims>}

Description

Sub-window sub-panel. A rectangular area suitable for later allocation by a user-defined window.

Membership

• Panel window

• Tab window

Parameters

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

• <dims>
  Two numeric values giving the width and height of the sub-window area. This area includes any frame surround, menu bar and scrollbars.

Switches

• -inv
  Make the sub-window invisible on creation.

• -j=<just>
  The justification of the sub-window 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.

• -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.

• -pj=<just>
  The position justification of the sub-panel within the panel window. This combined with the -x and -y switches can be used to position the sub-panel by one of its corners. The default is 'TL'. It also defines the control point to be used when repositioning the sub-panel after creation.

• -sc
  Add permanent scrollbars to the sub-panel. If this option is not present the sub-window must specify whether scrollbars are required and they may or may not be permanently displayed depending on the type of sub-window.

• -x=<num>
  The x position of the sub-window relative to the top-left corner of its parent row or column. If omitted, the sub-window is placed adjacent to the previously defined sub-panel.

• -y=<num>
  The y position of the sub-window relative to the top-left corner of its parent row or column. If omitted, the sub-window is placed below the previously defined sub-panel.

Callbacks

None

Notes

If the type of window which will occupy the sub-window sub-panel is known, e.g. alpha, graphic, then the appropriate window creation command may be used instead of the sub-panel type window, e.g. walpha, wgraphic, wpanel, etc.

Examples

Create a panel window containing four subwindows of known types.

window w = wpanel {
    row {
        w1: wgraphic -dim=<400,300>,-sc
        w2: walpha -dim=<400,300>,-sc
    }
    row {
        w3: wdisplay -dim=<400,300>,-sc
        w4: wtable -dim=<400,300>,-row=10,-sc {
            name: text -bc=white, -c=15, -head = 'Aircraft Name'
            type: options <'747', '737', 'DC10'>, -head = 'Type'
            date1: text -bc=white, -c=15, -head = 'Purchase Date'
            price1: slider 1,10000000,700000, -head = 'Price'
            serv: check_button "In Service"
        }
    }
}

Create a panel window with an empty subwindow to be allocated later. Give it scrollbars.

window w = wpanel {
    pwin: window <200,200>,-sc
}
# Display an image in it
w.pwin = wdisplay myfile.ras