You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
458 lines
27 KiB
458 lines
27 KiB
<HTML><HEAD><TITLE>Tk Built-In Commands - options manual page</TITLE></HEAD> |
|
<BODY BGCOLOR=white> |
|
<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-disabledbackground" NAME="L12">-disabledbackground, disabledBackground, DisabledBackground</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">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="../TkLib/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="../TkLib/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="../TkLib/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="../TkLib/GetCursor.htm">Tk_GetCursor</A></B>. |
|
<P><DT>Command-Line Name: <B><A NAME="M-disabledforeground">-disabledforeground</A></B> |
|
<P><DT>Command-Line Name: <B><A NAME="M-disabledbackground">-disabledbackground</A></B> |
|
<DT>Database Name: <B>disabledBackground</B> |
|
<DT>Database Class: <B>DisabledBackground</B> |
|
<DD>Specifies background 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 background color but they are dimmed by drawing them |
|
with a stippled fill pattern. |
|
<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="../TclLib/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="../TkCmd/font.htm">font</A></B> |
|
<DT>Database Class: <B><A HREF="../TkCmd/font.htm">Font</A></B> |
|
<DD>Specifies the font to use when drawing text inside the widget. |
|
<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="../TkLib/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="../TkCmd/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="../TkLib/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="../TkLib/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="../TclLib/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="../TkLib/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="../TkLib/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="../TkLib/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="../TkCmd/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="../TkCmd/text.htm">text</A></B> |
|
<DT>Database Class: <B><A HREF="../TkCmd/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="../TclCmd/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. |
|
<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">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>
|
|
|