tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
_________________________________________________________________
NAME
tixPanedWindow - Create and manipulate tixPanedWindow
widgets
SYNOPSIS
tixPanedWindow pathName ?options?
STANDARD OPTIONS
The PanedWindow widget supports all the standard options of
a frame widget. See the options(n) manual entry for details
on the standard options.
WIDGET-SPECIFIC OPTIONS
Name: command
Class: Command
Switch: -command
Specifies the command to invoke when the panes change
their sizes. This command is called with a list of
integers that record the new sizes of the panes. The
sizes of the panes are listed in the order of the
panes' creation.
Name: dynamicGeometry
Class: DynamicGeometry
Switch: -dynamicgeometry
If set to true, the size of the PanedWindow will
dynamically change if the size of any of its panes
changes. Otherwise, the size of the PanedWindow will
only increase when size of any of its panes changes and
will not decrease. The default value is true.
Name: handleActiveBg
Class: HandleActiveBg
Switch: -handleactivebg
Specifies the active background color of the resize
handles. When the mouse cursor enters a resize handle,
the resize handle will adopt the active background
color.
Name: handleBg
Class: Background
Switch: -handlebg
Specifies the normal background color of the resize
handles.
Name: height
Page 1 (printed 12/22/98)
tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
Class: Height
Switch: -height
Specifies the desired height for the window.
Name: orientation
Class: Orientation
Switch: -orientation
Alias: -orient
Specifies the orientation of the panes. Must be either
vertical or horizontal.
Name: paneBorderWidth
Class: PaneBorderWidth
Switch: -paneborderwidth
Alias: -panebd
Specifies the border width of the panes.
Name: paneRelief
Class: PaneRelief
Switch: -panerelief
Specifies the border relief of the panes.
Name: separatorActiveBg
Class: SeparatorActiveBg
Switch: -separatoractivebg
Specifies the active background color of the
separators. When the user grabs a resize handle, the
separators will adopt the active background color.
Name: separatorBg
Class: Background
Switch: -separatorbg
Specifies the normal background color of the
separators.
Name: width
Class: Width
Switch: -width
Specifies the desired width for the window.
SUBWIDGETS
All the pane subwidgets created as a result of the add
command can be accessed by the subwidget command. They are
identified by the paneName parameter to the add command.
_________________________________________________________________
Page 2 (printed 12/22/98)
tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
DESCRIPTION
The tixPanedWindow command creates a new window (given by
the pathName argument) and makes it into a PanedWindow
widget. Additional options, described above, may be
specified on the command line or in the option database to
configure aspects of the PanedWindow widget such as its
cursor and relief.
The PanedWindow widget allows the user to interactively
manipulate the sizes of several panes. The panes can be
arranged either vertically or horizontally. Each individual
pane may have upper and lower limits of its size. The user
changes the sizes of the panes by dragging the resize handle
between two panes.
WIDGET COMMAND
The tixPanedWindow command creates a new Tcl command whose
name is the same as the path name of the PanedWindow
widget's window. This command may be used to invoke various
operations on the widget. It has the following general
form:
pathName option ?arg arg ...?
PathName is the name of the command, which is the same as
the frame widget's path name. Option and the args determine
the exact behavior of the command. The following commands
are possible for PanedWindow widgets:
pathName add paneName ?option value ...?
Adds a new pane subwidget with the name paneName into
the PanedWindow widget. Additional configuration
options can be given to configure the new button
subwidget. Three configuration options are supported:
-after pane
Specifies that the new pane should be placed after
pane in the list of panes in this PanedWindow
widget. -at integer Specifies the position of the
new pane in the list of panes in this PanedWindow
widget. 0 means the first position, 1 means the
second, and so on. In addition, end means the end
of the list.
-before pane
Specifies that the new pane should be placed
before pane in the list of panes in this
PanedWindow widget.
-expand factor
Specifies the expand/shrink factor of this pane.
Factor must be a non-negative floating point
Page 3 (printed 12/22/98)
tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
number. The default value is 0.0. The
expand/shrink factor is used to calculate how much
each pane should grow or shrink when the size of
the PanedWindow main window is changed. When the
main window expands/shrinks by n pixels, then pane
i will grow/shrink by about n * factor(i) /
summation(factors), where factor(i) is the
expand/shrink factor of pane i and
summation(factors) is the summation of the
expand/shrink factors of all the panes. If
summation(factors) is 0.0, however, only the last
visible pane will be grown or shrunk.
-min integer
Specifies the minimum size, in pixels, of the new
pane; the default is 0.
-max integer
Specifies the maximum size, in pixels, of the new
pane; the default is 10000.
-size integer
Specifies the size, in pixels, of the new pane; if
the -size option is not given, or set to the empty
string, the PanedWindow widget will use the
natural size of the pane subwidget.
pathName cget option
Returns the current value of the configuration option
given by option. Option may be -min, -max and/or -size,
or any option accepted by the Tk frame widget.
pathName configure ?option? ?value option value ...?
Query or modify the configuration options of the
widget. If no option is specified, returns a list
describing all of the available options for pathName
(see Tk_ConfigureInfo for information on the format of
this list). If option is specified with no value, then
the command returns a list describing the one named
option (this list will be identical to the
corresponding sublist of the value returned if no
option is specified). If one or more option-value
pairs are specified, then the command modifies the
given widget option(s) to have the given value(s); in
this case the command returns an empty string. Option
may be any of the non-static options of the PanedWindow
widget.
pathName delete paneName
Removes the pane given by paneName and deletes its
contents.
Page 4 (printed 12/22/98)
tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
pathName forget paneName
Removes the pane given by paneName but does not delete
its contents. This pane can be later added back to the
PanedWindow widget by the manage method.
pathName manage paneName ?option value ...?
Adds the pane given by paneName back to the PanedWindow
widget. PaneName must be already forgotten by the
forget method. Additional option-value pairs, same as
those accepted by the add method, can be given to
control the appearance and position of the pane.
pathName panecget paneName option
Returns the current value of the configuration option
given by option in the pane given by paneName. Option
may have any of the values accepted by the add widget
command.
pathName paneconfigure paneName ?option? ?value ...?
When no option is given, prints out the values of all
options of this pane. If option is specified with no
value, then the command returns the current value of
that option. If one or more option-value pairs are
specified, then the command modifies the given pane's
option(s) to have the given value(s); in this case the
command returns an empty string. Option may be -min,
-max and/or -size, or any option accepted by the Tk
frame widget. The sizes of the panes may be changed as
a result of calling the paneconfigure command.
pathName panes
Returns a list of the names of all panes.
pathName setsize paneName newSize ?direction?
Sets the size of the pane specified by paneName to
newSize. The direction parameter specifies in which
direction the pane should grow/shrink. Possible values
are next: the pane will grow or shrink by moving the
boundary between itself and the pane to its right or
bottom; prev: the pane will grow or shrink by moving
the boundary between itself and the pane to its left or
top.
pathName subwidget name ?args?
When no options are given, returns the pathname of the
subwidget of the specified name.
When options are given, the widget command of the
specified subwidget will be called with these options.
BINDINGS
The panes' sizes will be changed when the user drags the
Page 5 (printed 12/22/98)
tixPanedWindow(n) Tix (4.0) tixPanedWindow(n)
handles. The change in the panes' sizes may be subjected to
the -min, -max and -size options of the panes.
KEYWORDS
TIX, Container Widget
Page 6 (printed 12/22/98)