1iwidgets::scrolledframe − Create and manipulate scrolled frame
2widgets iwidgets::scrolledframe pathName ?options? itk::Widget
3<‐ iwidgets::Labeledwidget <‐ iwidgets::Scrolledwidget <‐ iwid‐
4gets::Scrolledframe
8See the "options" manual entry for details on the standard op‐
9tions.
11See the "scrollbar" manual entry for details on the associated
12options.
15See the "labeledwidget" class manual entry for details on the in‐
16herited options.
17Name: height
18Class: Height
19Command‐Line Switch: ‐height
20Specifies the height of the scrolled frame widget in any of the
21forms acceptable to Tk_GetPixels. The default height is 100 pix‐
22els.
23Name: hscrollMode
24Class: ScrollMode
25Command‐Line Switch: ‐hscrollmode
26Specifies the the display mode to be used for the horizontal
27scrollbar: static, dynamic, or none. In static mode, the scroll
28bar is displayed at all times. Dynamic mode displays the scroll
29bar as required, and none disables the scroll bar display. The
30default is static.
31Name: sbWidth
32Class: Width
33Command‐Line Switch: ‐sbwidth
34Specifies the width of the scrollbar in any of the forms accept‐
35able to Tk_GetPixels. The default width is 15 pixels.
36Name: scrollMargin
37Class: Margin
38Command‐Line Switch: ‐scrollmargin
39Specifies the distance between the frame and scrollbar in any of
40the forms acceptable to Tk_GetPixels. The default is 3 pixels.
41Name: vscrollMode
42Class: ScrollMode
43Command‐Line Switch: ‐vscrollmode
44Specifies the the display mode to be used for the vertical
45scrollbar: static, dynamic, or none. In static mode, the scroll
46bar is displayed at all times. Dynamic mode displays the scroll
47bar as required, and none disables the scroll bar display. The
48default is static.
49Name: width
50Class: Width
51Command‐Line Switch: ‐width
52Specifies the width of the scrolled frame widget in any of the
53forms acceptable to Tk_GetPixels. The default height is 100 pix‐
54els.
55The scrolledframe combines the functionallity of scrolling with
57that of a typical frame widget to implement a clipable viewing
58area whose visible region may be modified with the scroll bars.
59This enables the contruction of visually larger areas than which
60could normally be displayed, containing a heterogenous mix of
61other widgets. Options exist which allow full control over which
62scrollbars are displayed and the method, i.e. statically or dy‐
63namically. The frame itself may be accessed by the childsite
64method and then filled with other widget combinations.
65The iwidgets::scrolledframe command creates a new Tcl command
67whose name is pathName. This command may be used to invoke vari‐
68ous operations on the widget. It has the following general form:
70exact behavior of the command. The following commands are possi‐
71ble for scrolledframe widgets:
73See the "canvas" manual entry for details on the associated meth‐
74ods.
75
77tion option given by option. Option may have any of the values
78accepted by the iwidgets::scrolledframe command. pathName child‐
80?option? ?value option value ...? Query or modify the configura‐
81tion options of the widget. If no option is specified, returns a
82list describing all of the available options for pathName (see
85list describing the one named option (this list will be identical
86to the corresponding sublist of the value returned if no option
87is specified). If one or more option−value pairs are specified,
88then the command modifies the given widget option(s) to have the
89given value(s); in this case the command returns an empty
90string. Option may have any of the values accepted by the iwid‐
92fies the frame contents via the scroll bars in one of four direc‐
93tions: left, right, top, or bottom.
94Name: horizsb
96Class: Scrollbar
97The horizsb component is the horizontal scroll bar. See the
98"ScrollBar" widget manual entry for details on the horizsb compo‐
99nent item.
100Name: vertsb
101Class: Scrollbar
102The vertsb component is the vertical scroll bar. See the
103"ScrollBar" widget manual entry for details on the vertsb compo‐
104nent item.
105package require Iwidgets 4.0 iwidgets::scrolledframe .sf ‐width
107150 ‐height 180 \
108 ‐labelon yes ‐labeltext scrolledframe
109set cs [.sf childsite] pack [button $cs.b1 ‐text Hello] ‐pady 10
111pack [button $cs.b2 ‐text World] ‐pady 10 pack [button $cs.b3
112‐text "This is a test"] ‐pady 10 pack [button $cs.b4 ‐text "This
113is a really big button"] ‐pady 10 pack [button $cs.b5 ‐text "This
114is another really big button"] ‐pady 10 pack [button $cs.b6 ‐text
115"This is the last really big button"] ‐pady 10
116pack .sf ‐expand yes ‐fill both ‐padx 10 ‐pady 10 Mark L. Ulferts
118Sue Yockey scrolledframe, frame, widget
119