tixPanedWindow(n)					       Tix Built-In Commands						 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.	[-dynamicgeometry 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.  [-han-
	      dleactivebg handleActiveBg] Specifies the active background color of the resize handles. When the mouse cursor enters a resize  han-
	      dle,  the  resize  handle will adopt the active background color.  [-handlebg handleBg] Specifies the normal background color of the
	      resize handles.  [-height height] Specifies the desired height for the window.  [-orientation orientation] Specifies the orientation
	      of  the  panes.  Must be either vertical or horizontal.  [-paneborderwidth or -panebd paneBorderWidth] Specifies the border width of
	      the panes.  [-panerelief paneRelief] Specifies the border relief of the panes.  [-separatoractivebg separatorActiveBg] Specifies the
	      active  background  color  of  the  separators. When the user grabs a resize handle, the separators will adopt the active background
	      color.  [-separatorbg separatorBg] Specifies the normal background color of the separators.  [-width 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 pane-
       Name 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 the same as the path name of the PanedWindow widget's window.  This com-
       mand 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  con-
	      figure 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 val-
	      ues 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 handles. The change in the panes' sizes may be subjected to the -min, -max and
       -size options of the panes.

KEYWORDS

       TIX, Container Widget

Tix									4.0							 tixPanedWindow(n)