![]() |
ActiveTcl User Guide
|
![]() |
iwidgets::scrolledtext - Create and manipulate a scrolled text
widget
iwidgets::scrolledtext pathName
?options?
itk::Widget <- iwidgets::Labeledwidget <-
iwidgets::Scrolledwid- get <- iwidgets::Scrolledtext
options.
activeRelief elementBorderWidth jumptroughColor
associated options.
spacing1 spacing2 spacing3 state
ciated options.
inherited options.
value may be specified in any of the forms acceptable to Tk_Get-
nents such as labels, margins, and scrollbars force the text to
be compressed. A value of zero along with the same value for the
width causes the value given for the visibleitems option to be
applied which administers geometry constraints in a different
manner. The default height is zero.
scrollbar: static, dynamic, or none. In
static mode, the scroll bar is displayed at all times. Dynamic mode
displays the scroll bar as required, and none disables the scroll
bar display. The default is static.
able to Tk_GetPixels.
of the forms acceptable to Tk_GetPixels. The default is 3
pix- els.
forms acceptable to Tk_GetColor.
are both set to zero, otherwise they take precedence. The
default value is 80x24. With the visibleitems option engaged,
geometry constraints are maintained only on the text. The size of
the other components such as labels, margins, and scroll bars, are
additive and independent, effecting the overall size of the
scrolled text. In contrast, should the width and height options
have non zero values, they are applied to the scrolled text as a
whole. The text is compressed or expanded to maintain the geome-
try constraints.
scrollbar: static, dynamic, or none. In
static mode, the scroll bar is displayed at all times. Dynamic mode
displays the scroll bar as required, and none disables the scroll
bar display. The default is static.
value may be specified in any of the forms acceptable to Tk_Get-
nents such as labels, margins, and scrollbars force the text to
be compressed. A value of zero along with the same value for the
height causes the value given for the visibleitems option to be
applied which administers geometry constraints in a different
manner. The default width is zero.
_________________________________________________________________
with additional options to manage the scrollbars. This includes options to control the method in which the scrollbars are dis- played, i.e. statically or dynamically. Options also exist for adding a label to the scrolled text area and controlling its position. Import/export of methods are provided for file I/O.
whose name is pathName. This command may be used to invoke vari- ous operations on the widget. It has the following general form:
pathName option ?arg arg ...?
pathName cget option
option. Option may have any of the values accepted
by the iwid- gets::scrolledtext command.
pathName childsite
pathName clear
pathName configure ?option? ?value option value ...?
option is specified, returns a list describing all of the
avail- able options for pathName (see
Tk_ConfigureInfo for information on the format of this
list). If option is specified with no value, then the
command returns a list describing the one named option (this list
will be identical to the corresponding sublist of the value
returned if no option is specified). If one or more
option-value pairs are specified, then the command modifies
the given widget option(s) to have the given value(s); in this case
the command returns an empty string. Option may have any of
the values accepted by the iwidgets::scrolledtext command.
pathName import filename ?index?
filename must exist.
pathName export filename
replaced with text widget contents.
manual entry for details on the text component item.
«scrollbar» widget manual entry for details on the
horizsb compo- nent item.
«scrollbar» widget manual entry for details on the vertsb compo- nent item.
package require Iwidgets 4.0
option add *textBackground white
iwidgets::scrolledtext .st -hscrollmode dynamic -labeltext «Password File"
pack .st -padx 10 -pady 10 -fill both -expand yes
.st import /etc/passwd
scrolledtext, text, widget