tixPanedWindow - Create and manipulate tixPanedWindow widgets

       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.

       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.

       TIX, Container Widget

Tix                                                    4.0                                                TIX(3)

       tixPanedWindow - Create and manipulate tixPanedWindow widgets

       The  PanedWindow  widget  supports  all the standard options of a frame widget. See the options(n) manual
       entry for details on the standard options.

       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.

tixPanedWindowpathName ?options?

       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:
              pathNameoption ?argarg...?
       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:

       pathNameaddpaneName ?optionvalue...?
              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:

              -afterpane
                     Specifies that the new pane should be placed after pane  in  the  list  of  panes  in  this
                     PanedWindow widget.

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

              -beforepane
                     Specifies  that  the  new  pane  should  be placed before pane in the list of panes in this
                     PanedWindow widget.

              -expandfactor
                     Specifies the expand/shrinkfactor 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.

              -mininteger
                     Specifies the minimum size, in pixels, of the new pane; the default is 0.

              -maxinteger
                     Specifies the maximum size, in pixels, of the new pane; the default is 10000.

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

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

       pathNameconfigure ?option? ?valueoptionvalue...?
              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.

       pathNamedeletepaneName
              Removes the pane given by paneName and deletes its contents.

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

       pathNamemanagepaneName ?optionvalue...?
              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.

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

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

       pathNamepanes
              Returns a list of the names of all panes.

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

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

       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.  [-dynamicgeometrydynamicGeometry] 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.  [-handleactivebghandleActiveBg] 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.  [-handlebghandleBg] Specifies the normal background color of the
              resize   handles.    [-heightheight]   Specifies   the   desired   height   for   the   window.
              [-orientationorientation]  Specifies  the  orientation  of the panes. Must be either vertical or
              horizontal.  [-paneborderwidthor-panebd paneBorderWidth] Specifies the border width of the  panes.
              [-panereliefpaneRelief]     Specifies     the     border     relief     of     the     panes.
              [-separatoractivebgseparatorActiveBg] Specifies the active background color  of  the  separators.
              When  the  user  grabs  a  resize  handle,  the separators will adopt the active background color.
              [-separatorbgseparatorBg]  Specifies  the   normal   background   color   of   the   separators.
              [-widthwidth] Specifies the desired width for the window.