NAME

       tixScrolledListBox - Create and manipulate Tix ScrolledListBox widgets

SYNOPSIS

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

WIDGET-SPECIFIC OPTIONS

       [-anchor anchor] Specifies the alignment of the items inside the listbox subwidget.   Only
       the values w and e are allowed. When set to w, the listbox is automatically aligned to the
       beginning of the items.  When set to e, the listbox is automatically aligned to the end of
       the  items.   Automatically alignment only happens when the ScrolledListBox widget changes
       its size.  [-browsecmd browsecmd] Specifies the command to be called when the user browses
       the   elements   inside   the   listbox   subwidget  (see  the  BINDINGS  section  below).
       [-command command] Specifies the command to be called when the user  invokes  the  listbox
       subwidget (see the BINDINGS section below).  [-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.

SUBWIDGETS

       Name:          hsb
       Class:         Scrollbar

              The horizontal scrollbar subwidget.

       Name:          listbox
       Class:         Listbox

              The listbox subwidget inside the ScrolledListBox widget.

       Name:          vsb
       Class:         Scrollbar

              The vertical scrollbar subwidget.

DESCRIPTION

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

WIDGET COMMANDS

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

BINDINGS

       [1]    If the -browsecmd option is set, the command which it referes to is called whenever
              a <ButtonPress-1> or a <Motion-1> event occurrs inside the listbox subwidget.

       [2]    The  command  specified  by  the -command option is invoked when a <Double-1> event
              occurrs inside the listbox subwidget.

BUGS

       The capitalization of some of the commands names in Tix 3.x has been changed in  Tix  4.0.
       All  commands  that  ended  with  box  have  been changed to a capitalized Box. Hence, the
       command tixScrolledListbox in Tix 3.x has been changed to tixScrolledListBox in Tix 4.0

KEYWORDS

       Tix(n)