1tixScrolledWindow(n) Tix Built-In Commands tixScrolledWindow(n)
2
6 tixScrolledWindow - Create and manipulate Tix ScrolledWindow widgets
7
9 tixScrolledWindow pathName ?options? -anchor -background -cursor
10 -relief -borderWidth
11
13 [-height height] Specifies the desired height for the window, in pix‐
14 els. [-scrollbar scrollbar] Specifies the display policy of the
15 scrollbars. The following values are recognized:
16 auto ?+x? ?-x? ?+y? ?-y?
18 When -scrollbar is set to "auto", the scrollbars are
19 shown only when needed. Additional modifiers can be used
20 to force a scrollbar to be shown or hidden. For example,
21 "auto -y" means the horizontal scrollbar should be shown
22 when needed but the vertical scrollbar should always be
23 hidden; "auto +x" means the vertical scrollbar should be
24 shown when needed but the horizontal scrollbar should
25 always be shown, and so on.
26 both Both scrollbars are shown
28 none The scrollbars are never shown.
30 x Only the horizontal scrollbar is shown;
32 y Only the vertical scrollbar is shown.
34 [-width width] Specifies the desired width for the window, in pixels.
35 [-xscrollincrement xScrollIncrement] Specifies by how much the window
36 should be scrolled in the horizontal direction when the user presses
37 the arrows in the horizontal scrollbar. In Pixels. [-yscrollincre‐
38 ment yScrollIncrement] Specifies by how much the window should be
39 scrolled in the vertical direction when the user presses the arrows in
40 the horizontal scrollbar. In pixels.
41
43 Name: hsb
44 Class: Scrollbar
45 The horizontal scrollbar subwidget.
47 Name: window
49 Class: Frame
50 The frame subwidget which is scrolled by the ScrolledWindow wid‐
52 get.
53 Name: vsb
55 Class: Scrollbar
56 The vertical scrollbar subwidget.
58
60 The tixScrolledWindow command creates a new window (given by the path‐
61 Name argument) and makes it into a ScrolledWindow widget. Additional
62 options, described above, may be specified on the command line or in
63 the option database to configure aspects of the ScrolledWindow widget
64 such as its cursor and relief.
65
67 To create widgets inside a ScrolledWindow widget, one must create the
68 new widgets relative to the window subwidget and manage them inside the
69 window subwidget. An error will be generated if one tries to create
70 widgets as immediate children of the ScrolledWindow. For example: the
71 following is correct code, which creates new widgets inside the window
72 subwidget:
73 tixScrolledWindow .w; pack .w
75 set f [.w subwidget window]
76 button $f.b -text hi -width 40 -height 40
77 pack $f.b
78 The following example code is incorrect because it tries to create
80 immediate children of the ScrolledWindow .w:
81 tixScrolledWindow .w; pack .w
83 button .w.b -text hi -width 40 -height 40
84 pack .w.b
85
87 The tixScrolledWindow command creates a new Tcl command whose name is
88 the same as the path name of the ScrolledWindow widget's window. This
89 command may be used to invoke various operations on the widget. It has
90 the following general form:
91 pathName option ?arg arg ...?
92 PathName is the name of the command, which is the same as the Scrolled‐
94 Window widget's path name. Option and the args determine the exact
95 behavior of the command. The following commands are possible for
96 ScrolledWindow widgets:
97 pathName cget option
99 Returns the current value of the configuration option given by
100 option. Option may have any of the values accepted by the
101 tixScrolledWindow command.
102 pathName configure ?option? ?value option value ...?
104 Query or modify the configuration options of the widget. If no
105 option is specified, returns a list describing all of the avail‐
106 able options for pathName (see Tk_ConfigureInfo for information
107 on the format of this list). If option is specified with no
108 value, then the command returns a list describing the one named
109 option (this list will be identical to the corresponding sublist
110 of the value returned if no option is specified). If one or
111 more option-value pairs are specified, then the command modifies
112 the given widget option(s) to have the given value(s); in this
113 case the command returns an empty string. Option may have any
114 of the values accepted by the tixScrolledWindow command.
115 pathName subwidget name ?args?
117 When no additional arguments are given, returns the pathname of
118 the subwidget of the specified name.
119 When no additional arguments are given, the widget command of
121 the specified subwidget will be called with these parameters.
122
124 Tix(n)
125Tix 4.0 tixScrolledWindow(n)