## 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

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

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

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

-max and -size options of the panes.

### KEYWORDS

TIX, Container Widget

Last modified Sun Jan 19 22:34:35 EST 1997 --- Serial 853731303