454 lines
27 KiB
HTML
454 lines
27 KiB
HTML
<HTML><HEAD><TITLE>Tk Built-In Commands - options manual page</TITLE></HEAD><BODY>
|
|
<DL>
|
|
<DD><A HREF="options.htm#M2" NAME="L2">NAME</A>
|
|
<DL><DD>options - Standard options supported by widgets</DL>
|
|
<DD><A HREF="options.htm#M3" NAME="L3">DESCRIPTION</A>
|
|
<DL>
|
|
<DD><A HREF="options.htm#M-activebackground" NAME="L4">-activebackground, activeBackground, Foreground</A>
|
|
<DD><A HREF="options.htm#M-activeborderwidth" NAME="L5">-activeborderwidth, activeBorderWidth, BorderWidth</A>
|
|
<DD><A HREF="options.htm#M-activeforeground" NAME="L6">-activeforeground, activeForeground, Background</A>
|
|
<DD><A HREF="options.htm#M-anchor" NAME="L7">-anchor, anchor, Anchor</A>
|
|
<DD><A HREF="options.htm#M-background" NAME="L8">-background or -bg, background, Background</A>
|
|
<DD><A HREF="options.htm#M-bitmap" NAME="L9">-bitmap, bitmap, Bitmap</A>
|
|
<DD><A HREF="options.htm#M-borderwidth" NAME="L10">-borderwidth or -bd, borderWidth, BorderWidth</A>
|
|
<DD><A HREF="options.htm#M-cursor" NAME="L11">-cursor, cursor, Cursor</A>
|
|
<DD><A HREF="options.htm#M-disabledforeground" NAME="L12">-disabledforeground, disabledForeground, DisabledForeground</A>
|
|
<DD><A HREF="options.htm#M-exportselection" NAME="L13">-exportselection, exportSelection, ExportSelection</A>
|
|
<DD><A HREF="options.htm#M-font" NAME="L14">-font, font, Font</A>
|
|
<DD><A HREF="options.htm#M-foreground" NAME="L15">-foreground or -fg, foreground, Foreground</A>
|
|
<DD><A HREF="options.htm#M-highlightbackground" NAME="L16">-highlightbackground, highlightBackground, HighlightBackground</A>
|
|
<DD><A HREF="options.htm#M-highlightcolor" NAME="L17">-highlightcolor, highlightColor, HighlightColor</A>
|
|
<DD><A HREF="options.htm#M-highlightthickness" NAME="L18">-highlightthickness, highlightThickness, HighlightThickness</A>
|
|
<DD><A HREF="options.htm#M-image" NAME="L19">-image, image, Image</A>
|
|
<DD><A HREF="options.htm#M-insertbackground" NAME="L20">-insertbackground, insertBackground, Foreground</A>
|
|
<DD><A HREF="options.htm#M-insertborderwidth" NAME="L21">-insertborderwidth, insertBorderWidth, BorderWidth</A>
|
|
<DD><A HREF="options.htm#M-insertofftime" NAME="L22">-insertofftime, insertOffTime, OffTime</A>
|
|
<DD><A HREF="options.htm#M-insertontime" NAME="L23">-insertontime, insertOnTime, OnTime</A>
|
|
<DD><A HREF="options.htm#M-insertwidth" NAME="L24">-insertwidth, insertWidth, InsertWidth</A>
|
|
<DD><A HREF="options.htm#M-jump" NAME="L25">-jump, jump, Jump</A>
|
|
<DD><A HREF="options.htm#M-justify" NAME="L26">-justify, justify, Justify</A>
|
|
<DD><A HREF="options.htm#M-orient" NAME="L27">-orient, orient, Orient</A>
|
|
<DD><A HREF="options.htm#M-padx" NAME="L28">-padx, padX, Pad</A>
|
|
<DD><A HREF="options.htm#M-pady" NAME="L29">-pady, padY, Pad</A>
|
|
<DD><A HREF="options.htm#M-relief" NAME="L30">-relief, relief, Relief</A>
|
|
<DD><A HREF="options.htm#M-repeatdelay" NAME="L31">-repeatdelay, repeatDelay, RepeatDelay</A>
|
|
<DD><A HREF="options.htm#M-repeatinterval" NAME="L32">-repeatinterval, repeatInterval, RepeatInterval</A>
|
|
<DD><A HREF="options.htm#M-selectbackground" NAME="L33">-selectbackground, selectBackground, Foreground</A>
|
|
<DD><A HREF="options.htm#M-selectborderwidth" NAME="L34">-selectborderwidth, selectBorderWidth, BorderWidth</A>
|
|
<DD><A HREF="options.htm#M-selectforeground" NAME="L35">-selectforeground, selectForeground, Background</A>
|
|
<DD><A HREF="options.htm#M-setgrid" NAME="L36">-setgrid, setGrid, SetGrid</A>
|
|
<DD><A HREF="options.htm#M-takefocus" NAME="L37">-takefocus, takeFocus, TakeFocus</A>
|
|
<DD><A HREF="options.htm#M-text" NAME="L38">-text, text, Text</A>
|
|
<DD><A HREF="options.htm#M-textvariable" NAME="L39">-textvariable, textVariable, Variable</A>
|
|
<DD><A HREF="options.htm#M-troughcolor" NAME="L40">-troughcolor, troughColor, Background</A>
|
|
<DD><A HREF="options.htm#M-underline" NAME="L41">-underline, underline, Underline</A>
|
|
<DD><A HREF="options.htm#M-wraplength" NAME="L42">-wraplength, wrapLength, WrapLength</A>
|
|
<DD><A HREF="options.htm#M-xscrollcommand" NAME="L43">-xscrollcommand, xScrollCommand, ScrollCommand</A>
|
|
<DD><A HREF="options.htm#M-yscrollcommand" NAME="L44">-yscrollcommand, yScrollCommand, ScrollCommand</A>
|
|
</DL>
|
|
<DD><A HREF="options.htm#M4" NAME="L45">SEE ALSO</A>
|
|
<DD><A HREF="options.htm#M5" NAME="L46">KEYWORDS</A>
|
|
</DL><HR>
|
|
<H3><A NAME="M2">NAME</A></H3>
|
|
options - Standard options supported by widgets
|
|
<H3><A NAME="M3">DESCRIPTION</A></H3>
|
|
This manual entry describes the common configuration options supported
|
|
by widgets in the Tk toolkit. Every widget does not necessarily support
|
|
every option (see the manual entries for individual widgets for a list
|
|
of the standard options supported by that widget), but if a widget does
|
|
support an option with one of the names listed below, then the option
|
|
has exactly the effect described below.
|
|
<P>
|
|
In the descriptions below, ``Command-Line Name'' refers to the
|
|
switch used in class commands and <B>configure</B> widget commands to
|
|
set this value. For example, if an option's command-line switch is
|
|
<B>-foreground</B> and there exists a widget <B>.a.b.c</B>, then the
|
|
command
|
|
<PRE><B>.a.b.c configure -foreground black</B></PRE>
|
|
may be used to specify the value <B>black</B> for the option in the
|
|
the widget <B>.a.b.c</B>. Command-line switches may be abbreviated,
|
|
as long as the abbreviation is unambiguous.
|
|
``Database Name'' refers to the option's name in the option database (e.g.
|
|
in .Xdefaults files). ``Database Class'' refers to the option's class value
|
|
in the option database.
|
|
<DL>
|
|
<DT>Command-Line Name: <B><A NAME="M-activebackground">-activebackground</A></B>
|
|
<DT>Database Name: <B>activeBackground</B>
|
|
<DT>Database Class: <B>Foreground</B>
|
|
<DD>Specifies background color to use when drawing active elements.
|
|
An element (a widget or portion of a widget) is active if the
|
|
mouse cursor is positioned over the element and pressing a mouse button
|
|
will cause some action to occur.
|
|
If strict Motif compliance has been requested by setting the
|
|
<B>tk_strictMotif</B> variable, this option will normally be
|
|
ignored; the normal background color will be used instead.
|
|
For some elements on Windows and Macintosh systems, the active color
|
|
will only be used while mouse button 1 is pressed over the element.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-activeborderwidth">-activeborderwidth</A></B>
|
|
<DT>Database Name: <B>activeBorderWidth</B>
|
|
<DT>Database Class: <B>BorderWidth</B>
|
|
<DD>Specifies a non-negative value indicating
|
|
the width of the 3-D border drawn around active elements. See above for
|
|
definition of active elements.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
This option is typically only available in widgets displaying more
|
|
than one element at a time (e.g. menus but not buttons).
|
|
<P><DT>Command-Line Name: <B><A NAME="M-activeforeground">-activeforeground</A></B>
|
|
<DT>Database Name: <B>activeForeground</B>
|
|
<DT>Database Class: <B>Background</B>
|
|
<DD>Specifies foreground color to use when drawing active elements.
|
|
See above for definition of active elements.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-anchor">-anchor</A></B>
|
|
<DT>Database Name: <B>anchor</B>
|
|
<DT>Database Class: <B>Anchor</B>
|
|
<DD>Specifies how the information in a widget (e.g. text or a bitmap)
|
|
is to be displayed in the widget.
|
|
Must be one of the values <B>n</B>, <B>ne</B>, <B>e</B>, <B>se</B>,
|
|
<B>s</B>, <B>sw</B>, <B>w</B>, <B>nw</B>, or <B>center</B>.
|
|
For example, <B>nw</B> means display the information such that its
|
|
top-left corner is at the top-left corner of the widget.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-background">-background or -bg</A></B>
|
|
<DT>Database Name: <B>background</B>
|
|
<DT>Database Class: <B>Background</B>
|
|
<DD>Specifies the normal background color to use when displaying the
|
|
widget.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-bitmap">-bitmap</A></B>
|
|
<DT>Database Name: <B>bitmap</B>
|
|
<DT>Database Class: <B>Bitmap</B>
|
|
<DD>Specifies a bitmap to display in the widget, in any of the forms
|
|
acceptable to <B><A HREF="../TclLib/GetBitmap.htm">Tk_GetBitmap</A></B>.
|
|
The exact way in which the bitmap is displayed may be affected by
|
|
other options such as <B>anchor</B> or <B>justify</B>.
|
|
Typically, if this option is specified then it overrides other
|
|
options that specify a textual value to display in the widget;
|
|
the <B>bitmap</B> option may be reset to an empty string to re-enable
|
|
a text display.
|
|
In widgets that support both <B>bitmap</B> and <B>image</B> options,
|
|
<B>image</B> will usually override <B>bitmap</B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-borderwidth">-borderwidth or -bd</A></B>
|
|
<DT>Database Name: <B>borderWidth</B>
|
|
<DT>Database Class: <B>BorderWidth</B>
|
|
<DD>Specifies a non-negative value indicating the width
|
|
of the 3-D border to draw around the outside of the widget (if such a
|
|
border is being drawn; the <B>relief</B> option typically determines
|
|
this). The value may also be used when drawing 3-D effects in the
|
|
interior of the widget.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-cursor">-cursor</A></B>
|
|
<DT>Database Name: <B>cursor</B>
|
|
<DT>Database Class: <B>Cursor</B>
|
|
<DD>Specifies the mouse cursor to be used for the widget.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetCursor.htm">Tk_GetCursor</A></B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-disabledforeground">-disabledforeground</A></B>
|
|
<DT>Database Name: <B>disabledForeground</B>
|
|
<DT>Database Class: <B>DisabledForeground</B>
|
|
<DD>Specifies foreground color to use when drawing a disabled element.
|
|
If the option is specified as an empty string (which is typically the
|
|
case on monochrome displays), disabled elements are drawn with the
|
|
normal foreground color but they are dimmed by drawing them
|
|
with a stippled fill pattern.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-exportselection">-exportselection</A></B>
|
|
<DT>Database Name: <B>exportSelection</B>
|
|
<DT>Database Class: <B>ExportSelection</B>
|
|
<DD>Specifies whether or not a selection in the widget should also be
|
|
the X selection.
|
|
The value may have any of the forms accepted by <B><A HREF="../TkLib/GetInt.htm">Tcl_GetBoolean</A></B>,
|
|
such as <B>true</B>, <B>false</B>, <B>0</B>, <B>1</B>, <B>yes</B>, or <B>no</B>.
|
|
If the selection is exported, then selecting in the widget deselects
|
|
the current X selection, selecting outside the widget deselects any
|
|
widget selection, and the widget will respond to selection retrieval
|
|
requests when it has a selection. The default is usually for widgets
|
|
to export selections.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-font">-font</A></B>
|
|
<DT>Database Name: <B><A HREF="../TclCmd/font.htm">font</A></B>
|
|
<DT>Database Class: <B><A HREF="../TclCmd/font.htm">Font</A></B>
|
|
<DD>Specifies the font to use when drawing text inside the widget.
|
|
The value may have any of the forms accepted by <B><A HREF="../TclLib/GetFont.htm">Tk_GetFont</A></B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-foreground">-foreground or -fg</A></B>
|
|
<DT>Database Name: <B>foreground</B>
|
|
<DT>Database Class: <B>Foreground</B>
|
|
<DD>Specifies the normal foreground color to use when displaying the widget.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-highlightbackground">-highlightbackground</A></B>
|
|
<DT>Database Name: <B>highlightBackground</B>
|
|
<DT>Database Class: <B>HighlightBackground</B>
|
|
<DD>Specifies the color to display in the traversal highlight region when
|
|
the widget does not have the input focus.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-highlightcolor">-highlightcolor</A></B>
|
|
<DT>Database Name: <B>highlightColor</B>
|
|
<DT>Database Class: <B>HighlightColor</B>
|
|
<DD>Specifies the color to use for the traversal highlight rectangle that is
|
|
drawn around the widget when it has the input focus.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-highlightthickness">-highlightthickness</A></B>
|
|
<DT>Database Name: <B>highlightThickness</B>
|
|
<DT>Database Class: <B>HighlightThickness</B>
|
|
<DD>Specifies a non-negative value indicating the width of the highlight
|
|
rectangle to draw around the outside of the widget when it has the
|
|
input focus.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
If the value is zero, no focus highlight is drawn around the widget.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-image">-image</A></B>
|
|
<DT>Database Name: <B>image</B>
|
|
<DT>Database Class: <B>Image</B>
|
|
<DD>Specifies an image to display in the widget, which must have been
|
|
created with the <B><A HREF="../TclCmd/image.htm">image create</A></B> command.
|
|
Typically, if the <B>image</B> option is specified then it overrides other
|
|
options that specify a bitmap or textual value to display in the widget;
|
|
the <B>image</B> option may be reset to an empty string to re-enable
|
|
a bitmap or text display.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-insertbackground">-insertbackground</A></B>
|
|
<DT>Database Name: <B>insertBackground</B>
|
|
<DT>Database Class: <B>Foreground</B>
|
|
<DD>Specifies the color to use as background in the area covered by the
|
|
insertion cursor. This color will normally override either the normal
|
|
background for the widget (or the selection background if the insertion
|
|
cursor happens to fall in the selection).
|
|
<P><DT>Command-Line Name: <B><A NAME="M-insertborderwidth">-insertborderwidth</A></B>
|
|
<DT>Database Name: <B>insertBorderWidth</B>
|
|
<DT>Database Class: <B>BorderWidth</B>
|
|
<DD>Specifies a non-negative value indicating the width
|
|
of the 3-D border to draw around the insertion cursor.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-insertofftime">-insertofftime</A></B>
|
|
<DT>Database Name: <B>insertOffTime</B>
|
|
<DT>Database Class: <B>OffTime</B>
|
|
<DD>Specifies a non-negative integer value indicating the number of
|
|
milliseconds the insertion cursor should remain ``off'' in each blink cycle.
|
|
If this option is zero then the cursor doesn't blink: it is on
|
|
all the time.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-insertontime">-insertontime</A></B>
|
|
<DT>Database Name: <B>insertOnTime</B>
|
|
<DT>Database Class: <B>OnTime</B>
|
|
<DD>Specifies a non-negative integer value indicating the number of
|
|
milliseconds the insertion cursor should remain ``on'' in each blink cycle.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-insertwidth">-insertwidth</A></B>
|
|
<DT>Database Name: <B>insertWidth</B>
|
|
<DT>Database Class: <B>InsertWidth</B>
|
|
<DD>Specifies a value indicating the total width of the insertion cursor.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
If a border has been specified for the insertion
|
|
cursor (using the <B>insertBorderWidth</B> option), the border
|
|
will be drawn inside the width specified by the <B>insertWidth</B>
|
|
option.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-jump">-jump</A></B>
|
|
<DT>Database Name: <B>jump</B>
|
|
<DT>Database Class: <B>Jump</B>
|
|
<DD>For widgets with a slider that can be dragged to adjust a value,
|
|
such as scrollbars, this option determines when
|
|
notifications are made about changes in the value.
|
|
The option's value must be a boolean of the form accepted by
|
|
<B><A HREF="../TkLib/GetInt.htm">Tcl_GetBoolean</A></B>.
|
|
If the value is false, updates are made continuously as the
|
|
slider is dragged.
|
|
If the value is true, updates are delayed until the mouse button
|
|
is released to end the drag; at that point a single notification
|
|
is made (the value ``jumps'' rather than changing smoothly).
|
|
<P><DT>Command-Line Name: <B><A NAME="M-justify">-justify</A></B>
|
|
<DT>Database Name: <B>justify</B>
|
|
<DT>Database Class: <B>Justify</B>
|
|
<DD>When there are multiple lines of text displayed in a widget, this
|
|
option determines how the lines line up with each other.
|
|
Must be one of <B>left</B>, <B>center</B>, or <B>right</B>.
|
|
<B>Left</B> means that the lines' left edges all line up, <B>center</B>
|
|
means that the lines' centers are aligned, and <B>right</B> means
|
|
that the lines' right edges line up.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-orient">-orient</A></B>
|
|
<DT>Database Name: <B>orient</B>
|
|
<DT>Database Class: <B>Orient</B>
|
|
<DD>For widgets that can lay themselves out with either a horizontal
|
|
or vertical orientation, such as scrollbars, this option specifies
|
|
which orientation should be used. Must be either <B>horizontal</B>
|
|
or <B>vertical</B> or an abbreviation of one of these.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-padx">-padx</A></B>
|
|
<DT>Database Name: <B>padX</B>
|
|
<DT>Database Class: <B>Pad</B>
|
|
<DD>Specifies a non-negative value indicating how much extra space
|
|
to request for the widget in the X-direction.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
When computing how large a window it needs, the widget will
|
|
add this amount to the width it would normally need (as determined
|
|
by the width of the things displayed in the widget); if the geometry
|
|
manager can satisfy this request, the widget will end up with extra
|
|
internal space to the left and/or right of what it displays inside.
|
|
Most widgets only use this option for padding text: if they are
|
|
displaying a bitmap or image, then they usually ignore padding
|
|
options.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-pady">-pady</A></B>
|
|
<DT>Database Name: <B>padY</B>
|
|
<DT>Database Class: <B>Pad</B>
|
|
<DD>Specifies a non-negative value indicating how much extra space
|
|
to request for the widget in the Y-direction.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
When computing how large a window it needs, the widget will add
|
|
this amount to the height it would normally need (as determined by
|
|
the height of the things displayed in the widget); if the geometry
|
|
manager can satisfy this request, the widget will end up with extra
|
|
internal space above and/or below what it displays inside.
|
|
Most widgets only use this option for padding text: if they are
|
|
displaying a bitmap or image, then they usually ignore padding
|
|
options.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-relief">-relief</A></B>
|
|
<DT>Database Name: <B>relief</B>
|
|
<DT>Database Class: <B>Relief</B>
|
|
<DD>Specifies the 3-D effect desired for the widget. Acceptable
|
|
values are <B>raised</B>, <B>sunken</B>, <B>flat</B>, <B>ridge</B>,
|
|
<B>solid</B>, and <B>groove</B>.
|
|
The value
|
|
indicates how the interior of the widget should appear relative
|
|
to its exterior; for example, <B>raised</B> means the interior of
|
|
the widget should appear to protrude from the screen, relative to
|
|
the exterior of the widget.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-repeatdelay">-repeatdelay</A></B>
|
|
<DT>Database Name: <B>repeatDelay</B>
|
|
<DT>Database Class: <B>RepeatDelay</B>
|
|
<DD>Specifies the number of milliseconds a button or key must be held
|
|
down before it begins to auto-repeat. Used, for example, on the
|
|
up- and down-arrows in scrollbars.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-repeatinterval">-repeatinterval</A></B>
|
|
<DT>Database Name: <B>repeatInterval</B>
|
|
<DT>Database Class: <B>RepeatInterval</B>
|
|
<DD>Used in conjunction with <B>repeatDelay</B>: once auto-repeat
|
|
begins, this option determines the number of milliseconds between
|
|
auto-repeats.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-selectbackground">-selectbackground</A></B>
|
|
<DT>Database Name: <B>selectBackground</B>
|
|
<DT>Database Class: <B>Foreground</B>
|
|
<DD>Specifies the background color to use when displaying selected
|
|
items.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-selectborderwidth">-selectborderwidth</A></B>
|
|
<DT>Database Name: <B>selectBorderWidth</B>
|
|
<DT>Database Class: <B>BorderWidth</B>
|
|
<DD>Specifies a non-negative value indicating the width
|
|
of the 3-D border to draw around selected items.
|
|
The value may have any of the forms acceptable to <B><A HREF="../TclLib/GetPixels.htm">Tk_GetPixels</A></B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-selectforeground">-selectforeground</A></B>
|
|
<DT>Database Name: <B>selectForeground</B>
|
|
<DT>Database Class: <B>Background</B>
|
|
<DD>Specifies the foreground color to use when displaying selected
|
|
items.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-setgrid">-setgrid</A></B>
|
|
<DT>Database Name: <B>setGrid</B>
|
|
<DT>Database Class: <B>SetGrid</B>
|
|
<DD>Specifies a boolean value that determines whether this widget controls the
|
|
resizing grid for its top-level window.
|
|
This option is typically used in text widgets, where the information
|
|
in the widget has a natural size (the size of a character) and it makes
|
|
sense for the window's dimensions to be integral numbers of these units.
|
|
These natural window sizes form a grid.
|
|
If the <B>setGrid</B> option is set to true then the widget will
|
|
communicate with the window manager so that when the user interactively
|
|
resizes the top-level window that contains the widget, the dimensions of
|
|
the window will be displayed to the user in grid units and the window
|
|
size will be constrained to integral numbers of grid units.
|
|
See the section GRIDDED GEOMETRY MANAGEMENT in the <B><A HREF="../TclCmd/wm.htm">wm</A></B> manual
|
|
entry for more details.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-takefocus">-takefocus</A></B>
|
|
<DT>Database Name: <B>takeFocus</B>
|
|
<DT>Database Class: <B>TakeFocus</B>
|
|
<DD>Determines whether the window accepts the focus during keyboard
|
|
traversal (e.g., Tab and Shift-Tab).
|
|
Before setting the focus to a window, the traversal scripts
|
|
consult the value of the <B>takeFocus</B> option.
|
|
A value of <B>0</B> means that the window should be skipped entirely
|
|
during keyboard traversal.
|
|
<B>1</B> means that the window should receive the input
|
|
focus as long as it is viewable (it and all of its ancestors are mapped).
|
|
An empty value for the option means that the traversal scripts make
|
|
the decision about whether or not to focus on the window: the current
|
|
algorithm is to skip the window if it is
|
|
disabled, if it has no key bindings, or if it is not viewable.
|
|
If the value has any other form, then the traversal scripts take
|
|
the value, append the name of the window to it (with a separator space),
|
|
and evaluate the resulting string as a Tcl script.
|
|
The script must return <B>0</B>, <B>1</B>, or an empty string: a
|
|
<B>0</B> or <B>1</B> value specifies whether the window will receive
|
|
the input focus, and an empty string results in the default decision
|
|
described above.
|
|
Note: this interpretation of the option is defined entirely by
|
|
the Tcl scripts that implement traversal: the widget implementations
|
|
ignore the option entirely, so you can change its meaning if you
|
|
redefine the keyboard traversal scripts.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-text">-text</A></B>
|
|
<DT>Database Name: <B><A HREF="../TclCmd/text.htm">text</A></B>
|
|
<DT>Database Class: <B><A HREF="../TclCmd/text.htm">Text</A></B>
|
|
<DD>Specifies a string to be displayed inside the widget. The way in which
|
|
the string is displayed depends on the particular widget and may be
|
|
determined by other options, such as <B>anchor</B> or <B>justify</B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-textvariable">-textvariable</A></B>
|
|
<DT>Database Name: <B>textVariable</B>
|
|
<DT>Database Class: <B><A HREF="../TkCmd/variable.htm">Variable</A></B>
|
|
<DD>Specifies the name of a variable. The value of the variable is a text
|
|
string to be displayed inside the widget; if the variable value changes
|
|
then the widget will automatically update itself to reflect the new value.
|
|
The way in which the string is displayed in the widget depends on the
|
|
particular widget and may be determined by other options, such as
|
|
<B>anchor</B> or <B>justify</B>.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-troughcolor">-troughcolor</A></B>
|
|
<DT>Database Name: <B>troughColor</B>
|
|
<DT>Database Class: <B>Background</B>
|
|
<DD>Specifies the color to use for the rectangular trough areas
|
|
in widgets such as scrollbars and scales. This option is ignored for
|
|
scrollbars on Windows (native widget doesn't recognize this option).
|
|
<P><DT>Command-Line Name: <B><A NAME="M-underline">-underline</A></B>
|
|
<DT>Database Name: <B>underline</B>
|
|
<DT>Database Class: <B>Underline</B>
|
|
<DD>Specifies the integer index of a character to underline in the widget.
|
|
This option is used by the default bindings to implement keyboard
|
|
traversal for menu buttons and menu entries.
|
|
0 corresponds to the first character of the text displayed in the
|
|
widget, 1 to the next character, and so on.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-wraplength">-wraplength</A></B>
|
|
<DT>Database Name: <B>wrapLength</B>
|
|
<DT>Database Class: <B>WrapLength</B>
|
|
<DD>For widgets that can perform word-wrapping, this option specifies
|
|
the maximum line length.
|
|
Lines that would exceed this length are wrapped onto the next line,
|
|
so that no line is longer than the specified length.
|
|
The value may be specified in any of the standard forms for
|
|
screen distances.
|
|
If this value is less than or equal to 0 then no wrapping is done: lines
|
|
will break only at newline characters in the text.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-xscrollcommand">-xscrollcommand</A></B>
|
|
<DT>Database Name: <B>xScrollCommand</B>
|
|
<DT>Database Class: <B>ScrollCommand</B>
|
|
<DD>Specifies the prefix for a command used to communicate with horizontal
|
|
scrollbars.
|
|
When the view in the widget's window changes (or
|
|
whenever anything else occurs that could change the display in a
|
|
scrollbar, such as a change in the total size of the widget's
|
|
contents), the widget will
|
|
generate a Tcl command by concatenating the scroll command and
|
|
two numbers.
|
|
Each of the numbers is a fraction between 0 and 1, which indicates
|
|
a position in the document. 0 indicates the beginning of the document,
|
|
1 indicates the end, .333 indicates a position one third the way through
|
|
the document, and so on.
|
|
The first fraction indicates the first information in the document
|
|
that is visible in the window, and the second fraction indicates
|
|
the information just after the last portion that is visible.
|
|
The command is
|
|
then passed to the Tcl interpreter for execution. Typically the
|
|
<B>xScrollCommand</B> option consists of the path name of a scrollbar
|
|
widget followed by ``set'', e.g. ``.x.scrollbar set'': this will cause
|
|
the scrollbar to be updated whenever the view in the window changes.
|
|
If this option is not specified, then no command will be executed.
|
|
<P><DT>Command-Line Name: <B><A NAME="M-yscrollcommand">-yscrollcommand</A></B>
|
|
<DT>Database Name: <B>yScrollCommand</B>
|
|
<DT>Database Class: <B>ScrollCommand</B>
|
|
<DD>Specifies the prefix for a command used to communicate with vertical
|
|
scrollbars. This option is treated in the same way as the
|
|
<B>xScrollCommand</B> option, except that it is used for vertical
|
|
scrollbars and is provided by widgets that support vertical scrolling.
|
|
See the description of <B>xScrollCommand</B> for details
|
|
on how this option is used.
|
|
|
|
</DL>
|
|
<H3><A NAME="M4">SEE ALSO</A></H3>
|
|
<B><A HREF="../TclCmd/colors.htm">colors</A></B>, <B><A HREF="../TclCmd/cursors.htm">cursors</A></B>, <B><A HREF="../TclCmd/font.htm">font</A></B>
|
|
<H3><A NAME="M5">KEYWORDS</A></H3>
|
|
<A href="../Keywords/C.htm#class">class</A>, <A href="../Keywords/N.htm#name">name</A>, <A href="../Keywords/S.htm#standard option">standard option</A>, <A href="../Keywords/S.htm#switch">switch</A>
|
|
<HR><PRE>
|
|
<A HREF="../copyright.htm">Copyright</A> © 1990-1994 The Regents of the University of California.
|
|
<A HREF="../copyright.htm">Copyright</A> © 1994-1996 Sun Microsystems, Inc.
|
|
<A HREF="../copyright.htm">Copyright</A> © 1995-1997 Roger E. Critchlow Jr.</PRE>
|
|
</BODY></HTML>
|