1tixScrolledListBox(n)        Tix Built-In Commands       tixScrolledListBox(n)
2
3
4

NAME

6       tixScrolledListBox - Create and manipulate Tix ScrolledListBox widgets
7

SYNOPSIS

9       tixScrolledListBox pathName ?options?  -anchor   -background    -cursor
10       -relief   -borderWidth
11

WIDGET-SPECIFIC OPTIONS

13       [-anchor anchor] Specifies the alignment of the items inside the  list‐
14       box subwidget.  Only the values w and e are allowed. When set to w, the
15       listbox is automatically aligned to the beginning of the  items.   When
16       set to e, the listbox is automatically aligned to the end of the items.
17       Automatically alignment only happens when  the  ScrolledListBox  widget
18       changes  its  size.  [-browsecmd browsecmd] Specifies the command to be
19       called when the user browses the elements inside the listbox  subwidget
20       (see  the  BINDINGS  section  below).  [-command command] Specifies the
21       command to be called when the user invokes the listbox  subwidget  (see
22       the  BINDINGS  section  below).  [-height height] Specifies the desired
23       height for the window, in pixels.  [-scrollbar scrollbar] Specifies the
24       display policy of the scrollbars. The following values are recognized:
25
26              auto ?+x? ?-x? ?+y? ?-y?
27                     When  -scrollbar  is  set  to  "auto", the scrollbars are
28                     shown only when needed. Additional modifiers can be  used
29                     to  force a scrollbar to be shown or hidden. For example,
30                     "auto -y" means the horizontal scrollbar should be  shown
31                     when  needed  but the vertical scrollbar should always be
32                     hidden; "auto +x" means the vertical scrollbar should  be
33                     shown  when  needed  but  the horizontal scrollbar should
34                     always be shown, and so on.
35
36              both   Both scrollbars are shown
37
38              none   The scrollbars are never shown.
39
40              x      Only the horizontal scrollbar is shown;
41
42              y      Only the vertical scrollbar is shown.
43       [-width width] Specifies the desired width for the window, in pixels.
44

SUBWIDGETS

46       Name:          hsb
47       Class:         Scrollbar
48
49              The horizontal scrollbar subwidget.
50
51       Name:          listbox
52       Class:         Listbox
53
54              The listbox subwidget inside the ScrolledListBox widget.
55
56       Name:          vsb
57       Class:         Scrollbar
58
59              The vertical scrollbar subwidget.
60

DESCRIPTION

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

WIDGET COMMANDS

69       The tixScrolledListBox command creates a new Tcl command whose name  is
70       the  same as the path name of the ScrolledListBox widget's window. This
71       command may be used to invoke various operations on the widget. It  has
72       the following general form:
73              pathName option ?arg arg ...?
74
75       PathName  is  the  name  of  the  command,  which  is  the  same as the
76       ScrolledListBox widget's path name. Option and the args  determine  the
77       exact behavior of the command.  The following commands are possible for
78       ScrolledListBox widgets:
79
80       pathName cget option
81              Returns the current value of the configuration option  given  by
82              option.  Option  may  have  any  of  the  values accepted by the
83              tixScrolledListBox command.
84
85       pathName configure ?option? ?value option value ...?
86              Query or modify the configuration options of the widget.  If  no
87              option is specified, returns a list describing all of the avail‐
88              able options for pathName (see Tk_ConfigureInfo for  information
89              on  the  format  of  this list).  If option is specified with no
90              value, then the command returns a list describing the one  named
91              option (this list will be identical to the corresponding sublist
92              of the value returned if no option is  specified).   If  one  or
93              more option-value pairs are specified, then the command modifies
94              the given widget option(s) to have the given value(s);  in  this
95              case  the  command returns an empty string.  Option may have any
96              of the values accepted by the tixScrolledListBox command.
97
98       pathName subwidget  name ?args?
99              When no additional arguments are given, returns the pathname  of
100              the subwidget of the specified name.
101
102              When  no  additional  arguments are given, the widget command of
103              the specified subwidget will be called with these parameters.
104

BINDINGS

106       [1]    If the -browsecmd option is set, the command which it referes to
107              is  called  whenever  a  <ButtonPress-1>  or  a <Motion-1> event
108              occurrs inside the listbox subwidget.
109
110       [2]    The command specified by the -command option is invoked  when  a
111              <Double-1> event occurrs inside the listbox subwidget.
112

BUGS

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

KEYWORDS

120       Tix(n)
121
122
123
124
125
126
127Tix                                   4.0                tixScrolledListBox(n)
Impressum