1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>options (GCL TK Manual)</title>
<meta name="description" content="options (GCL TK Manual)">
<meta name="keywords" content="options (GCL TK Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="wm.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Control.html" rel="up" title="Control">
<link href="pack_002dold.html" rel="next" title="pack-old">
<link href="option.html" rel="prev" title="option">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="options"></span><div class="header">
<p>
Next: <a href="pack_002dold.html" accesskey="n" rel="next">pack-old</a>, Previous: <a href="option.html" accesskey="p" rel="prev">option</a>, Up: <a href="Control.html" accesskey="u" rel="up">Control</a> [<a href="wm.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<hr>
<span id="options-1"></span><h3 class="section">3.12 options</h3>
<p>options \- Standard options supported by widgets
</p>
<span id="Description-23"></span><h4 class="unnumberedsubsec">Description</h4>
<p>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>
<p>In the descriptions below,
“Name” refers to the option’s name in the option database (e.g.
in .Xdefaults files). “Class” refers to the option’s class value
in the option database. “Command-Line Switch” refers to the
switch used in widget-creation and <b>configure</b> widget commands to
set this value. For example, if an option’s command-line switch is
<b>:foreground</b><span class="roman"> and there exists a widget </span><b>.a.b.c</b>, then the
command
</p>
<div class="example">
<pre class="example">
(.a.b.c :configure :foreground "black")<!-- /@w -->
</pre></div>
<p>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.
</p>
<dl compact="compact">
<dt><code><b>:activebackground</b></code></dt>
<dd><p align="right">Name=<code>"<b>activeBackground</b><span class="roman">"</span> Class=<code>"</code><b>Foreground</b>"</code>
</p><br>
<p>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.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:activeborderwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>activeBorderWidth</b><span class="roman">"</span> Class=<code>"</code><b>BorderWidth</b>"</code>
</p><br>
<p>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>Tk_GetPixels</b>.
This option is typically only available in widgets displaying more
than one element at a time (e.g. menus but not buttons).
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:activeforeground</b></code></dt>
<dd><p align="right">Name=<code>"<b>activeForeground</b><span class="roman">"</span> Class=<code>"</code><b>Background</b>"</code>
</p><br>
<p>Specifies foreground color to use when drawing active elements.
See above for definition of active elements.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:anchor</b></code></dt>
<dd><p align="right">Name=<code>"<b>anchor</b><span class="roman">"</span> Class=<code>"</code><b>Anchor</b>"</code>
</p><br>
<p>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><span class="roman">, </span><b>ne</b><span class="roman">, </span><b>e</b><span class="roman">, </span><b>se</b>,
<b>s</b><span class="roman">, </span><b>sw</b><span class="roman">, </span><b>w</b><span class="roman">, </span><b>nw</b><span class="roman">, or </span><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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:background or :bg</b></code></dt>
<dd><p align="right">Name=<code>"<b>background</b><span class="roman">"</span> Class=<code>"</code><b>Background</b>"</code>
</p><br>
<p>Specifies the normal background color to use when displaying the
widget.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:bitmap</b></code></dt>
<dd><p align="right">Name=<code>"<b>bitmap</b><span class="roman">"</span> Class=<code>"</code><b>Bitmap</b>"</code>
</p><br>
<p>Specifies a bitmap to display in the widget, in any of the forms
acceptable to <b>Tk_GetBitmap</b>.
The exact way in which the bitmap is displayed may be affected by
other options such as <b>anchor</b><span class="roman"> or </span><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.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:borderwidth or :bd</b></code></dt>
<dd><p align="right">Name=<code>"<b>borderWidth</b><span class="roman">"</span> Class=<code>"</code><b>BorderWidth</b>"</code>
</p><br>
<p>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>Tk_GetPixels</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursor</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursor</b><span class="roman">"</span> Class=<code>"</code><b>Cursor</b>"</code>
</p><br>
<p>Specifies the mouse cursor to be used for the widget.
The value may have any of the forms acceptable to <b>Tk_GetCursor</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursorbackground</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursorBackground</b><span class="roman">"</span> Class=<code>"</code><b>Foreground</b>"</code>
</p><br>
<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).
\fIThis option is obsolete and is gradually being replaced by
the <b>insertBackground</b><span class="roman"> option.</span>
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursorborderwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursorBorderWidth</b><span class="roman">"</span> Class=<code>"</code><b>BorderWidth</b>"</code>
</p><br>
<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 <b>Tk_GetPixels</b>.
\fIThis option is obsolete and is gradually being replaced by
the <b>insertBorderWidth</b><span class="roman"> option.</span>
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursorofftime</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursorOffTime</b><span class="roman">"</span> Class=<code>"</code><b>OffTime</b>"</code>
</p><br>
<p>Specifies a non-negative integer value indicating the number of
milliseconds the 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.
\fIThis option is obsolete and is gradually being replaced by
the <b>insertOffTime</b><span class="roman"> option.</span>
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursorontime</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursorOnTime</b><span class="roman">"</span> Class=<code>"</code><b>OnTime</b>"</code>
</p><br>
<p>Specifies a non-negative integer value indicating the number of
milliseconds the cursor should remain “on” in each blink cycle.
\fIThis option is obsolete and is gradually being replaced by
the <b>insertOnTime</b><span class="roman"> option.</span>
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:cursorwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>cursorWidth</b><span class="roman">"</span> Class=<code>"</code><b>CursorWidth</b>"</code>
</p><br>
<p>Specifies a value indicating the total width of the insertion cursor.
The value may have any of the forms acceptable to <b>Tk_GetPixels</b>.
If a border has been specified for
the cursor (using the <b>cursorBorderWidth</b> option), the border
will be drawn inside the width specified by the <b>cursorWidth</b>
option.
\fIThis option is obsolete and is gradually being replaced by
the <b>insertWidth</b><span class="roman"> option.</span>
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:disabledforeground</b></code></dt>
<dd><p align="right">Name=<code>"<b>disabledForeground</b><span class="roman">"</span> Class=<code>"</code><b>DisabledForeground</b>"</code>
</p><br>
<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 fooreground color but they are dimmed by drawing them
with a stippled fill pattern.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:exportselection</b></code></dt>
<dd><p align="right">Name=<code>"<b>exportSelection</b><span class="roman">"</span> Class=<code>"</code><b>ExportSelection</b>"</code>
</p><br>
<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 <b>Tcl_GetBoolean</b>,
such as <b>true</b><span class="roman">, </span><b>false</b><span class="roman">, </span><b>0</b><span class="roman">, </span><b>1</b><span class="roman">, </span><b>yes</b><span class="roman">, or </span><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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:font</b></code></dt>
<dd><p align="right">Name=<code>"<b>font</b><span class="roman">"</span> Class=<code>"</code><b>Font</b>"</code>
</p><br>
<p>Specifies the font to use when drawing text inside the widget.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:foreground or :fg</b></code></dt>
<dd><p align="right">Name=<code>"<b>foreground</b><span class="roman">"</span> Class=<code>"</code><b>Foreground</b>"</code>
</p><br>
<p>Specifies the normal foreground color to use when displaying the widget.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:geometry</b></code></dt>
<dd><p align="right">Name=<code>"<b>geometry</b><span class="roman">"</span> Class=<code>"</code><b>Geometry</b>"</code>
</p><br>
<p>Specifies the desired geometry for the widget’s window, in the
form <i>width</i><b>x</b><i>height</i><span class="roman">, where </span><i>width</i> is the desired
width of the window and <i>height</i> is the desired height. The
units for <i>width</i><span class="roman"> and </span><i>height</i> depend on the particular
widget. For widgets displaying text the units are usually the
size of the characters in the font being displayed; for other
widgets the units are usually pixels.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:insertbackground</b></code></dt>
<dd><p align="right">Name=<code>"<b>insertBackground</b><span class="roman">"</span> Class=<code>"</code><b>Foreground</b>"</code>
</p><br>
<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>
</dl>
<dl compact="compact">
<dt><code><b>:insertborderwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>insertBorderWidth</b><span class="roman">"</span> Class=<code>"</code><b>BorderWidth</b>"</code>
</p><br>
<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 <b>Tk_GetPixels</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:insertofftime</b></code></dt>
<dd><p align="right">Name=<code>"<b>insertOffTime</b><span class="roman">"</span> Class=<code>"</code><b>OffTime</b>"</code>
</p><br>
<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>
</dl>
<dl compact="compact">
<dt><code><b>:insertontime</b></code></dt>
<dd><p align="right">Name=<code>"<b>insertOnTime</b><span class="roman">"</span> Class=<code>"</code><b>OnTime</b>"</code>
</p><br>
<p>Specifies a non-negative integer value indicating the number of
milliseconds the insertion cursor should remain “on” in each blink cycle.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:insertwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>insertWidth</b><span class="roman">"</span> Class=<code>"</code><b>InsertWidth</b>"</code>
</p><br>
<p>Specifies a value indicating the total width of the insertion cursor.
The value may have any of the forms acceptable to <b>Tk_GetPixels</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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:orient</b></code></dt>
<dd><p align="right">Name=<code>"<b>orient</b><span class="roman">"</span> Class=<code>"</code><b>Orient</b>"</code>
</p><br>
<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 <b>horizontal</b>
or <b>vertical</b> or an abbreviation of one of these.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:padx</b></code></dt>
<dd><p align="right">Name=<code>"<b>padX</b><span class="roman">"</span> Class=<code>"</code><b>Pad</b>"</code>
</p><br>
<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 <b>Tk_GetPixels</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.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:pady</b></code></dt>
<dd><p align="right">Name=<code>"<b>padY</b><span class="roman">"</span> Class=<code>"</code><b>Pad</b>"</code>
</p><br>
<p>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>Tk_GetPixels</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.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:relief</b></code></dt>
<dd><p align="right">Name=<code>"<b>relief</b><span class="roman">"</span> Class=<code>"</code><b>Relief</b>"</code>
</p><br>
<p>Specifies the 3-D effect desired for the widget. Acceptable
values are <b>raised</b><span class="roman">, </span><b>sunken</b><span class="roman">, </span><b>flat</b><span class="roman">, </span><b>ridge</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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:repeatdelay</b></code></dt>
<dd><p align="right">Name=<code>"<b>repeatDelay</b><span class="roman">"</span> Class=<code>"</code><b>RepeatDelay</b>"</code>
</p><br>
<p>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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:repeatinterval</b></code></dt>
<dd><p align="right">Name=<code>"<b>repeatInterval</b><span class="roman">"</span> Class=<code>"</code><b>RepeatInterval</b>"</code>
</p><br>
<p>Used in conjunction with <b>repeatDelay</b>: once auto-repeat
begins, this option determines the number of milliseconds between
auto-repeats.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:scrollcommand</b></code></dt>
<dd><p align="right">Name=<code>"<b>scrollCommand</b><span class="roman">"</span> Class=<code>"</code><b>ScrollCommand</b>"</code>
</p><br>
<p>Specifies the prefix for a command used to communicate with scrollbar
widgets. 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 four
numbers. The four numbers are, in order: the total size of the
widget’s contents, in unspecified units
(“unit” is a widget-specific term; for widgets
displaying text, the unit is a line); the maximum number of units that
may be displayed at once in the widget’s window, given its current size; the
index of the top-most or left-most unit currently visible in the window
(index 0 corresponds to the first unit); and the index of the bottom-most
or right-most unit currently visible in the window. This command is
then passed to the Tcl interpreter for execution. Typically the
<b>scrollCommand</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>
<p>The <b>scrollCommand</b> option is used for widgets that support scrolling
in only one direction.
For widgets that support scrolling in both directions, this
option is replaced with the <b>xScrollCommand</b><span class="roman"> and </span><b>yScrollCommand</b>
options.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:selectbackground</b></code></dt>
<dd><p align="right">Name=<code>"<b>selectBackground</b><span class="roman">"</span> Class=<code>"</code><b>Foreground</b>"</code>
</p><br>
<p>Specifies the background color to use when displaying selected
items.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:selectborderwidth</b></code></dt>
<dd><p align="right">Name=<code>"<b>selectBorderWidth</b><span class="roman">"</span> Class=<code>"</code><b>BorderWidth</b>"</code>
</p><br>
<p>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>Tk_GetPixels</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:selectforeground</b></code></dt>
<dd><p align="right">Name=<code>"<b>selectForeground</b><span class="roman">"</span> Class=<code>"</code><b>Background</b>"</code>
</p><br>
<p>Specifies the foreground color to use when displaying selected
items.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:setgrid</b></code></dt>
<dd><p align="right">Name=<code>"<b>setGrid</b><span class="roman">"</span> Class=<code>"</code><b>SetGrid</b>"</code>
</p><br>
<p>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>wm</b> manual
entry for more details.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:text</b></code></dt>
<dd><p align="right">Name=<code>"<b>text</b><span class="roman">"</span> Class=<code>"</code><b>Text</b>"</code>
</p><br>
<p>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><span class="roman"> or </span><b>justify</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:textvariable</b></code></dt>
<dd><p align="right">Name=<code>"<b>textVariable</b><span class="roman">"</span> Class=<code>"</code><b>Variable</b>"</code>
</p><br>
<p>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><span class="roman"> or </span><b>justify</b>.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:underline</b></code></dt>
<dd><p align="right">Name=<code>"<b>underline</b><span class="roman">"</span> Class=<code>"</code><b>Underline</b>"</code>
</p><br>
<p>Specifies the integer index of a character to underline in the widget.
This option is typically used to indicate keyboard traversal characters
in 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></dd>
</dl>
<dl compact="compact">
<dt><code><b>:xscrollcommand</b></code></dt>
<dd><p align="right">Name=<code>"<b>xScrollCommand</b><span class="roman">"</span> Class=<code>"</code><b>ScrollCommand</b>"</code>
</p><br>
<p>Specifies the prefix for a command used to communicate with horizontal
scrollbars. This option is treated in the same way as the
<b>scrollCommand</b> option, except that it is used for horizontal
scrollbars associated with widgets that support both horizontal
and vertical scrolling.
See the description of <b>scrollCommand</b> for complete details
on how this option is used.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><b>:yscrollcommand</b></code></dt>
<dd><p align="right">Name=<code>"<b>yScrollCommand</b><span class="roman">"</span> Class=<code>"</code><b>ScrollCommand</b>"</code>
</p><br>
<p>Specifies the prefix for a command used to communicate with vertical
scrollbars. This option is treated in the same way as the
<b>scrollCommand</b> option, except that it is used for vertical
scrollbars associated with widgets that support both horizontal
and vertical scrolling.
See the description of <b>scrollCommand</b> for complete details
on how this option is used.
</p>
</dd>
</dl>
<span id="Keywords-26"></span><h4 class="unnumberedsubsec">Keywords</h4>
<p>class, name, standard option, switch
</p><hr>
<div class="header">
<p>
Next: <a href="pack_002dold.html" accesskey="n" rel="next">pack-old</a>, Previous: <a href="option.html" accesskey="p" rel="prev">option</a>, Up: <a href="Control.html" accesskey="u" rel="up">Control</a> [<a href="wm.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
</body>
</html>
|
