NAME

       tixPanedWindow - Create and manipulate tixPanedWindow wid­
       gets


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.

       Command-Line Name:-dynamicgeometry
       Database Name:  dynamicGeometry
       Database Class: 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.

       Command-Line Name:-handleactivebg
       Database Name:  handleActiveBg
       Database Class: 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 back­
              ground color.

       Command-Line Name:-handlebg
       Database Name:  handleBg
       Database Class: Background

              Specifies the normal background color of the resize
              handles.

       Command-Line Name:-height
       Database Name:  height


              Specifies the desired height for the window.

       Command-Line Name:-orientation
       Database Name:  orientation
       Database Class: Orientation

              Specifies  the  orientation  of  the panes. Must be
              either vertical or horizontal.

       Command-Line Name:-paneborderwidth or -panebd
       Database Name:  paneBorderWidth
       Database Class: PaneBorderWidth

              Specifies the border width of the panes.

       Command-Line Name:-panerelief
       Database Name:  paneRelief
       Database Class: PaneRelief

              Specifies the border relief of the panes.

       Command-Line Name:-separatoractivebg
       Database Name:  separatorActiveBg
       Database Class: SeparatorActiveBg

              Specifies the active background color of the  sepa­
              rators.  When  the  user grabs a resize handle, the
              separators will adopt the active background  color.

       Command-Line Name:-separatorbg
       Database Name:  separatorBg
       Database Class: Background

              Specifies  the normal background color of the sepa­
              rators.

       Command-Line Name:-width
       Database Name:  width
       Database Class: 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

       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 individ­
       ual 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 wid­
       get'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 deter­
       mine 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  configura­
              tion options can be given to configure the new but­
              ton subwidget. Three configuration options are sup­
              ported:

              -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  wid­
                     get. 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

                     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 summa­
                     tion(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  path­
              Name  (see  Tk_ConfigureInfo for information on the
              format of this list).  If option is specified  with
              no  value, then the command returns a list describ­
              ing the one named option (this list will be identi­
              cal  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

              method.

       pathName manage paneName ?option value ...?
              Adds  the pane given by paneName back to the Paned­
              Window 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 pane­
              Name. 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 speci­
       fied 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.

       TIX, Container Widget


Man(1) output converted with man2html