NAME

       tixScrolledWindow - Create and manipulate Tix ScrolledWindow widgets

SYNOPSIS

       tixScrolledWindow        pathName        ?options?        -anchor   -background    -cursor
       -relief   -borderWidth

WIDGET-SPECIFIC OPTIONS

       [-height height]   Specifies   the   desired   height   for   the   window,   in   pixels.
       [-scrollbar scrollbar]  Specifies  the  display  policy  of  the scrollbars. The following
       values are recognized:

              auto ?+x? ?-x? ?+y? ?-y?
                     When -scrollbar is set to "auto", the scrollbars are shown only when needed.
                     Additional modifiers can be used to force a scrollbar to be shown or hidden.
                     For example, "auto -y" means the horizontal scrollbar should be  shown  when
                     needed  but  the vertical scrollbar should always be hidden; "auto +x" means
                     the vertical scrollbar should  be  shown  when  needed  but  the  horizontal
                     scrollbar should always be shown, and so on.

              both   Both scrollbars are shown

              none   The scrollbars are never shown.

              x      Only the horizontal scrollbar is shown;

              y      Only the vertical scrollbar is shown.
       [-width width]    Specifies    the    desired   width   for   the   window,   in   pixels.
       [-xscrollincrement xScrollIncrement] Specifies by how much the window should  be  scrolled
       in  the horizontal direction when the user presses the arrows in the horizontal scrollbar.
       In Pixels.  [-yscrollincrement yScrollIncrement] Specifies by how much the  window  should
       be  scrolled  in the vertical direction when the user presses the arrows in the horizontal
       scrollbar. In pixels.

SUBWIDGETS

       Name:          hsb
       Class:         Scrollbar

              The horizontal scrollbar subwidget.

       Name:          window
       Class:         Frame

              The frame subwidget which is scrolled by the ScrolledWindow widget.

       Name:          vsb
       Class:         Scrollbar

              The vertical scrollbar subwidget.

DESCRIPTION

       The tixScrolledWindow command creates a new window (given by the  pathName  argument)  and
       makes  it  into  a  ScrolledWindow  widget.   Additional  options, described above, may be
       specified on the command line or in the  option  database  to  configure  aspects  of  the
       ScrolledWindow widget such as its cursor and relief.

CREATING WIDGETS INSIDE A SCROLLEDWINDOW WIDGET

       To create widgets inside a ScrolledWindow widget, one must create the new widgets relative
       to the window subwidget and manage them inside the window  subwidget.  An  error  will  be
       generated if one tries to create widgets as immediate children of the ScrolledWindow.  For
       example: the following is correct code,  which  creates  new  widgets  inside  the  window
       subwidget:

           tixScrolledWindow .w; pack .w
           set f [.w subwidget window]
           button $f.b -text hi -width 40 -height 40
           pack $f.b

       The  following  example code is incorrect because it tries to create immediate children of
       the ScrolledWindow .w:

           tixScrolledWindow .w; pack .w
           button .w.b -text hi -width 40 -height 40
           pack .w.b

WIDGET COMMANDS

       The tixScrolledWindow command creates a new Tcl command whose name is the same as the path
       name  of  the  ScrolledWindow 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 ScrolledWindow widget's path
       name.   Option  and  the  args determine the exact behavior of the command.  The following
       commands are possible for ScrolledWindow widgets:

       pathName cget option
              Returns the current value of the configuration option given by option.  Option  may
              have any of the values accepted by the tixScrolledWindow command.

       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 have any of
              the values accepted by the tixScrolledWindow command.

       pathName subwidget  name ?args?
              When  no  additional  arguments are given, returns the pathname of the subwidget of
              the specified name.

              When no additional arguments  are  given,  the  widget  command  of  the  specified
              subwidget will be called with these parameters.

KEYWORDS

       Tix(n)