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

NAME

6       tixScrolledWindow - Create and manipulate Tix ScrolledWindow widgets
7

SYNOPSIS

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

WIDGET-SPECIFIC OPTIONS

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
17              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
27              both   Both scrollbars are shown
28
29              none   The scrollbars are never shown.
30
31              x      Only the horizontal scrollbar is shown;
32
33              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

SUBWIDGETS

43       Name:          hsb
44       Class:         Scrollbar
45
46              The horizontal scrollbar subwidget.
47
48       Name:          window
49       Class:         Frame
50
51              The frame subwidget which is scrolled by the ScrolledWindow wid‐
52              get.
53
54       Name:          vsb
55       Class:         Scrollbar
56
57              The vertical scrollbar subwidget.
58

DESCRIPTION

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

CREATING WIDGETS INSIDE A SCROLLEDWINDOW WIDGET

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
74           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
79       The  following  example  code  is  incorrect because it tries to create
80       immediate children of the ScrolledWindow .w:
81
82           tixScrolledWindow .w; pack .w
83           button .w.b -text hi -width 40 -height 40
84           pack .w.b
85

WIDGET COMMANDS

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
93       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
98       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
103       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
116       pathName subwidget  name ?args?
117              When no additional arguments are given, returns the pathname  of
118              the subwidget of the specified name.
119
120              When  no  additional  arguments are given, the widget command of
121              the specified subwidget will be called with these parameters.
122

KEYWORDS

124       Tix(n)
125
126
127
128
129
130
131Tix                                   4.0                 tixScrolledWindow(n)
Impressum