
-activebackground color
The 
^B^-activebackground
 option defines the color that will be used for the background of an 
^I^active widget
, whenever the mouse is over that widget. An active widget (or portion thereof) is one 
that is immediately under the mouse 
cursor, and will cause or take some action if the mouse button is pressed. 

-activeborderwidth dist
Specifies the width of the 3-D border drawn around active control elements 
of a single control. This typically 
applies to widgets displaying more than one item at a time, i.e. menus but not buttons.

-activeforeground color
This option is similar to the 
^B^-activebackground
 option, but specifies the 
foreground color to use for a widget when that widget is active.

-anchor anchorPoint
When a slave window 
^S^win
 is packed in another window 
^S^master
, the slave window will often have more space than it needs to fully display itself. 
In order to choose where in this "free area" to position itself for viewing, 
^S^win
 will check its 
^I^anchor point
, which is a 'direction'.  For example, if the slave has more room 
horizontally than it needs, and its anchor point is '
^B^n
' (for north), the slave will position itself so that the center of its top boundary 
(its north point) is as close as possible to its parent's north point.

-background color
Specifies the normal background colour to use when displaying the widget. See also 
^B^-activebackground
.

-bitmap bitmap
Displays the given bitmap in a widget. If both a textual value and a bitmap are allowed 
for a particular widget, specifying both will usually result in the bitmap taking 
precedence, and the text not being displayed. Reconfiguring the widget (see 
^B^configure
) with 
^B^-bitmap
 having an empty string as its value will permit redisplay of the text.

-borderwidth dist
Defines the width of the border to draw around a widget, assuming the widget defaults to 
having a border, or the 
^B^-relief
 option has been used to specify a border style for the widget.

-cursor cursor
Specify which cursor to use for the mouse pointer, when the mouse pointer is over this 
widget.

-disabledforeground color
Specifies the foreground color to use when drawing a disabled control element, such as 
a menu element that is not applicable in the current context. If 
^S^color
 is an empty 
string, then the foreground 'color' for a disabled element will actually be the normal 
foreground color, but 'stippled' with a fill pattern. Users of monochrome Macs will 
be familiar with this last.

-exportselection bool
If true, then any selection within the widget is also the X selection. This has certain 
ramifications, which are best understood by reading the 
^I^tcl/tk
 manual. For most widgets, 
this defaults to true.

-font font
Specify the font for a widget.

-foreground color
Define the 'normal' foreground color for the widget. See also 
^B^-disabledforeground
 and 
^B^-activeforeground
.

-geometry width_x_height
The argument to this option is actually written 
^S^M
x
^S^N
, where 
^S^M
 and 
^S^N
 are integers, and the 'x' is just an 'x'. It defines a desired dimension for the widget, 
in terms of whatever are the basic 'units of measurement' for that widget. For text widgets, 
these units will usually be the average character width and character height of the widget's 
font (see 
^B^-font
), and for other widgets, the standard units will usually be pixels.

-highlightbackground color
Used with 
^B^-highlightthickness
 to specify a 'background' color for the 'traversal border' (see 
^B^-highlightthickness
). This generally defaults to the normal 
^I^tk
 background, which is usually what is desired.

-highlightcolor color
Used with 
^B^-highlightthickness
 to specify a 'foreground' color for the 'traversal border' (see 
^B^-highlightthickness
). This generally defaults to black.

-highlightthickness dist
A widget has the 
^I^input focus
 when it is the first recipient of keystrokes. Many widgets, 
such as canvases and listboxes, can draw a 
^I^traveral border
 around themselves, 
when they have the input focus, to make it obvious to the user where commands are going. 
^B^-highlightthickness
 determines the 
thickness of this border. Leaving this value set to its (usual) nonzero default is a common 
cause of unwanted 'extra space' around widgets. See also 
^B^-highlightcolor
 and 
^B^-highlightbackground
.

-image name
Specifies an image to display in the widget, which image must have been created with the
^B^image create
 command. Typically, if this option is specified, then it overrides
any of the 
^B^-text
, 
^B^-textvariable
, or 
^B^-bitmap
 options, even if they are also specified.

-insertbackground color
Specifies the color to use as background in the area covered by the insertion cursor.

-insertborderwidth dist
Specifies a value for the width of the border that is drawn around the insertion cursor. 

-insertofftime n
Defines a nonnegative integer specifying the number of milliseconds the insertion 
cursor should be 'off' in a blink cycle. See also 
^B^-insertontime
.

-insertontime n
Defines a nonnegative integer specifying the number of milliseconds the 
insertion cursor should be 'on' in a blink cycle. See also 
^B^-insertofftime.

