procedure

:panel name

Creates a secondary frame within the current top level frame for the TCL interpreter.

name is used to generate the path name of the window to be created. It should have the format of a widget name (e.g. :panel P) and should be unique within this interpreter. The name will be lower-cased (using the string tolower command) in order to generate the path name used to create the window.

The path name generated has the form .framename.panelname.

The :panel procedure may have a number of arguments however none of these is mandatory.

number is the x-co-ordinate within the current frame of the panel window in pixels

e.g. :x 400

number is the y-co-ordinate within the current frame of the panel window in pixels

e.g. :y 200

The :x and :y parameters may be omitted in which case the packer geometry manager will be used and the position of the window will be determined by the contents of the master (frame) window. If however the :x and :y parameters are supplied then the placer geometry manager will be used to position the window within the master (frame) window.

Warning: Note that it is not possible to mix use of the packer and placer geometry managers within the same window. Thus all panels must request or imply that the same geometry manager is used.

:w number

number is the width of the window in pixels.

e.g. :w 200

:h number

number is the height of the window in pixels.

e.g. :h 60

The :w and :h parameters may be omitted in which case the size of the window will be determined by its contents. If however the :w and :h parameters are supplied then these will be used to configure the panel window.

:anchor where

where should be a valid window point to be used when placing or packing the panel window within the frame window. The parameter supplied is made the default to be used for any windows created within the panel.

Valid points are n,s,e,w,nw,ne,se,sw The default anchor point is nw.

:layout L|H|T|V|R|B

Determines which side of the master (frame) this panel window should be packed. L and H pack to side left; T and V pack to side top; R packs to side right and B packs to side bottom. If R (right) is specified then the anchor point is set to ne by default. The layout parameter is used for the panel window only if the window is to be packed within the frame. That is only if :x and :y are not specified. However the parameter supplied is made the default to be used for any windows created within the panel.

The default is that layout left is used

:expand option

option should be any valid value for the -expand configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the expand yes is used.

:fill option

option should be any valid value for the -fill configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the fill both is used.

:ipadx value

value should be any valid value for the -ipadx configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the ipadx 0 is used.

:ipady value

value should be any valid value for the -ipady configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the ipady 0 is used.

:padx value

value should be any valid value for the -padx configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the padx 0 is used.

:pady value

value should be any valid value for the -pady configuration option to be used by the packer geometry manager. The parameter supplied is made the default to be used for any windows created within the panel.

The default is the pady 0 is used.

:row-gap number

number is the additional space (in pixels) to be allowed in addition to one character height between rows of windows created within the panel window (see :next-row procedure). The placer geometry manager is selected to be used for all widgets created within the panel window.

By default row-gap is set to 0 and the geometry manager selected is the packer

:col-gap number

number is the additional space (in pixels) to be allowed in addition to one character width between columns of windows created within the panel window (see :next-col procedure). The placer geometry manager is selected to be used for all widgets created within the panel window.

By default col-gap is set to 0 and the geometry manager selected is the packer.

See also common procedure arguments defined later in this document.