options.html

perl教程

of the 3-D border to draw around the outside of the widget (if such a
border is being drawn;  the <strong>relief</strong> 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 <strong>Tk_GetPixels</strong>.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_cursor">Name:	<strong>cursor</strong></a></strong>

<dt><strong><a name="item_class_3a_cursor">Class:	<strong>Cursor</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dcursor">Switch:	<strong>-cursor</strong></a></strong>

<dd>
<p>Specifies the mouse cursor to be used for the widget.
The value may have any of the forms acceptable to <strong>Tk_GetCursor</strong>.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_dash">Name:	<strong>dash</strong></a></strong>

<dt><strong><a name="item_class_3a_dash">Class:	<strong>Dash</strong></a></strong>

<dt><strong><a name="item_switch_3a__2ddash">Switch:	<strong>-dash</strong></a></strong>

<dd>
<p>The value may have any of the forms accepted by <strong>Tk_GetDash</strong>,
such as <strong>4</strong>, <strong>[6,4]</strong>, <strong>.</strong>, <strong>-</strong>, <strong>-.</strong>, or <strong>-..</strong>.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_dashoffset">Name:	<strong>dashoffset</strong></a></strong>

<dt><strong><a name="item_class_3a_dashoffset">Class:	<strong>Dashoffset</strong></a></strong>

<dt><strong><a name="item_switch_3a__2ddashoffset">Switch:	<strong>-dashoffset</strong></a></strong>

<dd>
<p>Specifies the offset in the dash list where the drawing starts.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_disabledforeground">Name:	<strong>disabledForeground</strong></a></strong>

<dt><strong><a name="item_class_3a_disabledforeground">Class:	<strong>DisabledForeground</strong></a></strong>

<dt><strong><a name="item_switch_3a__2ddisabledforeground">Switch:	<strong>-disabledforeground</strong></a></strong>

<dd>
<p>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>
</dd>
</li>
<dt><strong><a name="item_name_3a_disabledtile">Name:	<strong>disabledtile</strong></a></strong>

<dt><strong>Class:	<strong>Tile</strong></strong>

<dt><strong><a name="item_switch_3a__2ddisabledtile">Switch:	<strong>-disabledtile</strong></a></strong>

<dd>
<p>Specifies image to use when drawing a disabled element.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_exportselection">Name:	<strong>exportSelection</strong></a></strong>

<dt><strong><a name="item_class_3a_exportselection">Class:	<strong>ExportSelection</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dexportselection">Switch:	<strong>-exportselection</strong></a></strong>

<dd>
<p>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 <strong>Tcl_GetBoolean</strong>,
such as <strong>true</strong>, <strong>false</strong>, <strong>0</strong>, <strong>1</strong>, <strong>yes</strong>, or <strong>no</strong>.
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>
</dd>
</li>
<dt><strong><a name="item_name_3a_font">Name:	<strong>font</strong></a></strong>

<dt><strong><a name="item_class_3a_font">Class:	<strong>Font</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dfont">Switch:	<strong>-font</strong></a></strong>

<dd>
<p>Specifies the font to use when drawing text inside the widget.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_foreground">Name:	<strong>foreground</strong></a></strong>

<dt><strong>Class:	<strong>Foreground</strong></strong>

<dt><strong><a name="item_switch_3a__2dforeground">Switch:	<strong>-foreground</strong></a></strong>

<dt><strong><a name="item_alias_3a__2dfg">Alias:	<strong>-fg</strong></a></strong>

<dd>
<p>Specifies the normal foreground color to use when displaying the widget.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_highlightbackground">Name:	<strong>highlightBackground</strong></a></strong>

<dt><strong><a name="item_class_3a_highlightbackground">Class:	<strong>HighlightBackground</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dhighlightbackground">Switch:	<strong>-highlightbackground</strong></a></strong>

<dd>
<p>Specifies the color to display in the traversal highlight region when
the widget does not have the input focus.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_highlightcolor">Name:	<strong>highlightColor</strong></a></strong>

<dt><strong><a name="item_class_3a_highlightcolor">Class:	<strong>HighlightColor</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dhighlightcolor">Switch:	<strong>-highlightcolor</strong></a></strong>

<dd>
<p>Specifies the color to use for the traversal highlight rectangle that is
drawn around the widget when it has the input focus.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_highlightthickness">Name:	<strong>highlightThickness</strong></a></strong>

<dt><strong><a name="item_class_3a_highlightthickness">Class:	<strong>HighlightThickness</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dhighlightthickness">Switch:	<strong>-highlightthickness</strong></a></strong>

<dd>
<p>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 <strong>Tk_GetPixels</strong>.
If the value is zero, no focus highlight is drawn around the widget.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_image">Name:	<strong>image</strong></a></strong>

<dt><strong><a name="item_class_3a_image">Class:	<strong>Image</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dimage">Switch:	<strong>-image</strong></a></strong>

<dd>
<p>Specifies an image to display in the widget, which must have been
created with an image create. (See <a href="../../lib/Tk/Image.html">the Tk::Image manpage</a> for details of image creation.)
Typically, if the <strong>-image</strong> option is specified then it overrides other
options that specify a bitmap or textual value to display in the widget;
the <strong>-image</strong> option may be reset to an empty string to re-enable
a bitmap or text display.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_insertbackground">Name:	<strong>insertBackground</strong></a></strong>

<dt><strong>Class:	<strong>Foreground</strong></strong>

<dt><strong><a name="item_switch_3a__2dinsertbackground">Switch:	<strong>-insertbackground</strong></a></strong>

<dd>
<p>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>
</dd>
</li>
<dt><strong><a name="item_name_3a_insertborderwidth">Name:	<strong>insertBorderWidth</strong></a></strong>

<dt><strong>Class:	<strong>BorderWidth</strong></strong>

<dt><strong><a name="item_switch_3a__2dinsertborderwidth">Switch:	<strong>-insertborderwidth</strong></a></strong>

<dd>
<p>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 <strong>Tk_GetPixels</strong>.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_insertofftime">Name:	<strong>insertOffTime</strong></a></strong>

<dt><strong><a name="item_class_3a_offtime">Class:	<strong>OffTime</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dinsertofftime">Switch:	<strong>-insertofftime</strong></a></strong>

<dd>
<p>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>
</dd>
</li>
<dt><strong><a name="item_name_3a_insertontime">Name:	<strong>insertOnTime</strong></a></strong>

<dt><strong><a name="item_class_3a_ontime">Class:	<strong>OnTime</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dinsertontime">Switch:	<strong>-insertontime</strong></a></strong>

<dd>
<p>Specifies a non-negative integer value indicating the number of
milliseconds the insertion cursor should remain ``on'' in each blink cycle.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_insertwidth">Name:	<strong>insertWidth</strong></a></strong>

<dt><strong><a name="item_class_3a_insertwidth">Class:	<strong>InsertWidth</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dinsertwidth">Switch:	<strong>-insertwidth</strong></a></strong>

<dd>
<p>Specifies a  value indicating the total width of the insertion cursor.
The value may have any of the forms acceptable to <strong>Tk_GetPixels</strong>.
If a border has been specified for the insertion
cursor (using the <strong>insertBorderWidth</strong> option), the border
will be drawn inside the width specified by the <strong>insertWidth</strong>
option.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_jump">Name:	<strong>jump</strong></a></strong>

<dt><strong><a name="item_class_3a_jump">Class:	<strong>Jump</strong></a></strong>

<dt><strong><a name="item_switch_3a__2djump">Switch:	<strong>-jump</strong></a></strong>

<dd>
<p>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
<strong>Tcl_GetBoolean</strong>.
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>
</dd>
</li>
<dt><strong><a name="item_name_3a_justify">Name:	<strong>justify</strong></a></strong>

<dt><strong><a name="item_class_3a_justify">Class:	<strong>Justify</strong></a></strong>

<dt><strong><a name="item_switch_3a__2djustify">Switch:	<strong>-justify</strong></a></strong>

<dd>
<p>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 <strong>left</strong>, <strong>center</strong>, or <strong>right</strong>.
<strong>Left</strong> means that the lines' left edges all line up, <strong>center</strong>
means that the lines' centers are aligned, and <strong>right</strong> means
that the lines' right edges line up.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_offset">Name:	<strong>offset</strong></a></strong>

<dt><strong><a name="item_class_3a_offset">Class:	<strong>Offset</strong></a></strong>

<dt><strong><a name="item_switch_3a__2doffset">Switch:	<strong>-offset</strong></a></strong>

<dd>
<p>Specifies the offset of tiles (see also <strong>-tile</strong> option). It can
have two different formats <strong>-offset x,y</strong> or <strong>-offset side</strong>,
where side can be <strong>n</strong>, <strong>ne</strong>, <strong>e</strong>, <strong>se</strong>, <strong>s</strong>,
<strong>sw</strong>, <strong>w</strong>, <strong>nw</strong>, or <strong>center</strong>. In the first case
the origin is the origin of the toplevel of the current window.
For the canvas itself and canvas objects the origin is the canvas
origin, but putting <strong>#</strong> in front of the coordinate pair
indicates using the toplevel origin in stead. For canvas objects,
the <strong>-offset</strong> option is used for stippling as well.
For the line and polygon canvas items you can also specify
an index as argument, which connects the stipple or tile
origin to one of the coordinate points of the line/polygon.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_orient">Name:	<strong>orient</strong></a></strong>

<dt><strong><a name="item_class_3a_orient">Class:	<strong>Orient</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dorient">Switch:	<strong>-orient</strong></a></strong>

<dd>
<p>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 <strong>horizontal</strong>
or <strong>vertical</strong> or an abbreviation of one of these.</p>
</dd>
</li>
<dt><strong><a name="item_name_3a_padx">Name:	<strong>padX</strong></a></strong>

<dt><strong><a name="item_class_3a_pad">Class:	<strong>Pad</strong></a></strong>

<dt><strong><a name="item_switch_3a__2dpadx">Switch:	<strong>-padx</strong></a></strong>

<dd>
<p>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 <strong>Tk_GetPixels</strong>.
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>
</dd>