1tixScrolledListBox(n) Tix Built-In Commands tixScrolledListBox(n)
2
6 tixScrolledListBox - Create and manipulate Tix ScrolledListBox widgets
7
9 tixScrolledListBox pathName ?options? -anchor -background -cursor
10 -relief -borderWidth
11
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 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 both Both scrollbars are shown
37 none The scrollbars are never shown.
39 x Only the horizontal scrollbar is shown;
41 y Only the vertical scrollbar is shown.
43 [-width width] Specifies the desired width for the window, in pixels.
44
46 Name: hsb
47 Class: Scrollbar
48 The horizontal scrollbar subwidget.
50 Name: listbox
52 Class: Listbox
53 The listbox subwidget inside the ScrolledListBox widget.
55 Name: vsb
57 Class: Scrollbar
58 The vertical scrollbar subwidget.
60
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
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 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 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 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 pathName subwidget name ?args?
99 When no additional arguments are given, returns the pathname of
100 the subwidget of the specified name.
101 When no additional arguments are given, the widget command of
103 the specified subwidget will be called with these parameters.
104
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 [2] The command specified by the -command option is invoked when a
111 <Double-1> event occurrs inside the listbox subwidget.
112
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
120 Tix(n)
121Tix 4.0 tixScrolledListBox(n)