-insertwidth dist
Specifies a value for the total width of the insertion cursor, including the border, 
the thickness of which is specified with 
^B^-insertborderwidth
.

-jump bool
For widgets such as scrollbars or scales, which permit a continuous adjustment of a value, 
a true value for this option will cause the widget to issue notifications as to its new 
value only when the current adjustment has been finished.  For example, the normal behaviour 
of a scrollbar attached to a text window is to scroll the text as the scrollbar is dragged. 
Setting 
^B^-jump
 to true will cause the text window to be updated only after the scroll 
button has been dragged to its new position and released.

-justify justification
When there are multiple lines of text displayed in a widget, this option specifies how 
the lines are to be aligned.  Note that this does not apply just to text widgets--a 
button or label may have multiple lines if the string specified with <STRONG>-text contains 
newlines.

-orient orientation
For widgets which may have either a vertical or horizontal orientation, specifies which 
orientation to use.

-padx dist
Inserts extra padding on each side of the window. This is used 
to improve appearance, such as ensuring that windows have a certain amount of 
"free space" between them.

-pady dist
Similar to 
^B^-padx
, but inserts padding above and below the widget, instead of 
at the sides.

-relief relief
Specify the 3D effect desired for the widget; this affects the appearance of the 
widget's border. See also 
^B^-borderwidth
.

-repeatdelay n
Specify the number of milliseconds a key must be held down before it begins to autorepeat. 
Used, for example, on the up- and down-arrows in scrollbars. See also 
^B^-repeatinterval
.

-repeatinterval n
Once autorepeating starts, specifies the number of 
milliseconds between automatic 'keypresses'. See also 
^B^-repeatdelay
.

-selectbackground color
Set the background color to use when displaying selected items. See also 
^B^-selectborderwidth
, 
^B^-selectforeground
.

-selectborderwidth dist
Specify the thickness of the 3D border to draw around selected items. See also 
^B^-selectforeground
, 
^B^-selectbackground
.

-selectforeground color
Set the foreground color to use when displaying selected items. See also 
^B^-selectbackground
, 
^B^-selectborderwidth
.

-setgrid bool
If true, specifies that gridded resizing be used for this widget and (by extension) its 
toplevel window. This can be used so that text windows resize only by lines and characters. 
See the 
^I^tcl/tk
 manual section on 
^I^Gridded Geometry Management
 for further details.

-takefocus bool_or_empty
Provides information used by 
^I^tk
 when the user attempts to move the input focus from 
widget to widget using keypresses (usually 
^B^<TAB>
 or 
^B^Shift-<TAB>
). 
^I^tk
 ensures that only viewable windows may receive the focus. However, a 0 for 
this value will cause focus to skip the associated window even if it is viewable, while 
a 1 ensures the window will receive the focus if it is viewable. There are further levels 
of complexity associated with this option--see the 'options' man page.

-text string
Specify a string to display inside the widget. See also 
^B^-textvariable
.

-textvariable variableName
Specify a variable which contains a string to display inside the widget. If the variable
changes, the widget will reflect the change. See also 
^B^-text
.

-troughcolor color
Define the color used in the trough area of a scrollbar, scale, or other similar widget.
This option is rarely used.

-underline n
Counting the first character as 0, specifies an integer defining which character to 
underline in a widget (see 
^B^-text
). This option is used by the default bindings 
to implement keyboard traveral for menu buttons and menu entries.

-wraplength dist
For widgets which may perform text wrapping, specify the maximum line length. If the
value of this option is 0 or less, then text wrapping is disabled.

-xscrollcommand cmd-prefix
This command tells this widget how to communicate changes to its associated vertical 
scrollbar 
^S^scrollbar
. Whenever something happens that might affect the information displayed in 
^S^scrollbar
, such as an increase in the vertical dimension of this widget's displayable 
contents, a command is formed by concatenating the string given in 
^S^cmd-prefix
 with two numeric arguments 
^S^firstpos
 and 
^S^lastpos
, and then executing this command. 
^S^firstpos
 is a number between 0 and 1, and indicates, in fractional terms, the first 
^I^x
-position of the widget's displayable area that can actually be seen in its 
viewable area; 
^S^lastpos
 gives a similar number for the last viewable 
^I^x
-position of the widget. In most cases, 
^S^cmd-prefix
 will simply be of the form '
^S^scrollbar
^B^ set
'; see 
^B^set
 for further details.

-yscrollcommand cmd-prefix
Similar to 
^B^-xscrollcommand
, but applies to scrolling in the horizontal direction.

