0000: 27 5c 22 0a 27 5c 22 20 43 6f 70 79 72 69 67 68 '\".'\" Copyrigh
0010: 74 20 28 63 29 20 31 39 39 30 2d 31 39 39 34 20 t (c) 1990-1994
0020: 54 68 65 20 52 65 67 65 6e 74 73 20 6f 66 20 74 The Regents of t
0030: 68 65 20 55 6e 69 76 65 72 73 69 74 79 20 6f 66 he University of
0040: 20 43 61 6c 69 66 6f 72 6e 69 61 2e 0a 27 5c 22 California..'\"
0050: 20 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 31 Copyright (c) 1
0060: 39 39 34 2d 31 39 39 37 20 53 75 6e 20 4d 69 63 994-1997 Sun Mic
0070: 72 6f 73 79 73 74 65 6d 73 2c 20 49 6e 63 2e 0a rosystems, Inc..
0080: 27 5c 22 0a 27 5c 22 20 53 65 65 20 74 68 65 20 '\".'\" See the
0090: 66 69 6c 65 20 22 6c 69 63 65 6e 73 65 2e 74 65 file "license.te
00a0: 72 6d 73 22 20 66 6f 72 20 69 6e 66 6f 72 6d 61 rms" for informa
00b0: 74 69 6f 6e 20 6f 6e 20 75 73 61 67 65 20 61 6e tion on usage an
00c0: 64 20 72 65 64 69 73 74 72 69 62 75 74 69 6f 6e d redistribution
00d0: 0a 27 5c 22 20 6f 66 20 74 68 69 73 20 66 69 6c .'\" of this fil
00e0: 65 2c 20 61 6e 64 20 66 6f 72 20 61 20 44 49 53 e, and for a DIS
00f0: 43 4c 41 49 4d 45 52 20 4f 46 20 41 4c 4c 20 57 CLAIMER OF ALL W
0100: 41 52 52 41 4e 54 49 45 53 2e 0a 27 5c 22 20 0a ARRANTIES..'\" .
0110: 27 5c 22 20 52 43 53 3a 20 40 28 23 29 20 24 49 '\" RCS: @(#) $I
0120: 64 3a 20 6d 65 6e 75 2e 6e 2c 76 20 31 2e 38 2e d: menu.n,v 1.8.
0130: 32 2e 32 20 32 30 30 37 2f 31 31 2f 30 35 20 31 2.2 2007/11/05 1
0140: 37 3a 32 31 3a 35 39 20 64 67 70 20 45 78 70 20 7:21:59 dgp Exp
0150: 24 0a 27 5c 22 20 0a 2e 73 6f 20 6d 61 6e 2e 6d $.'\" ..so man.m
0160: 61 63 72 6f 73 0a 2e 54 48 20 6d 65 6e 75 20 6e acros..TH menu n
0170: 20 34 2e 31 20 54 6b 20 22 54 6b 20 42 75 69 6c 4.1 Tk "Tk Buil
0180: 74 2d 49 6e 20 43 6f 6d 6d 61 6e 64 73 22 0a 2e t-In Commands"..
0190: 42 53 0a 27 5c 22 20 4e 6f 74 65 3a 20 20 64 6f BS.'\" Note: do
01a0: 20 6e 6f 74 20 6d 6f 64 69 66 79 20 74 68 65 20 not modify the
01b0: 2e 53 48 20 4e 41 4d 45 20 6c 69 6e 65 20 69 6d .SH NAME line im
01c0: 6d 65 64 69 61 74 65 6c 79 20 62 65 6c 6f 77 21 mediately below!
01d0: 0a 2e 53 48 20 4e 41 4d 45 0a 6d 65 6e 75 2c 20 ..SH NAME.menu,
01e0: 74 6b 5f 6d 65 6e 75 53 65 74 46 6f 63 75 73 20 tk_menuSetFocus
01f0: 5c 2d 20 43 72 65 61 74 65 20 61 6e 64 20 6d 61 \- Create and ma
0200: 6e 69 70 75 6c 61 74 65 20 6d 65 6e 75 20 77 69 nipulate menu wi
0210: 64 67 65 74 73 0a 2e 53 48 20 53 59 4e 4f 50 53 dgets..SH SYNOPS
0220: 49 53 0a 2e 6e 66 0a 5c 66 42 6d 65 6e 75 5c 66 IS..nf.\fBmenu\f
0230: 52 20 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c 66 R \fIpathName \f
0240: 52 3f 5c 66 49 6f 70 74 69 6f 6e 73 5c 66 52 3f R?\fIoptions\fR?
0250: 0a 5c 66 42 74 6b 5f 6d 65 6e 75 53 65 74 46 6f .\fBtk_menuSetFo
0260: 63 75 73 5c 66 52 20 5c 66 49 70 61 74 68 4e 61 cus\fR \fIpathNa
0270: 6d 65 5c 66 52 0a 2e 53 4f 0a 5c 2d 61 63 74 69 me\fR..SO.\-acti
0280: 76 65 62 61 63 6b 67 72 6f 75 6e 64 09 5c 2d 62 vebackground.\-b
0290: 6f 72 64 65 72 77 69 64 74 68 09 09 5c 2d 66 6f orderwidth..\-fo
02a0: 72 65 67 72 6f 75 6e 64 0a 5c 2d 61 63 74 69 76 reground.\-activ
02b0: 65 62 6f 72 64 65 72 77 69 64 74 68 09 5c 2d 63 eborderwidth.\-c
02c0: 75 72 73 6f 72 09 09 5c 2d 72 65 6c 69 65 66 0a ursor..\-relief.
02d0: 5c 2d 61 63 74 69 76 65 66 6f 72 65 67 72 6f 75 \-activeforegrou
02e0: 6e 64 09 5c 2d 64 69 73 61 62 6c 65 64 66 6f 72 nd.\-disabledfor
02f0: 65 67 72 6f 75 6e 64 09 5c 2d 74 61 6b 65 66 6f eground.\-takefo
0300: 63 75 73 0a 5c 2d 62 61 63 6b 67 72 6f 75 6e 64 cus.\-background
0310: 09 5c 2d 66 6f 6e 74 0a 0a 2e 53 45 0a 2e 53 48 .\-font...SE..SH
0320: 20 22 57 49 44 47 45 54 2d 53 50 45 43 49 46 49 "WIDGET-SPECIFI
0330: 43 20 4f 50 54 49 4f 4e 53 22 0a 2e 56 53 0a 2e C OPTIONS"..VS..
0340: 4f 50 20 5c 2d 70 6f 73 74 63 6f 6d 6d 61 6e 64 OP \-postcommand
0350: 20 70 6f 73 74 43 6f 6d 6d 61 6e 64 20 43 6f 6d postCommand Com
0360: 6d 61 6e 64 0a 49 66 20 74 68 69 73 20 6f 70 74 mand.If this opt
0370: 69 6f 6e 20 69 73 20 73 70 65 63 69 66 69 65 64 ion is specified
0380: 20 74 68 65 6e 20 69 74 20 70 72 6f 76 69 64 65 then it provide
0390: 73 20 61 20 54 63 6c 20 63 6f 6d 6d 61 6e 64 20 s a Tcl command
03a0: 74 6f 20 65 78 65 63 75 74 65 0a 65 61 63 68 20 to execute.each
03b0: 74 69 6d 65 20 74 68 65 20 6d 65 6e 75 20 69 73 time the menu is
03c0: 20 70 6f 73 74 65 64 2e 20 20 54 68 65 20 63 6f posted. The co
03d0: 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 mmand is invoked
03e0: 20 62 79 20 74 68 65 20 5c 66 42 70 6f 73 74 5c by the \fBpost\
03f0: 66 52 0a 77 69 64 67 65 74 20 63 6f 6d 6d 61 6e fR.widget comman
0400: 64 20 62 65 66 6f 72 65 20 70 6f 73 74 69 6e 67 d before posting
0410: 20 74 68 65 20 6d 65 6e 75 2e 20 4e 6f 74 65 20 the menu. Note
0420: 74 68 61 74 20 69 6e 20 54 6b 20 38 2e 30 20 6f that in Tk 8.0 o
0430: 6e 20 4d 61 63 69 6e 74 6f 73 68 0a 61 6e 64 20 n Macintosh.and
0440: 57 69 6e 64 6f 77 73 2c 20 61 6c 6c 20 70 6f 73 Windows, all pos
0450: 74 2d 63 6f 6d 6d 61 6e 64 73 20 69 6e 20 61 20 t-commands in a
0460: 73 79 73 74 65 6d 20 6f 66 20 6d 65 6e 75 73 20 system of menus
0470: 61 72 65 20 65 78 65 63 75 74 65 64 20 62 65 66 are executed bef
0480: 6f 72 65 20 61 6e 79 0a 6f 66 20 74 68 6f 73 65 ore any.of those
0490: 20 6d 65 6e 75 73 20 61 72 65 20 70 6f 73 74 65 menus are poste
04a0: 64 2e 0a 54 68 69 73 20 69 73 20 64 75 65 20 74 d..This is due t
04b0: 6f 20 74 68 65 20 6c 69 6d 69 74 61 74 69 6f 6e o the limitation
04c0: 73 20 69 6e 20 74 68 65 20 69 6e 64 69 76 69 64 s in the individ
04d0: 75 61 6c 20 70 6c 61 74 66 6f 72 6d 73 27 20 6d ual platforms' m
04e0: 65 6e 75 20 6d 61 6e 61 67 65 72 73 2e 0a 2e 56 enu managers...V
04f0: 45 0a 2e 4f 50 20 5c 2d 73 65 6c 65 63 74 63 6f E..OP \-selectco
0500: 6c 6f 72 20 73 65 6c 65 63 74 43 6f 6c 6f 72 20 lor selectColor
0510: 42 61 63 6b 67 72 6f 75 6e 64 0a 46 6f 72 20 6d Background.For m
0520: 65 6e 75 20 65 6e 74 72 69 65 73 20 74 68 61 74 enu entries that
0530: 20 61 72 65 20 63 68 65 63 6b 20 62 75 74 74 6f are check butto
0540: 6e 73 20 6f 72 20 72 61 64 69 6f 20 62 75 74 74 ns or radio butt
0550: 6f 6e 73 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e ons, this option
0560: 0a 73 70 65 63 69 66 69 65 73 20 74 68 65 20 63 .specifies the c
0570: 6f 6c 6f 72 20 74 6f 20 64 69 73 70 6c 61 79 20 olor to display
0580: 69 6e 20 74 68 65 20 69 6e 64 69 63 61 74 6f 72 in the indicator
0590: 20 77 68 65 6e 20 74 68 65 20 63 68 65 63 6b 20 when the check
05a0: 62 75 74 74 6f 6e 0a 6f 72 20 72 61 64 69 6f 20 button.or radio
05b0: 62 75 74 74 6f 6e 20 69 73 20 73 65 6c 65 63 74 button is select
05c0: 65 64 2e 0a 2e 4f 50 20 5c 2d 74 65 61 72 6f 66 ed...OP \-tearof
05d0: 66 20 74 65 61 72 4f 66 66 20 54 65 61 72 4f 66 f tearOff TearOf
05e0: 66 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 75 f.This option mu
05f0: 73 74 20 68 61 76 65 20 61 20 70 72 6f 70 65 72 st have a proper
0600: 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 2c 20 boolean value,
0610: 77 68 69 63 68 20 73 70 65 63 69 66 69 65 73 0a which specifies.
0620: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 whether or not t
0630: 68 65 20 6d 65 6e 75 20 73 68 6f 75 6c 64 20 69 he menu should i
0640: 6e 63 6c 75 64 65 20 61 20 74 65 61 72 2d 6f 66 nclude a tear-of
0650: 66 20 65 6e 74 72 79 20 61 74 20 74 68 65 0a 74 f entry at the.t
0660: 6f 70 2e 20 20 49 66 20 73 6f 2c 20 69 74 20 77 op. If so, it w
0670: 69 6c 6c 20 65 78 69 73 74 20 61 73 20 65 6e 74 ill exist as ent
0680: 72 79 20 30 20 6f 66 20 74 68 65 20 6d 65 6e 75 ry 0 of the menu
0690: 20 61 6e 64 20 74 68 65 20 6f 74 68 65 72 0a 65 and the other.e
06a0: 6e 74 72 69 65 73 20 77 69 6c 6c 20 6e 75 6d 62 ntries will numb
06b0: 65 72 20 73 74 61 72 74 69 6e 67 20 61 74 20 31 er starting at 1
06c0: 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 0a 6d . The default.m
06d0: 65 6e 75 20 62 69 6e 64 69 6e 67 73 20 61 72 72 enu bindings arr
06e0: 61 6e 67 65 20 66 6f 72 20 74 68 65 20 6d 65 6e ange for the men
06f0: 75 20 74 6f 20 62 65 20 74 6f 72 6e 20 6f 66 66 u to be torn off
0700: 20 77 68 65 6e 20 74 68 65 20 74 65 61 72 2d 6f when the tear-o
0710: 66 66 0a 65 6e 74 72 79 20 69 73 20 69 6e 76 6f ff.entry is invo
0720: 6b 65 64 2e 0a 2e 4f 50 20 5c 2d 74 65 61 72 6f ked...OP \-tearo
0730: 66 66 63 6f 6d 6d 61 6e 64 20 74 65 61 72 4f 66 ffcommand tearOf
0740: 66 43 6f 6d 6d 61 6e 64 20 54 65 61 72 4f 66 66 fCommand TearOff
0750: 43 6f 6d 6d 61 6e 64 0a 49 66 20 74 68 69 73 20 Command.If this
0760: 6f 70 74 69 6f 6e 20 68 61 73 20 61 20 6e 6f 6e option has a non
0770: 2d 65 6d 70 74 79 20 76 61 6c 75 65 2c 20 74 68 -empty value, th
0780: 65 6e 20 69 74 20 73 70 65 63 69 66 69 65 73 20 en it specifies
0790: 61 20 54 63 6c 20 63 6f 6d 6d 61 6e 64 0a 74 6f a Tcl command.to
07a0: 20 69 6e 76 6f 6b 65 20 77 68 65 6e 65 76 65 72 invoke whenever
07b0: 20 74 68 65 20 6d 65 6e 75 20 69 73 20 74 6f 72 the menu is tor
07c0: 6e 20 6f 66 66 2e 20 20 54 68 65 20 61 63 74 75 n off. The actu
07d0: 61 6c 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 0a al command will.
07e0: 63 6f 6e 73 69 73 74 20 6f 66 20 74 68 65 20 76 consist of the v
07f0: 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 74 alue of this opt
0800: 69 6f 6e 2c 20 66 6f 6c 6c 6f 77 65 64 20 62 79 ion, followed by
0810: 20 61 20 73 70 61 63 65 2c 20 66 6f 6c 6c 6f 77 a space, follow
0820: 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20 6f ed.by the name o
0830: 66 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f f the menu windo
0840: 77 2c 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 w, followed by a
0850: 20 73 70 61 63 65 2c 20 66 6f 6c 6c 6f 77 65 64 space, followed
0860: 20 62 79 0a 74 68 65 20 6e 61 6d 65 20 6f 66 20 by.the name of
0870: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
0880: 74 6f 72 6e 20 6f 66 66 20 6d 65 6e 75 20 77 69 torn off menu wi
0890: 6e 64 6f 77 2e 20 20 46 6f 72 20 65 78 61 6d 70 ndow. For examp
08a0: 6c 65 2c 20 69 66 0a 74 68 65 20 6f 70 74 69 6f le, if.the optio
08b0: 6e 27 73 20 69 73 20 60 60 5c 66 42 61 20 62 5c n's is ``\fBa b\
08c0: 66 52 27 27 20 61 6e 64 20 6d 65 6e 75 20 5c 66 fR'' and menu \f
08d0: 42 2e 78 2e 79 5c 66 52 20 69 73 20 74 6f 72 6e B.x.y\fR is torn
08e0: 20 6f 66 66 20 74 6f 0a 63 72 65 61 74 65 20 61 off to.create a
08f0: 20 6e 65 77 20 6d 65 6e 75 20 5c 66 42 2e 78 2e new menu \fB.x.
0900: 74 65 61 72 6f 66 66 31 5c 66 52 2c 20 74 68 65 tearoff1\fR, the
0910: 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 60 60 n the command.``
0920: 5c 66 42 61 20 62 20 2e 78 2e 79 20 2e 78 2e 74 \fBa b .x.y .x.t
0930: 65 61 72 6f 66 66 31 5c 66 52 27 27 20 77 69 6c earoff1\fR'' wil
0940: 6c 20 62 65 20 69 6e 76 6f 6b 65 64 2e 0a 2e 56 l be invoked...V
0950: 53 0a 2e 4f 50 20 5c 2d 74 69 74 6c 65 20 74 69 S..OP \-title ti
0960: 74 6c 65 20 54 69 74 6c 65 0a 54 68 65 20 73 74 tle Title.The st
0970: 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 75 73 65 ring will be use
0980: 64 20 74 6f 20 74 69 74 6c 65 20 74 68 65 20 77 d to title the w
0990: 69 6e 64 6f 77 20 63 72 65 61 74 65 64 20 77 68 indow created wh
09a0: 65 6e 20 74 68 69 73 20 6d 65 6e 75 20 69 73 0a en this menu is.
09b0: 74 6f 72 6e 20 6f 66 66 2e 20 49 66 20 74 68 65 torn off. If the
09c0: 20 74 69 74 6c 65 20 69 73 20 4e 55 4c 4c 2c 20 title is NULL,
09d0: 74 68 65 6e 20 74 68 65 20 77 69 6e 64 6f 77 20 then the window
09e0: 77 69 6c 6c 20 68 61 76 65 20 74 68 65 20 74 69 will have the ti
09f0: 74 6c 65 0a 6f 66 20 74 68 65 20 6d 65 6e 75 62 tle.of the menub
0a00: 75 74 74 6f 6e 20 6f 72 20 74 68 65 20 74 65 78 utton or the tex
0a10: 74 20 6f 66 20 74 68 65 20 63 61 73 63 61 64 65 t of the cascade
0a20: 20 69 74 65 6d 20 66 72 6f 6d 20 77 68 69 63 68 item from which
0a30: 20 74 68 69 73 20 6d 65 6e 75 0a 77 61 73 20 69 this menu.was i
0a40: 6e 76 6f 6b 65 64 2e 0a 2e 4f 50 20 5c 2d 74 79 nvoked...OP \-ty
0a50: 70 65 20 74 79 70 65 20 54 79 70 65 0a 54 68 69 pe type Type.Thi
0a60: 73 20 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65 20 s option can be
0a70: 6f 6e 65 20 6f 66 20 5c 66 42 6d 65 6e 75 62 61 one of \fBmenuba
0a80: 72 5c 66 52 2c 20 5c 66 42 74 65 61 72 6f 66 66 r\fR, \fBtearoff
0a90: 5c 66 52 2c 20 6f 72 0a 5c 66 42 6e 6f 72 6d 61 \fR, or.\fBnorma
0aa0: 6c 5c 66 52 2c 20 61 6e 64 20 69 73 20 73 65 74 l\fR, and is set
0ab0: 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 when the menu i
0ac0: 73 20 63 72 65 61 74 65 64 2e 20 57 68 69 6c 65 s created. While
0ad0: 20 74 68 65 20 73 74 72 69 6e 67 0a 72 65 74 75 the string.retu
0ae0: 72 6e 65 64 20 62 79 20 74 68 65 20 63 6f 6e 66 rned by the conf
0af0: 69 67 75 72 61 74 69 6f 6e 20 64 61 74 61 62 61 iguration databa
0b00: 73 65 20 77 69 6c 6c 20 63 68 61 6e 67 65 20 69 se will change i
0b10: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 f this option is
0b20: 0a 63 68 61 6e 67 65 64 2c 20 74 68 69 73 20 64 .changed, this d
0b30: 6f 65 73 20 6e 6f 74 20 61 66 66 65 63 74 20 74 oes not affect t
0b40: 68 65 20 6d 65 6e 75 20 77 69 64 67 65 74 27 73 he menu widget's
0b50: 20 62 65 68 61 76 69 6f 72 2e 20 54 68 69 73 20 behavior. This
0b60: 69 73 20 75 73 65 64 0a 62 79 20 74 68 65 20 63 is used.by the c
0b70: 6c 6f 6e 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d loning mechanism
0b80: 20 61 6e 64 20 69 73 20 6e 6f 74 20 6e 6f 72 6d and is not norm
0b90: 61 6c 6c 79 20 73 65 74 20 6f 75 74 73 69 64 65 ally set outside
0ba0: 20 6f 66 20 74 68 65 20 54 6b 0a 6c 69 62 72 61 of the Tk.libra
0bb0: 72 79 2e 0a 2e 56 45 0a 2e 42 45 0a 0a 2e 53 48 ry...VE..BE...SH
0bc0: 20 49 4e 54 52 4f 44 55 43 54 49 4f 4e 0a 2e 50 INTRODUCTION..P
0bd0: 50 0a 54 68 65 20 5c 66 42 6d 65 6e 75 5c 66 52 P.The \fBmenu\fR
0be0: 20 63 6f 6d 6d 61 6e 64 20 63 72 65 61 74 65 73 command creates
0bf0: 20 61 20 6e 65 77 20 74 6f 70 2d 6c 65 76 65 6c a new top-level
0c00: 20 77 69 6e 64 6f 77 20 28 67 69 76 65 6e 0a 62 window (given.b
0c10: 79 20 74 68 65 20 5c 66 49 70 61 74 68 4e 61 6d y the \fIpathNam
0c20: 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 29 20 61 e\fR argument) a
0c30: 6e 64 20 6d 61 6b 65 73 20 69 74 20 69 6e 74 6f nd makes it into
0c40: 20 61 20 6d 65 6e 75 20 77 69 64 67 65 74 2e 0a a menu widget..
0c50: 41 64 64 69 74 69 6f 6e 61 6c 0a 6f 70 74 69 6f Additional.optio
0c60: 6e 73 2c 20 64 65 73 63 72 69 62 65 64 20 61 62 ns, described ab
0c70: 6f 76 65 2c 20 6d 61 79 20 62 65 20 73 70 65 63 ove, may be spec
0c80: 69 66 69 65 64 20 6f 6e 20 74 68 65 20 63 6f 6d ified on the com
0c90: 6d 61 6e 64 20 6c 69 6e 65 0a 6f 72 20 69 6e 20 mand line.or in
0ca0: 74 68 65 20 6f 70 74 69 6f 6e 20 64 61 74 61 62 the option datab
0cb0: 61 73 65 0a 74 6f 20 63 6f 6e 66 69 67 75 72 65 ase.to configure
0cc0: 20 61 73 70 65 63 74 73 20 6f 66 20 74 68 65 20 aspects of the
0cd0: 6d 65 6e 75 20 73 75 63 68 20 61 73 20 69 74 73 menu such as its
0ce0: 20 63 6f 6c 6f 72 73 20 61 6e 64 20 66 6f 6e 74 colors and font
0cf0: 2e 0a 54 68 65 20 5c 66 42 6d 65 6e 75 5c 66 52 ..The \fBmenu\fR
0d00: 20 63 6f 6d 6d 61 6e 64 20 72 65 74 75 72 6e 73 command returns
0d10: 20 69 74 73 0a 5c 66 49 70 61 74 68 4e 61 6d 65 its.\fIpathName
0d20: 5c 66 52 20 61 72 67 75 6d 65 6e 74 2e 20 20 41 \fR argument. A
0d30: 74 20 74 68 65 20 74 69 6d 65 20 74 68 69 73 20 t the time this
0d40: 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b command is invok
0d50: 65 64 2c 0a 74 68 65 72 65 20 6d 75 73 74 20 6e ed,.there must n
0d60: 6f 74 20 65 78 69 73 74 20 61 20 77 69 6e 64 6f ot exist a windo
0d70: 77 20 6e 61 6d 65 64 20 5c 66 49 70 61 74 68 4e w named \fIpathN
0d80: 61 6d 65 5c 66 52 2c 20 62 75 74 0a 5c 66 49 70 ame\fR, but.\fIp
0d90: 61 74 68 4e 61 6d 65 5c 66 52 27 73 20 70 61 72 athName\fR's par
0da0: 65 6e 74 20 6d 75 73 74 20 65 78 69 73 74 2e 0a ent must exist..
0db0: 2e 50 50 0a 2e 56 53 0a 41 20 6d 65 6e 75 20 69 .PP..VS.A menu i
0dc0: 73 20 61 20 77 69 64 67 65 74 20 74 68 61 74 20 s a widget that
0dd0: 64 69 73 70 6c 61 79 73 20 61 20 63 6f 6c 6c 65 displays a colle
0de0: 63 74 69 6f 6e 20 6f 66 20 6f 6e 65 2d 6c 69 6e ction of one-lin
0df0: 65 20 65 6e 74 72 69 65 73 20 61 72 72 61 6e 67 e entries arrang
0e00: 65 64 0a 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 ed.in one or mor
0e10: 65 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 72 e columns. Ther
0e20: 65 20 65 78 69 73 74 20 73 65 76 65 72 61 6c 20 e exist several
0e30: 64 69 66 66 65 72 65 6e 74 20 74 79 70 65 73 20 different types
0e40: 6f 66 20 65 6e 74 72 69 65 73 2c 0a 65 61 63 68 of entries,.each
0e50: 20 77 69 74 68 20 64 69 66 66 65 72 65 6e 74 20 with different
0e60: 70 72 6f 70 65 72 74 69 65 73 2e 20 20 45 6e 74 properties. Ent
0e70: 72 69 65 73 20 6f 66 20 64 69 66 66 65 72 65 6e ries of differen
0e80: 74 20 74 79 70 65 73 20 6d 61 79 20 62 65 0a 63 t types may be.c
0e90: 6f 6d 62 69 6e 65 64 20 69 6e 20 61 20 73 69 6e ombined in a sin
0ea0: 67 6c 65 20 6d 65 6e 75 2e 20 20 4d 65 6e 75 20 gle menu. Menu
0eb0: 65 6e 74 72 69 65 73 20 61 72 65 20 6e 6f 74 20 entries are not
0ec0: 74 68 65 20 73 61 6d 65 20 61 73 0a 65 6e 74 72 the same as.entr
0ed0: 79 20 77 69 64 67 65 74 73 2e 20 20 49 6e 20 66 y widgets. In f
0ee0: 61 63 74 2c 20 6d 65 6e 75 20 65 6e 74 72 69 65 act, menu entrie
0ef0: 73 20 61 72 65 20 6e 6f 74 20 65 76 65 6e 20 64 s are not even d
0f00: 69 73 74 69 6e 63 74 20 77 69 64 67 65 74 73 3b istinct widgets;
0f10: 0a 74 68 65 20 65 6e 74 69 72 65 20 6d 65 6e 75 .the entire menu
0f20: 20 69 73 20 6f 6e 65 20 77 69 64 67 65 74 2e 0a is one widget..
0f30: 2e 56 45 0a 2e 50 50 0a 4d 65 6e 75 20 65 6e 74 .VE..PP.Menu ent
0f40: 72 69 65 73 20 61 72 65 20 64 69 73 70 6c 61 79 ries are display
0f50: 65 64 20 77 69 74 68 20 75 70 20 74 6f 20 74 68 ed with up to th
0f60: 72 65 65 20 73 65 70 61 72 61 74 65 20 66 69 65 ree separate fie
0f70: 6c 64 73 2e 0a 54 68 65 20 6d 61 69 6e 20 66 69 lds..The main fi
0f80: 65 6c 64 20 69 73 20 61 20 6c 61 62 65 6c 20 69 eld is a label i
0f90: 6e 20 74 68 65 20 66 6f 72 6d 20 6f 66 20 61 20 n the form of a
0fa0: 74 65 78 74 20 73 74 72 69 6e 67 2c 0a 61 20 62 text string,.a b
0fb0: 69 74 6d 61 70 2c 20 6f 72 20 61 6e 20 69 6d 61 itmap, or an ima
0fc0: 67 65 2c 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 ge, controlled b
0fd0: 79 20 74 68 65 20 5c 66 42 5c 2d 6c 61 62 65 6c y the \fB\-label
0fe0: 5c 66 52 2c 0a 5c 66 42 5c 2d 62 69 74 6d 61 70 \fR,.\fB\-bitmap
0ff0: 5c 66 52 2c 20 61 6e 64 20 5c 66 42 5c 2d 69 6d \fR, and \fB\-im
1000: 61 67 65 5c 66 52 20 6f 70 74 69 6f 6e 73 20 66 age\fR options f
1010: 6f 72 20 74 68 65 20 65 6e 74 72 79 2e 0a 49 66 or the entry..If
1020: 20 74 68 65 20 20 5c 66 42 5c 2d 61 63 63 65 6c the \fB\-accel
1030: 65 72 61 74 6f 72 5c 66 52 20 6f 70 74 69 6f 6e erator\fR option
1040: 20 69 73 20 73 70 65 63 69 66 69 65 64 20 66 6f is specified fo
1050: 72 20 61 6e 20 65 6e 74 72 79 20 74 68 65 6e 20 r an entry then
1060: 61 20 73 65 63 6f 6e 64 0a 74 65 78 74 75 61 6c a second.textual
1070: 20 66 69 65 6c 64 20 69 73 20 64 69 73 70 6c 61 field is displa
1080: 79 65 64 20 74 6f 20 74 68 65 20 72 69 67 68 74 yed to the right
1090: 20 6f 66 20 74 68 65 20 6c 61 62 65 6c 2e 20 20 of the label.
10a0: 54 68 65 20 61 63 63 65 6c 65 72 61 74 6f 72 0a The accelerator.
10b0: 74 79 70 69 63 61 6c 6c 79 20 64 65 73 63 72 69 typically descri
10c0: 62 65 73 20 61 20 6b 65 79 73 74 72 6f 6b 65 20 bes a keystroke
10d0: 73 65 71 75 65 6e 63 65 20 74 68 61 74 20 6d 61 sequence that ma
10e0: 79 20 62 65 20 74 79 70 65 64 20 69 6e 20 74 68 y be typed in th
10f0: 65 0a 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 6f e.application to
1100: 20 63 61 75 73 65 20 74 68 65 20 73 61 6d 65 20 cause the same
1110: 72 65 73 75 6c 74 20 61 73 20 69 6e 76 6f 6b 69 result as invoki
1120: 6e 67 20 74 68 65 20 6d 65 6e 75 20 65 6e 74 72 ng the menu entr
1130: 79 2e 0a 54 68 65 20 74 68 69 72 64 20 66 69 65 y..The third fie
1140: 6c 64 20 69 73 20 61 6e 20 5c 66 49 69 6e 64 69 ld is an \fIindi
1150: 63 61 74 6f 72 5c 66 52 2e 20 20 54 68 65 20 69 cator\fR. The i
1160: 6e 64 69 63 61 74 6f 72 20 69 73 20 70 72 65 73 ndicator is pres
1170: 65 6e 74 20 6f 6e 6c 79 20 66 6f 72 0a 63 68 65 ent only for.che
1180: 63 6b 62 75 74 74 6f 6e 20 6f 72 20 72 61 64 69 ckbutton or radi
1190: 6f 62 75 74 74 6f 6e 20 65 6e 74 72 69 65 73 2e obutton entries.
11a0: 20 20 49 74 20 69 6e 64 69 63 61 74 65 73 20 77 It indicates w
11b0: 68 65 74 68 65 72 20 74 68 65 20 65 6e 74 72 79 hether the entry
11c0: 0a 69 73 20 73 65 6c 65 63 74 65 64 20 6f 72 20 .is selected or
11d0: 6e 6f 74 2c 20 61 6e 64 20 69 73 20 64 69 73 70 not, and is disp
11e0: 6c 61 79 65 64 20 74 6f 20 74 68 65 20 6c 65 66 layed to the lef
11f0: 74 20 6f 66 20 74 68 65 20 65 6e 74 72 79 27 73 t of the entry's
1200: 0a 73 74 72 69 6e 67 2e 0a 2e 50 50 0a 49 6e 20 .string...PP.In
1210: 6e 6f 72 6d 61 6c 20 75 73 65 2c 20 61 6e 20 65 normal use, an e
1220: 6e 74 72 79 20 62 65 63 6f 6d 65 73 20 61 63 74 ntry becomes act
1230: 69 76 65 20 28 64 69 73 70 6c 61 79 73 20 69 74 ive (displays it
1240: 73 65 6c 66 20 64 69 66 66 65 72 65 6e 74 6c 79 self differently
1250: 29 0a 77 68 65 6e 65 76 65 72 20 74 68 65 20 6d ).whenever the m
1260: 6f 75 73 65 20 70 6f 69 6e 74 65 72 20 69 73 20 ouse pointer is
1270: 6f 76 65 72 20 74 68 65 20 65 6e 74 72 79 2e 20 over the entry.
1280: 20 49 66 20 61 20 6d 6f 75 73 65 0a 62 75 74 74 If a mouse.butt
1290: 6f 6e 20 69 73 20 72 65 6c 65 61 73 65 64 20 6f on is released o
12a0: 76 65 72 20 74 68 65 20 65 6e 74 72 79 20 74 68 ver the entry th
12b0: 65 6e 20 74 68 65 20 65 6e 74 72 79 20 69 73 20 en the entry is
12c0: 5c 66 49 69 6e 76 6f 6b 65 64 5c 66 52 2e 0a 54 \fIinvoked\fR..T
12d0: 68 65 20 65 66 66 65 63 74 20 6f 66 20 69 6e 76 he effect of inv
12e0: 6f 63 61 74 69 6f 6e 20 69 73 20 64 69 66 66 65 ocation is diffe
12f0: 72 65 6e 74 20 66 6f 72 20 65 61 63 68 20 74 79 rent for each ty
1300: 70 65 20 6f 66 20 65 6e 74 72 79 3b 0a 74 68 65 pe of entry;.the
1310: 73 65 20 65 66 66 65 63 74 73 20 61 72 65 20 64 se effects are d
1320: 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 20 69 escribed below i
1330: 6e 20 74 68 65 20 73 65 63 74 69 6f 6e 73 20 6f n the sections o
1340: 6e 20 69 6e 64 69 76 69 64 75 61 6c 0a 65 6e 74 n individual.ent
1350: 72 69 65 73 2e 0a 2e 50 50 0a 45 6e 74 72 69 65 ries...PP.Entrie
1360: 73 20 6d 61 79 20 62 65 20 5c 66 49 64 69 73 61 s may be \fIdisa
1370: 62 6c 65 64 5c 66 52 2c 20 77 68 69 63 68 20 63 bled\fR, which c
1380: 61 75 73 65 73 20 74 68 65 69 72 20 6c 61 62 65 auses their labe
1390: 6c 73 0a 61 6e 64 20 61 63 63 65 6c 65 72 61 74 ls.and accelerat
13a0: 6f 72 73 20 74 6f 20 62 65 20 64 69 73 70 6c 61 ors to be displa
13b0: 79 65 64 0a 77 69 74 68 20 64 69 6d 6d 65 72 20 yed.with dimmer
13c0: 63 6f 6c 6f 72 73 2e 0a 54 68 65 20 64 65 66 61 colors..The defa
13d0: 75 6c 74 20 6d 65 6e 75 20 62 69 6e 64 69 6e 67 ult menu binding
13e0: 73 20 77 69 6c 6c 20 6e 6f 74 20 61 6c 6c 6f 77 s will not allow
13f0: 0a 61 20 64 69 73 61 62 6c 65 64 20 65 6e 74 72 .a disabled entr
1400: 79 20 74 6f 20 62 65 20 61 63 74 69 76 61 74 65 y to be activate
1410: 64 20 6f 72 20 69 6e 76 6f 6b 65 64 2e 0a 44 69 d or invoked..Di
1420: 73 61 62 6c 65 64 20 65 6e 74 72 69 65 73 20 6d sabled entries m
1430: 61 79 20 62 65 20 72 65 2d 65 6e 61 62 6c 65 64 ay be re-enabled
1440: 2c 20 61 74 20 77 68 69 63 68 20 70 6f 69 6e 74 , at which point
1450: 20 69 74 20 62 65 63 6f 6d 65 73 0a 70 6f 73 73 it becomes.poss
1460: 69 62 6c 65 20 74 6f 20 61 63 74 69 76 61 74 65 ible to activate
1470: 20 61 6e 64 20 69 6e 76 6f 6b 65 20 74 68 65 6d and invoke them
1480: 20 61 67 61 69 6e 2e 0a 2e 56 53 0a 2e 50 50 0a again...VS..PP.
1490: 57 68 65 6e 65 76 65 72 20 61 20 6d 65 6e 75 27 Whenever a menu'
14a0: 73 20 61 63 74 69 76 65 20 65 6e 74 72 79 20 69 s active entry i
14b0: 73 20 63 68 61 6e 67 65 64 2c 20 61 20 3c 3c 4d s changed, a <<M
14c0: 65 6e 75 53 65 6c 65 63 74 3e 3e 20 76 69 72 74 enuSelect>> virt
14d0: 75 61 6c 0a 65 76 65 6e 74 20 69 73 20 73 65 6e ual.event is sen
14e0: 64 20 74 6f 20 74 68 65 20 6d 65 6e 75 2e 20 54 d to the menu. T
14f0: 68 65 20 61 63 74 69 76 65 20 69 74 65 6d 20 63 he active item c
1500: 61 6e 20 74 68 65 6e 20 62 65 20 71 75 65 72 69 an then be queri
1510: 65 64 20 66 72 6f 6d 0a 74 68 65 20 6d 65 6e 75 ed from.the menu
1520: 2c 20 61 6e 64 20 61 6e 20 61 63 74 69 6f 6e 20 , and an action
1530: 63 61 6e 20 62 65 20 74 61 6b 65 6e 2c 20 73 75 can be taken, su
1540: 63 68 20 61 73 20 73 65 74 74 69 6e 67 0a 63 6f ch as setting.co
1550: 6e 74 65 78 74 2d 73 65 6e 73 69 74 69 76 65 20 ntext-sensitive
1560: 68 65 6c 70 20 74 65 78 74 20 66 6f 72 20 74 68 help text for th
1570: 65 20 65 6e 74 72 79 2e 0a 2e 56 45 0a 0a 2e 53 e entry...VE...S
1580: 48 20 22 43 4f 4d 4d 41 4e 44 20 45 4e 54 52 49 H "COMMAND ENTRI
1590: 45 53 22 0a 2e 50 50 0a 54 68 65 20 6d 6f 73 74 ES"..PP.The most
15a0: 20 63 6f 6d 6d 6f 6e 20 6b 69 6e 64 20 6f 66 20 common kind of
15b0: 6d 65 6e 75 20 65 6e 74 72 79 20 69 73 20 61 20 menu entry is a
15c0: 63 6f 6d 6d 61 6e 64 20 65 6e 74 72 79 2c 20 77 command entry, w
15d0: 68 69 63 68 0a 62 65 68 61 76 65 73 20 6d 75 63 hich.behaves muc
15e0: 68 20 6c 69 6b 65 20 61 20 62 75 74 74 6f 6e 20 h like a button
15f0: 77 69 64 67 65 74 2e 20 20 57 68 65 6e 20 61 20 widget. When a
1600: 63 6f 6d 6d 61 6e 64 20 65 6e 74 72 79 20 69 73 command entry is
1610: 0a 69 6e 76 6f 6b 65 64 2c 20 61 20 54 63 6c 20 .invoked, a Tcl
1620: 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78 65 63 75 command is execu
1630: 74 65 64 2e 20 20 54 68 65 20 54 63 6c 0a 63 6f ted. The Tcl.co
1640: 6d 6d 61 6e 64 20 69 73 20 73 70 65 63 69 66 69 mmand is specifi
1650: 65 64 20 77 69 74 68 20 74 68 65 20 5c 66 42 5c ed with the \fB\
1660: 2d 63 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 -command\fR opti
1670: 6f 6e 2e 0a 0a 2e 53 48 20 22 53 45 50 41 52 41 on....SH "SEPARA
1680: 54 4f 52 20 45 4e 54 52 49 45 53 22 0a 2e 50 50 TOR ENTRIES"..PP
1690: 0a 41 20 73 65 70 61 72 61 74 6f 72 20 69 73 20 .A separator is
16a0: 61 6e 20 65 6e 74 72 79 20 74 68 61 74 20 69 73 an entry that is
16b0: 20 64 69 73 70 6c 61 79 65 64 20 61 73 20 61 20 displayed as a
16c0: 68 6f 72 69 7a 6f 6e 74 61 6c 20 64 69 76 69 64 horizontal divid
16d0: 69 6e 67 0a 6c 69 6e 65 2e 20 20 41 20 73 65 70 ing.line. A sep
16e0: 61 72 61 74 6f 72 20 6d 61 79 20 6e 6f 74 20 62 arator may not b
16f0: 65 20 61 63 74 69 76 61 74 65 64 20 6f 72 20 69 e activated or i
1700: 6e 76 6f 6b 65 64 2c 20 61 6e 64 20 69 74 20 68 nvoked, and it h
1710: 61 73 0a 6e 6f 20 62 65 68 61 76 69 6f 72 20 6f as.no behavior o
1720: 74 68 65 72 20 74 68 61 6e 20 69 74 73 20 64 69 ther than its di
1730: 73 70 6c 61 79 20 61 70 70 65 61 72 61 6e 63 65 splay appearance
1740: 2e 0a 0a 2e 53 48 20 22 43 48 45 43 4b 42 55 54 ....SH "CHECKBUT
1750: 54 4f 4e 20 45 4e 54 52 49 45 53 22 0a 2e 50 50 TON ENTRIES"..PP
1760: 0a 41 20 63 68 65 63 6b 62 75 74 74 6f 6e 20 6d .A checkbutton m
1770: 65 6e 75 20 65 6e 74 72 79 20 62 65 68 61 76 65 enu entry behave
1780: 73 20 6d 75 63 68 20 6c 69 6b 65 20 61 20 63 68 s much like a ch
1790: 65 63 6b 62 75 74 74 6f 6e 20 77 69 64 67 65 74 eckbutton widget
17a0: 2e 0a 57 68 65 6e 20 69 74 20 69 73 20 69 6e 76 ..When it is inv
17b0: 6f 6b 65 64 20 69 74 20 74 6f 67 67 6c 65 73 20 oked it toggles
17c0: 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 20 62 back and forth b
17d0: 65 74 77 65 65 6e 20 74 68 65 20 73 65 6c 65 63 etween the selec
17e0: 74 65 64 0a 61 6e 64 20 64 65 73 65 6c 65 63 74 ted.and deselect
17f0: 65 64 20 73 74 61 74 65 73 2e 20 20 57 68 65 6e ed states. When
1800: 20 74 68 65 20 65 6e 74 72 79 20 69 73 20 73 65 the entry is se
1810: 6c 65 63 74 65 64 2c 20 61 20 70 61 72 74 69 63 lected, a partic
1820: 75 6c 61 72 0a 76 61 6c 75 65 20 69 73 20 73 74 ular.value is st
1830: 6f 72 65 64 20 69 6e 20 61 20 70 61 72 74 69 63 ored in a partic
1840: 75 6c 61 72 20 67 6c 6f 62 61 6c 20 76 61 72 69 ular global vari
1850: 61 62 6c 65 20 28 61 73 20 64 65 74 65 72 6d 69 able (as determi
1860: 6e 65 64 20 62 79 0a 74 68 65 20 5c 66 42 5c 2d ned by.the \fB\-
1870: 6f 6e 76 61 6c 75 65 5c 66 52 20 61 6e 64 20 5c onvalue\fR and \
1880: 66 42 5c 2d 76 61 72 69 61 62 6c 65 5c 66 52 20 fB\-variable\fR
1890: 6f 70 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 options for the
18a0: 65 6e 74 72 79 29 3b 20 20 77 68 65 6e 0a 74 68 entry); when.th
18b0: 65 20 65 6e 74 72 79 20 69 73 20 64 65 73 65 6c e entry is desel
18c0: 65 63 74 65 64 20 61 6e 6f 74 68 65 72 20 76 61 ected another va
18d0: 6c 75 65 20 28 64 65 74 65 72 6d 69 6e 65 64 20 lue (determined
18e0: 62 79 20 74 68 65 0a 5c 66 42 5c 2d 6f 66 66 76 by the.\fB\-offv
18f0: 61 6c 75 65 5c 66 52 20 6f 70 74 69 6f 6e 29 20 alue\fR option)
1900: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 is stored in the
1910: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 global variable
1920: 2e 0a 41 6e 20 69 6e 64 69 63 61 74 6f 72 20 62 ..An indicator b
1930: 6f 78 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 ox is displayed
1940: 74 6f 20 74 68 65 20 6c 65 66 74 20 6f 66 20 74 to the left of t
1950: 68 65 20 6c 61 62 65 6c 20 69 6e 20 61 20 63 68 he label in a ch
1960: 65 63 6b 62 75 74 74 6f 6e 0a 65 6e 74 72 79 2e eckbutton.entry.
1970: 20 20 49 66 20 74 68 65 20 65 6e 74 72 79 20 69 If the entry i
1980: 73 20 73 65 6c 65 63 74 65 64 20 74 68 65 6e 20 s selected then
1990: 74 68 65 20 69 6e 64 69 63 61 74 6f 72 27 73 20 the indicator's
19a0: 63 65 6e 74 65 72 20 69 73 20 64 69 73 70 6c 61 center is displa
19b0: 79 65 64 0a 69 6e 20 74 68 65 20 63 6f 6c 6f 72 yed.in the color
19c0: 20 67 69 76 65 6e 20 62 79 20 74 68 65 20 5c 66 given by the \f
19d0: 42 5c 2d 73 65 6c 65 63 74 63 6f 6c 6f 72 5c 66 B\-selectcolor\f
19e0: 52 20 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 R option for the
19f0: 20 65 6e 74 72 79 3b 0a 6f 74 68 65 72 77 69 73 entry;.otherwis
1a00: 65 20 74 68 65 20 69 6e 64 69 63 61 74 6f 72 27 e the indicator'
1a10: 73 20 63 65 6e 74 65 72 20 69 73 20 64 69 73 70 s center is disp
1a20: 6c 61 79 65 64 20 69 6e 20 74 68 65 20 62 61 63 layed in the bac
1a30: 6b 67 72 6f 75 6e 64 20 63 6f 6c 6f 72 20 66 6f kground color fo
1a40: 72 0a 74 68 65 20 6d 65 6e 75 2e 20 20 49 66 20 r.the menu. If
1a50: 61 20 5c 66 42 5c 2d 63 6f 6d 6d 61 6e 64 5c 66 a \fB\-command\f
1a60: 52 20 6f 70 74 69 6f 6e 20 69 73 20 73 70 65 63 R option is spec
1a70: 69 66 69 65 64 20 66 6f 72 20 61 20 63 68 65 63 ified for a chec
1a80: 6b 62 75 74 74 6f 6e 0a 65 6e 74 72 79 2c 20 74 kbutton.entry, t
1a90: 68 65 6e 20 69 74 73 20 76 61 6c 75 65 20 69 73 hen its value is
1aa0: 20 65 76 61 6c 75 61 74 65 64 20 61 73 20 61 20 evaluated as a
1ab0: 54 63 6c 20 63 6f 6d 6d 61 6e 64 20 65 61 63 68 Tcl command each
1ac0: 20 74 69 6d 65 20 74 68 65 20 65 6e 74 72 79 0a time the entry.
1ad0: 69 73 20 69 6e 76 6f 6b 65 64 3b 20 20 74 68 69 is invoked; thi
1ae0: 73 20 68 61 70 70 65 6e 73 20 61 66 74 65 72 20 s happens after
1af0: 74 6f 67 67 6c 69 6e 67 20 74 68 65 20 65 6e 74 toggling the ent
1b00: 72 79 27 73 0a 73 65 6c 65 63 74 65 64 20 73 74 ry's.selected st
1b10: 61 74 65 2e 0a 0a 2e 53 48 20 22 52 41 44 49 4f ate....SH "RADIO
1b20: 42 55 54 54 4f 4e 20 45 4e 54 52 49 45 53 22 0a BUTTON ENTRIES".
1b30: 2e 50 50 0a 41 20 72 61 64 69 6f 62 75 74 74 6f .PP.A radiobutto
1b40: 6e 20 6d 65 6e 75 20 65 6e 74 72 79 20 62 65 68 n menu entry beh
1b50: 61 76 65 73 20 6d 75 63 68 20 6c 69 6b 65 20 61 aves much like a
1b60: 20 72 61 64 69 6f 62 75 74 74 6f 6e 20 77 69 64 radiobutton wid
1b70: 67 65 74 2e 0a 52 61 64 69 6f 62 75 74 74 6f 6e get..Radiobutton
1b80: 20 65 6e 74 72 69 65 73 20 61 72 65 20 6f 72 67 entries are org
1b90: 61 6e 69 7a 65 64 20 69 6e 20 67 72 6f 75 70 73 anized in groups
1ba0: 20 6f 66 20 77 68 69 63 68 20 6f 6e 6c 79 20 6f of which only o
1bb0: 6e 65 0a 65 6e 74 72 79 20 6d 61 79 20 62 65 20 ne.entry may be
1bc0: 73 65 6c 65 63 74 65 64 20 61 74 20 61 20 74 69 selected at a ti
1bd0: 6d 65 2e 20 20 57 68 65 6e 65 76 65 72 20 61 20 me. Whenever a
1be0: 70 61 72 74 69 63 75 6c 61 72 20 65 6e 74 72 79 particular entry
1bf0: 0a 62 65 63 6f 6d 65 73 20 73 65 6c 65 63 74 65 .becomes selecte
1c00: 64 20 69 74 20 73 74 6f 72 65 73 20 61 20 70 61 d it stores a pa
1c10: 72 74 69 63 75 6c 61 72 20 76 61 6c 75 65 20 69 rticular value i
1c20: 6e 74 6f 20 61 20 70 61 72 74 69 63 75 6c 61 72 nto a particular
1c30: 0a 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 .global variable
1c40: 20 28 61 73 20 64 65 74 65 72 6d 69 6e 65 64 20 (as determined
1c50: 62 79 20 74 68 65 20 5c 66 42 5c 2d 76 61 6c 75 by the \fB\-valu
1c60: 65 5c 66 52 20 61 6e 64 0a 5c 66 42 5c 2d 76 61 e\fR and.\fB\-va
1c70: 72 69 61 62 6c 65 5c 66 52 20 6f 70 74 69 6f 6e riable\fR option
1c80: 73 20 66 6f 72 20 74 68 65 20 65 6e 74 72 79 29 s for the entry)
1c90: 2e 20 20 54 68 69 73 20 61 63 74 69 6f 6e 0a 63 . This action.c
1ca0: 61 75 73 65 73 20 61 6e 79 20 70 72 65 76 69 6f auses any previo
1cb0: 75 73 6c 79 2d 73 65 6c 65 63 74 65 64 20 65 6e usly-selected en
1cc0: 74 72 79 20 69 6e 20 74 68 65 20 73 61 6d 65 20 try in the same
1cd0: 67 72 6f 75 70 0a 74 6f 20 64 65 73 65 6c 65 63 group.to deselec
1ce0: 74 20 69 74 73 65 6c 66 2e 0a 4f 6e 63 65 20 61 t itself..Once a
1cf0: 6e 20 65 6e 74 72 79 20 68 61 73 20 62 65 63 6f n entry has beco
1d00: 6d 65 20 73 65 6c 65 63 74 65 64 2c 20 61 6e 79 me selected, any
1d10: 20 63 68 61 6e 67 65 20 74 6f 20 74 68 65 20 65 change to the e
1d20: 6e 74 72 79 27 73 0a 61 73 73 6f 63 69 61 74 65 ntry's.associate
1d30: 64 20 76 61 72 69 61 62 6c 65 20 77 69 6c 6c 20 d variable will
1d40: 63 61 75 73 65 20 74 68 65 20 65 6e 74 72 79 20 cause the entry
1d50: 74 6f 20 64 65 73 65 6c 65 63 74 20 69 74 73 65 to deselect itse
1d60: 6c 66 2e 0a 47 72 6f 75 70 69 6e 67 20 6f 66 20 lf..Grouping of
1d70: 72 61 64 69 6f 62 75 74 74 6f 6e 20 65 6e 74 72 radiobutton entr
1d80: 69 65 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 ies is determine
1d90: 64 20 62 79 20 74 68 65 69 72 0a 61 73 73 6f 63 d by their.assoc
1da0: 69 61 74 65 64 20 76 61 72 69 61 62 6c 65 73 3a iated variables:
1db0: 20 20 69 66 20 74 77 6f 20 65 6e 74 72 69 65 73 if two entries
1dc0: 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 61 have the same a
1dd0: 73 73 6f 63 69 61 74 65 64 0a 76 61 72 69 61 62 ssociated.variab
1de0: 6c 65 20 74 68 65 6e 20 74 68 65 79 20 61 72 65 le then they are
1df0: 20 69 6e 20 74 68 65 20 73 61 6d 65 20 67 72 6f in the same gro
1e00: 75 70 2e 0a 41 6e 20 69 6e 64 69 63 61 74 6f 72 up..An indicator
1e10: 20 64 69 61 6d 6f 6e 64 20 69 73 20 64 69 73 70 diamond is disp
1e20: 6c 61 79 65 64 20 74 6f 20 74 68 65 20 6c 65 66 layed to the lef
1e30: 74 20 6f 66 20 74 68 65 20 6c 61 62 65 6c 20 69 t of the label i
1e40: 6e 20 65 61 63 68 0a 72 61 64 69 6f 62 75 74 74 n each.radiobutt
1e50: 6f 6e 20 65 6e 74 72 79 2e 20 20 49 66 20 74 68 on entry. If th
1e60: 65 20 65 6e 74 72 79 20 69 73 20 73 65 6c 65 63 e entry is selec
1e70: 74 65 64 20 74 68 65 6e 20 74 68 65 20 69 6e 64 ted then the ind
1e80: 69 63 61 74 6f 72 27 73 0a 63 65 6e 74 65 72 20 icator's.center
1e90: 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 6e 20 is displayed in
1ea0: 74 68 65 20 63 6f 6c 6f 72 20 67 69 76 65 6e 20 the color given
1eb0: 62 79 20 74 68 65 20 5c 66 42 5c 2d 73 65 6c 65 by the \fB\-sele
1ec0: 63 74 63 6f 6c 6f 72 5c 66 52 20 6f 70 74 69 6f ctcolor\fR optio
1ed0: 6e 0a 66 6f 72 20 74 68 65 20 65 6e 74 72 79 3b n.for the entry;
1ee0: 0a 6f 74 68 65 72 77 69 73 65 20 74 68 65 20 69 .otherwise the i
1ef0: 6e 64 69 63 61 74 6f 72 27 73 20 63 65 6e 74 65 ndicator's cente
1f00: 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 r is displayed i
1f10: 6e 20 74 68 65 20 62 61 63 6b 67 72 6f 75 6e 64 n the background
1f20: 20 63 6f 6c 6f 72 20 66 6f 72 0a 74 68 65 20 6d color for.the m
1f30: 65 6e 75 2e 20 20 49 66 20 61 20 5c 66 42 5c 2d enu. If a \fB\-
1f40: 63 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f command\fR optio
1f50: 6e 20 69 73 20 73 70 65 63 69 66 69 65 64 20 66 n is specified f
1f60: 6f 72 20 61 20 72 61 64 69 6f 62 75 74 74 6f 6e or a radiobutton
1f70: 0a 65 6e 74 72 79 2c 20 74 68 65 6e 20 69 74 73 .entry, then its
1f80: 20 76 61 6c 75 65 20 69 73 20 65 76 61 6c 75 61 value is evalua
1f90: 74 65 64 20 61 73 20 61 20 54 63 6c 20 63 6f 6d ted as a Tcl com
1fa0: 6d 61 6e 64 20 65 61 63 68 20 74 69 6d 65 20 74 mand each time t
1fb0: 68 65 20 65 6e 74 72 79 0a 69 73 20 69 6e 76 6f he entry.is invo
1fc0: 6b 65 64 3b 20 20 74 68 69 73 20 68 61 70 70 65 ked; this happe
1fd0: 6e 73 20 61 66 74 65 72 20 73 65 6c 65 63 74 69 ns after selecti
1fe0: 6e 67 20 74 68 65 20 65 6e 74 72 79 2e 0a 0a 2e ng the entry....
1ff0: 53 48 20 22 43 41 53 43 41 44 45 20 45 4e 54 52 SH "CASCADE ENTR
2000: 49 45 53 22 0a 2e 50 50 0a 41 20 63 61 73 63 61 IES"..PP.A casca
2010: 64 65 20 65 6e 74 72 79 20 69 73 20 6f 6e 65 20 de entry is one
2020: 77 69 74 68 20 61 6e 20 61 73 73 6f 63 69 61 74 with an associat
2030: 65 64 20 6d 65 6e 75 20 28 64 65 74 65 72 6d 69 ed menu (determi
2040: 6e 65 64 0a 62 79 20 74 68 65 20 5c 66 42 5c 2d ned.by the \fB\-
2050: 6d 65 6e 75 5c 66 52 20 6f 70 74 69 6f 6e 29 2e menu\fR option).
2060: 20 20 43 61 73 63 61 64 65 20 65 6e 74 72 69 65 Cascade entrie
2070: 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 6f 6e 73 s allow the cons
2080: 74 72 75 63 74 69 6f 6e 0a 6f 66 20 63 61 73 63 truction.of casc
2090: 61 64 69 6e 67 20 6d 65 6e 75 73 2e 0a 54 68 65 ading menus..The
20a0: 20 5c 66 42 70 6f 73 74 63 61 73 63 61 64 65 5c \fBpostcascade\
20b0: 66 52 20 77 69 64 67 65 74 20 63 6f 6d 6d 61 6e fR widget comman
20c0: 64 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f d can be used to
20d0: 20 70 6f 73 74 20 61 6e 64 20 75 6e 70 6f 73 74 post and unpost
20e0: 0a 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 .the associated
20f0: 6d 65 6e 75 20 6a 75 73 74 20 6e 65 78 74 20 74 menu just next t
2100: 6f 20 6f 66 20 74 68 65 20 63 61 73 63 61 64 65 o of the cascade
2110: 20 65 6e 74 72 79 2e 0a 54 68 65 20 61 73 73 6f entry..The asso
2120: 63 69 61 74 65 64 20 6d 65 6e 75 20 6d 75 73 74 ciated menu must
2130: 20 62 65 20 61 20 63 68 69 6c 64 20 6f 66 20 74 be a child of t
2140: 68 65 20 6d 65 6e 75 20 63 6f 6e 74 61 69 6e 69 he menu containi
2150: 6e 67 0a 74 68 65 20 63 61 73 63 61 64 65 20 65 ng.the cascade e
2160: 6e 74 72 79 20 28 74 68 69 73 20 69 73 20 6e 65 ntry (this is ne
2170: 65 64 65 64 20 69 6e 20 6f 72 64 65 72 20 66 6f eded in order fo
2180: 72 20 6d 65 6e 75 20 74 72 61 76 65 72 73 61 6c r menu traversal
2190: 20 74 6f 0a 77 6f 72 6b 20 63 6f 72 72 65 63 74 to.work correct
21a0: 6c 79 29 2e 0a 2e 50 50 0a 41 20 63 61 73 63 61 ly)...PP.A casca
21b0: 64 65 20 65 6e 74 72 79 20 70 6f 73 74 73 20 69 de entry posts i
21c0: 74 73 20 61 73 73 6f 63 69 61 74 65 64 20 6d 65 ts associated me
21d0: 6e 75 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 61 nu by invoking a
21e0: 0a 54 63 6c 20 63 6f 6d 6d 61 6e 64 20 6f 66 20 .Tcl command of
21f0: 74 68 65 20 66 6f 72 6d 0a 2e 43 53 0a 5c 66 49 the form..CS.\fI
2200: 6d 65 6e 75 5c 66 42 20 70 6f 73 74 20 5c 66 49 menu\fB post \fI
2210: 78 20 79 5c 66 52 0a 2e 43 45 0a 77 68 65 72 65 x y\fR..CE.where
2220: 20 5c 66 49 6d 65 6e 75 5c 66 52 20 69 73 20 74 \fImenu\fR is t
2230: 68 65 20 70 61 74 68 20 6e 61 6d 65 20 6f 66 20 he path name of
2240: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 6d the associated m
2250: 65 6e 75 2c 20 61 6e 64 20 5c 66 49 78 5c 66 52 enu, and \fIx\fR
2260: 0a 61 6e 64 20 5c 66 49 79 5c 66 52 20 61 72 65 .and \fIy\fR are
2270: 20 74 68 65 20 72 6f 6f 74 2d 77 69 6e 64 6f 77 the root-window
2280: 20 63 6f 6f 72 64 69 6e 61 74 65 73 20 6f 66 20 coordinates of
2290: 74 68 65 20 75 70 70 65 72 2d 72 69 67 68 74 0a the upper-right.
22a0: 63 6f 72 6e 65 72 20 6f 66 20 74 68 65 20 63 61 corner of the ca
22b0: 73 63 61 64 65 20 65 6e 74 72 79 2e 0a 2e 56 53 scade entry...VS
22c0: 0a 4f 6e 20 55 6e 69 78 2c 20 74 68 65 20 6c 6f .On Unix, the lo
22d0: 77 65 72 2d 6c 65 76 65 6c 20 6d 65 6e 75 20 69 wer-level menu i
22e0: 73 20 75 6e 70 6f 73 74 65 64 20 62 79 20 65 78 s unposted by ex
22f0: 65 63 75 74 69 6e 67 20 61 20 54 63 6c 20 63 6f ecuting a Tcl co
2300: 6d 6d 61 6e 64 20 77 69 74 68 0a 74 68 65 20 66 mmand with.the f
2310: 6f 72 6d 0a 2e 43 53 0a 5c 66 49 6d 65 6e 75 5c orm..CS.\fImenu\
2320: 66 42 20 75 6e 70 6f 73 74 5c 66 52 0a 2e 43 45 fB unpost\fR..CE
2330: 0a 77 68 65 72 65 20 5c 66 49 6d 65 6e 75 5c 66 .where \fImenu\f
2340: 52 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 R is the name of
2350: 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 the associated
2360: 6d 65 6e 75 2e 0a 4f 6e 20 6f 74 68 65 72 20 70 menu..On other p
2370: 6c 61 74 66 6f 72 6d 73 2c 20 74 68 65 20 70 6c latforms, the pl
2380: 61 74 66 6f 72 6d 27 73 20 6e 61 74 69 76 65 20 atform's native
2390: 63 6f 64 65 20 74 61 6b 65 73 20 63 61 72 65 20 code takes care
23a0: 6f 66 20 75 6e 70 6f 73 74 69 6e 67 20 74 68 65 of unposting the
23b0: 0a 6d 65 6e 75 2e 0a 2e 56 45 0a 2e 50 50 0a 2e .menu...VE..PP..
23c0: 56 53 0a 49 66 20 61 20 5c 66 42 5c 2d 63 6f 6d VS.If a \fB\-com
23d0: 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 20 69 mand\fR option i
23e0: 73 20 73 70 65 63 69 66 69 65 64 20 66 6f 72 20 s specified for
23f0: 61 20 63 61 73 63 61 64 65 20 65 6e 74 72 79 20 a cascade entry
2400: 74 68 65 6e 20 69 74 20 69 73 0a 65 76 61 6c 75 then it is.evalu
2410: 61 74 65 64 20 61 73 20 61 20 54 63 6c 20 63 6f ated as a Tcl co
2420: 6d 6d 61 6e 64 20 77 68 65 6e 65 76 65 72 20 74 mmand whenever t
2430: 68 65 20 65 6e 74 72 79 20 69 73 20 69 6e 76 6f he entry is invo
2440: 6b 65 64 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 ked. This is not
2450: 0a 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 57 69 .supported on Wi
2460: 6e 64 6f 77 73 2e 0a 2e 56 45 0a 0a 2e 53 48 20 ndows...VE...SH
2470: 22 54 45 41 52 2d 4f 46 46 20 45 4e 54 52 49 45 "TEAR-OFF ENTRIE
2480: 53 22 0a 2e 50 50 0a 41 20 74 65 61 72 2d 6f 66 S"..PP.A tear-of
2490: 66 20 65 6e 74 72 79 20 61 70 70 65 61 72 73 20 f entry appears
24a0: 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 at the top of th
24b0: 65 20 6d 65 6e 75 20 69 66 20 65 6e 61 62 6c 65 e menu if enable
24c0: 64 20 77 69 74 68 20 74 68 65 0a 5c 66 42 74 65 d with the.\fBte
24d0: 61 72 4f 66 66 5c 66 52 20 6f 70 74 69 6f 6e 2e arOff\fR option.
24e0: 20 20 49 74 20 69 73 20 6e 6f 74 20 6c 69 6b 65 It is not like
24f0: 20 6f 74 68 65 72 20 6d 65 6e 75 20 65 6e 74 72 other menu entr
2500: 69 65 73 20 69 6e 20 74 68 61 74 0a 69 74 20 63 ies in that.it c
2510: 61 6e 6e 6f 74 20 62 65 20 63 72 65 61 74 65 64 annot be created
2520: 20 77 69 74 68 20 74 68 65 20 5c 66 42 61 64 64 with the \fBadd
2530: 5c 66 52 20 77 69 64 67 65 74 20 63 6f 6d 6d 61 \fR widget comma
2540: 6e 64 20 61 6e 64 0a 63 61 6e 6e 6f 74 20 62 65 nd and.cannot be
2550: 20 64 65 6c 65 74 65 64 20 77 69 74 68 20 74 68 deleted with th
2560: 65 20 5c 66 42 64 65 6c 65 74 65 5c 66 52 20 77 e \fBdelete\fR w
2570: 69 64 67 65 74 20 63 6f 6d 6d 61 6e 64 2e 0a 57 idget command..W
2580: 68 65 6e 20 61 20 74 65 61 72 2d 6f 66 66 20 65 hen a tear-off e
2590: 6e 74 72 79 20 69 73 20 63 72 65 61 74 65 64 20 ntry is created
25a0: 69 74 20 61 70 70 65 61 72 73 20 61 73 20 61 20 it appears as a
25b0: 64 61 73 68 65 64 20 6c 69 6e 65 20 61 74 0a 74 dashed line at.t
25c0: 68 65 20 74 6f 70 20 6f 66 20 74 68 65 20 6d 65 he top of the me
25d0: 6e 75 2e 20 20 55 6e 64 65 72 20 74 68 65 20 64 nu. Under the d
25e0: 65 66 61 75 6c 74 20 62 69 6e 64 69 6e 67 73 2c efault bindings,
25f0: 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 0a 74 65 invoking the.te
2600: 61 72 2d 6f 66 66 20 65 6e 74 72 79 20 63 61 75 ar-off entry cau
2610: 73 65 73 20 61 20 74 6f 72 6e 2d 6f 66 66 20 63 ses a torn-off c
2620: 6f 70 79 20 74 6f 20 62 65 20 6d 61 64 65 20 6f opy to be made o
2630: 66 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 0a 61 f the menu and.a
2640: 6c 6c 20 6f 66 20 69 74 73 20 73 75 62 6d 65 6e ll of its submen
2650: 75 73 2e 0a 0a 2e 56 53 0a 2e 53 48 20 22 4d 45 us....VS..SH "ME
2660: 4e 55 42 41 52 53 22 0a 2e 50 50 0a 41 6e 79 20 NUBARS"..PP.Any
2670: 6d 65 6e 75 20 63 61 6e 20 62 65 20 73 65 74 20 menu can be set
2680: 61 73 20 61 20 6d 65 6e 75 62 61 72 20 66 6f 72 as a menubar for
2690: 20 61 20 74 6f 70 6c 65 76 65 6c 20 77 69 6e 64 a toplevel wind
26a0: 6f 77 20 28 73 65 65 0a 5c 66 42 74 6f 70 6c 65 ow (see.\fBtople
26b0: 76 65 6c 5c 66 52 20 63 6f 6d 6d 61 6e 64 20 66 vel\fR command f
26c0: 6f 72 20 73 79 6e 74 61 78 29 2e 20 4f 6e 20 74 or syntax). On t
26d0: 68 65 20 4d 61 63 69 6e 74 6f 73 68 2c 20 77 68 he Macintosh, wh
26e0: 65 6e 65 76 65 72 20 74 68 65 0a 74 6f 70 6c 65 enever the.tople
26f0: 76 65 6c 20 69 73 20 69 6e 20 66 72 6f 6e 74 2c vel is in front,
2700: 20 74 68 69 73 20 6d 65 6e 75 27 73 20 63 61 73 this menu's cas
2710: 63 61 64 65 20 69 74 65 6d 73 20 77 69 6c 6c 20 cade items will
2720: 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a 6d 65 appear in the.me
2730: 6e 75 62 61 72 20 61 63 72 6f 73 73 20 74 68 65 nubar across the
2740: 20 74 6f 70 20 6f 66 20 74 68 65 20 6d 61 69 6e top of the main
2750: 20 6d 6f 6e 69 74 6f 72 2e 20 4f 6e 20 57 69 6e monitor. On Win
2760: 64 6f 77 73 20 61 6e 64 20 55 6e 69 78 2c 20 74 dows and Unix, t
2770: 68 69 73 0a 6d 65 6e 75 27 73 20 69 74 65 6d 73 his.menu's items
2780: 20 77 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 will be display
2790: 65 64 20 69 6e 20 61 20 6d 65 6e 75 62 61 72 20 ed in a menubar
27a0: 61 63 72 6f 73 73 20 74 68 65 20 74 6f 70 20 6f across the top o
27b0: 66 20 74 68 65 0a 77 69 6e 64 6f 77 2e 20 54 68 f the.window. Th
27c0: 65 73 65 20 6d 65 6e 75 73 20 77 69 6c 6c 20 62 ese menus will b
27d0: 65 68 61 76 65 20 61 63 63 6f 72 64 69 6e 67 20 ehave according
27e0: 74 6f 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 to the interface
27f0: 20 67 75 69 64 65 6c 69 6e 65 73 0a 6f 66 20 74 guidelines.of t
2800: 68 65 69 72 20 70 6c 61 74 66 6f 72 6d 73 2e 20 heir platforms.
2810: 46 6f 72 20 65 76 65 72 79 20 6d 65 6e 75 20 73 For every menu s
2820: 65 74 20 61 73 20 61 20 6d 65 6e 75 62 61 72 2c et as a menubar,
2830: 20 61 20 63 6c 6f 6e 65 20 6d 65 6e 75 20 69 73 a clone menu is
2840: 0a 6d 61 64 65 2e 20 53 65 65 20 74 68 65 20 5c .made. See the \
2850: 66 42 43 4c 4f 4e 45 53 5c 66 52 20 73 65 63 74 fBCLONES\fR sect
2860: 69 6f 6e 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 ion for more inf
2870: 6f 72 6d 61 74 69 6f 6e 2e 0a 2e 50 50 0a 41 73 ormation...PP.As
2880: 20 6e 6f 74 65 64 2c 20 6d 65 6e 75 62 61 72 73 noted, menubars
2890: 20 6d 61 79 20 62 65 68 61 76 65 20 64 69 66 66 may behave diff
28a0: 65 72 65 6e 74 6c 79 20 6f 6e 20 64 69 66 66 65 erently on diffe
28b0: 72 65 6e 74 20 70 6c 61 74 66 6f 72 6d 73 2e 20 rent platforms.
28c0: 20 4f 6e 65 0a 65 78 61 6d 70 6c 65 20 6f 66 20 One.example of
28d0: 74 68 69 73 20 63 6f 6e 63 65 72 6e 73 20 74 68 this concerns th
28e0: 65 20 68 61 6e 64 6c 69 6e 67 20 6f 66 20 63 68 e handling of ch
28f0: 65 63 6b 62 75 74 74 6f 6e 73 20 61 6e 64 20 72 eckbuttons and r
2900: 61 64 69 6f 62 75 74 74 6f 6e 73 0a 77 69 74 68 adiobuttons.with
2910: 69 6e 20 74 68 65 20 6d 65 6e 75 2e 20 20 57 68 in the menu. Wh
2920: 69 6c 65 20 69 74 20 69 73 20 70 65 72 6d 69 74 ile it is permit
2930: 74 65 64 20 74 6f 20 70 75 74 20 74 68 65 73 65 ted to put these
2940: 20 6d 65 6e 75 20 65 6c 65 6d 65 6e 74 73 20 6f menu elements o
2950: 6e 0a 6d 65 6e 75 62 61 72 73 2c 20 74 68 65 79 n.menubars, they
2960: 20 6d 61 79 20 6e 6f 74 20 62 65 20 64 72 61 77 may not be draw
2970: 6e 20 77 69 74 68 20 69 6e 64 69 63 61 74 6f 72 n with indicator
2980: 73 20 6f 6e 20 73 6f 6d 65 20 70 6c 61 74 66 6f s on some platfo
2990: 72 6d 73 2c 20 64 75 65 0a 74 6f 20 73 79 73 74 rms, due.to syst
29a0: 65 6d 20 72 65 73 74 72 69 63 74 69 6f 6e 73 2e em restrictions.
29b0: 0a 2e 56 45 0a 0a 2e 56 53 0a 2e 53 48 20 22 53 ..VE...VS..SH "S
29c0: 50 45 43 49 41 4c 20 4d 45 4e 55 53 20 49 4e 20 PECIAL MENUS IN
29d0: 4d 45 4e 55 42 41 52 53 22 0a 2e 50 50 0a 43 65 MENUBARS"..PP.Ce
29e0: 72 74 61 69 6e 20 6d 65 6e 75 73 20 69 6e 20 61 rtain menus in a
29f0: 20 6d 65 6e 75 62 61 72 20 77 69 6c 6c 20 62 65 menubar will be
2a00: 20 74 72 65 61 74 65 64 20 73 70 65 63 69 61 6c treated special
2a10: 6c 79 2e 20 20 4f 6e 20 74 68 65 20 4d 61 63 69 ly. On the Maci
2a20: 6e 74 6f 73 68 2c 0a 61 63 63 65 73 73 20 74 6f ntosh,.access to
2a30: 20 74 68 65 20 73 70 65 63 69 61 6c 20 41 70 70 the special App
2a40: 6c 65 20 61 6e 64 20 48 65 6c 70 20 6d 65 6e 75 le and Help menu
2a50: 73 20 69 73 20 70 72 6f 76 69 64 65 64 2e 20 4f s is provided. O
2a60: 6e 20 57 69 6e 64 6f 77 73 2c 0a 61 63 63 65 73 n Windows,.acces
2a70: 73 20 74 6f 20 74 68 65 20 57 69 6e 64 6f 77 73 s to the Windows
2a80: 20 53 79 73 74 65 6d 20 6d 65 6e 75 20 69 6e 20 System menu in
2a90: 65 61 63 68 20 77 69 6e 64 6f 77 20 69 73 20 70 each window is p
2aa0: 72 6f 76 69 64 65 64 2e 20 4f 6e 20 58 20 57 69 rovided. On X Wi
2ab0: 6e 64 6f 77 73 2c 0a 61 20 73 70 65 63 69 61 6c ndows,.a special
2ac0: 20 72 69 67 68 74 2d 6a 75 73 74 69 66 69 65 64 right-justified
2ad0: 20 68 65 6c 70 20 6d 65 6e 75 20 69 73 20 70 72 help menu is pr
2ae0: 6f 76 69 64 65 64 2e 20 49 6e 20 61 6c 6c 20 63 ovided. In all c
2af0: 61 73 65 73 2c 20 74 68 65 73 65 0a 6d 65 6e 75 ases, these.menu
2b00: 73 20 6d 75 73 74 20 62 65 20 63 72 65 61 74 65 s must be create
2b10: 64 20 77 69 74 68 20 74 68 65 20 63 6f 6d 6d 61 d with the comma
2b20: 6e 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6d nd name of the m
2b30: 65 6e 75 62 61 72 20 6d 65 6e 75 20 63 6f 6e 63 enubar menu conc
2b40: 61 74 65 6e 61 74 65 64 0a 77 69 74 68 20 74 68 atenated.with th
2b50: 65 20 73 70 65 63 69 61 6c 20 6e 61 6d 65 2e 20 e special name.
2b60: 53 6f 20 66 6f 72 20 61 20 6d 65 6e 75 62 61 72 So for a menubar
2b70: 20 6e 61 6d 65 64 20 2e 6d 65 6e 75 62 61 72 2c named .menubar,
2b80: 20 6f 6e 20 74 68 65 20 4d 61 63 69 6e 74 6f 73 on the Macintos
2b90: 68 2c 0a 74 68 65 20 73 70 65 63 69 61 6c 20 6d h,.the special m
2ba0: 65 6e 75 73 20 77 6f 75 6c 64 20 62 65 20 2e 6d enus would be .m
2bb0: 65 6e 75 62 61 72 2e 61 70 70 6c 65 20 61 6e 64 enubar.apple and
2bc0: 20 2e 6d 65 6e 75 62 61 72 2e 68 65 6c 70 3b 20 .menubar.help;
2bd0: 6f 6e 20 57 69 6e 64 6f 77 73 2c 0a 74 68 65 20 on Windows,.the
2be0: 73 70 65 63 69 61 6c 20 6d 65 6e 75 20 77 6f 75 special menu wou
2bf0: 6c 64 20 62 65 20 2e 6d 65 6e 75 62 61 72 2e 73 ld be .menubar.s
2c00: 79 73 74 65 6d 3b 20 6f 6e 20 58 20 57 69 6e 64 ystem; on X Wind
2c10: 6f 77 73 2c 20 74 68 65 20 68 65 6c 70 0a 6d 65 ows, the help.me
2c20: 6e 75 20 77 6f 75 6c 64 20 62 65 20 2e 6d 65 6e nu would be .men
2c30: 75 62 61 72 2e 68 65 6c 70 2e 0a 2e 50 50 0a 57 ubar.help...PP.W
2c40: 68 65 6e 20 54 6b 20 73 65 65 73 20 61 6e 20 41 hen Tk sees an A
2c50: 70 70 6c 65 20 6d 65 6e 75 20 6f 6e 20 74 68 65 pple menu on the
2c60: 20 4d 61 63 69 6e 74 6f 73 68 2c 20 74 68 61 74 Macintosh, that
2c70: 20 6d 65 6e 75 27 73 20 63 6f 6e 74 65 6e 74 73 menu's contents
2c80: 20 6d 61 6b 65 0a 75 70 20 74 68 65 20 66 69 72 make.up the fir
2c90: 73 74 20 69 74 65 6d 73 20 6f 66 20 74 68 65 20 st items of the
2ca0: 41 70 70 6c 65 20 6d 65 6e 75 20 6f 6e 20 74 68 Apple menu on th
2cb0: 65 20 73 63 72 65 65 6e 20 77 68 65 6e 65 76 65 e screen wheneve
2cc0: 72 20 74 68 65 20 77 69 6e 64 6f 77 0a 63 6f 6e r the window.con
2cd0: 74 61 69 6e 69 6e 67 20 74 68 65 20 6d 65 6e 75 taining the menu
2ce0: 62 61 72 20 69 73 20 69 6e 20 66 72 6f 6e 74 2e bar is in front.
2cf0: 20 54 68 65 20 6d 65 6e 75 20 69 73 20 74 68 65 The menu is the
2d00: 0a 66 69 72 73 74 20 6f 6e 65 20 74 68 61 74 20 .first one that
2d10: 74 68 65 20 75 73 65 72 20 73 65 65 73 20 61 6e the user sees an
2d20: 64 20 68 61 73 20 61 20 74 69 74 6c 65 20 77 68 d has a title wh
2d30: 69 63 68 20 69 73 20 61 6e 20 41 70 70 6c 65 20 ich is an Apple
2d40: 6c 6f 67 6f 2e 0a 41 66 74 65 72 20 61 6c 6c 20 logo..After all
2d50: 6f 66 20 74 68 65 20 54 6b 2d 64 65 66 69 6e 65 of the Tk-define
2d60: 64 20 69 74 65 6d 73 2c 20 74 68 65 20 6d 65 6e d items, the men
2d70: 75 20 77 69 6c 6c 20 68 61 76 65 20 61 20 73 65 u will have a se
2d80: 70 61 72 61 74 6f 72 2c 0a 66 6f 6c 6c 6f 77 65 parator,.followe
2d90: 64 20 62 79 20 61 6c 6c 20 6f 66 20 74 68 65 20 d by all of the
2da0: 69 74 65 6d 73 20 69 6e 20 74 68 65 20 75 73 65 items in the use
2db0: 72 27 73 20 41 70 70 6c 65 20 4d 65 6e 75 20 49 r's Apple Menu I
2dc0: 74 65 6d 73 20 66 6f 6c 64 65 72 2e 0a 53 69 6e tems folder..Sin
2dd0: 63 65 20 74 68 65 20 53 79 73 74 65 6d 20 75 73 ce the System us
2de0: 65 73 20 61 20 64 69 66 66 65 72 65 6e 74 20 6d es a different m
2df0: 65 6e 75 20 64 65 66 69 6e 69 74 69 6f 6e 20 70 enu definition p
2e00: 72 6f 63 65 64 75 72 65 20 66 6f 72 0a 74 68 65 rocedure for.the
2e10: 20 41 70 70 6c 65 20 6d 65 6e 75 20 74 68 61 6e Apple menu than
2e20: 20 54 6b 20 75 73 65 73 20 66 6f 72 20 69 74 73 Tk uses for its
2e30: 20 6d 65 6e 75 73 2c 20 61 6e 64 20 74 68 65 20 menus, and the
2e40: 73 79 73 74 65 6d 20 41 50 49 73 20 64 6f 0a 6e system APIs do.n
2e50: 6f 74 20 66 75 6c 6c 79 20 73 75 70 70 6f 72 74 ot fully support
2e60: 20 65 76 65 72 79 74 68 69 6e 67 20 54 6b 20 74 everything Tk t
2e70: 72 69 65 73 20 74 6f 20 64 6f 2c 20 74 68 65 20 ries to do, the
2e80: 6d 65 6e 75 20 69 74 65 6d 20 77 69 6c 6c 20 6f menu item will o
2e90: 6e 6c 79 0a 68 61 76 65 20 69 74 73 20 74 65 78 nly.have its tex
2ea0: 74 20 64 69 73 70 6c 61 79 65 64 2e 20 4e 6f 20 t displayed. No
2eb0: 66 6f 6e 74 20 61 74 74 72 69 62 75 74 65 73 2c font attributes,
2ec0: 20 69 6d 61 67 65 73 2c 20 62 69 74 6d 61 70 73 images, bitmaps
2ed0: 2c 20 6f 72 20 63 6f 6c 6f 72 73 0a 77 69 6c 6c , or colors.will
2ee0: 20 62 65 20 64 69 73 70 6c 61 79 65 64 2e 20 49 be displayed. I
2ef0: 6e 20 61 64 64 69 74 69 6f 6e 2c 20 61 20 6d 65 n addition, a me
2f00: 6e 75 20 77 69 74 68 20 61 20 74 65 61 72 6f 66 nu with a tearof
2f10: 66 20 69 74 65 6d 20 77 69 6c 6c 20 68 61 76 65 f item will have
2f20: 0a 74 68 65 20 74 65 61 72 6f 66 66 20 69 74 65 .the tearoff ite
2f30: 6d 20 64 69 73 70 6c 61 79 65 64 20 61 73 20 22 m displayed as "
2f40: 28 54 65 61 72 4f 66 66 29 22 2e 0a 2e 50 50 0a (TearOff)"...PP.
2f50: 57 68 65 6e 20 54 6b 20 73 65 65 20 61 20 48 65 When Tk see a He
2f60: 6c 70 20 6d 65 6e 75 20 6f 6e 20 74 68 65 20 4d lp menu on the M
2f70: 61 63 69 6e 74 6f 73 68 2c 20 74 68 65 20 6d 65 acintosh, the me
2f80: 6e 75 27 73 20 63 6f 6e 74 65 6e 74 73 20 61 72 nu's contents ar
2f90: 65 0a 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 e.appended to th
2fa0: 65 20 73 74 61 6e 64 61 72 64 20 68 65 6c 70 20 e standard help
2fb0: 6d 65 6e 75 20 6f 6e 20 74 68 65 20 72 69 67 68 menu on the righ
2fc0: 74 20 6f 66 20 74 68 65 20 75 73 65 72 27 73 20 t of the user's
2fd0: 6d 65 6e 75 62 61 72 0a 77 68 65 6e 65 76 65 72 menubar.whenever
2fe0: 20 74 68 65 20 75 73 65 72 27 73 20 6d 65 6e 75 the user's menu
2ff0: 62 61 72 20 69 73 20 69 6e 20 66 72 6f 6e 74 2e bar is in front.
3000: 20 54 68 65 20 66 69 72 73 74 20 69 74 65 6d 73 The first items
3010: 20 69 6e 20 74 68 65 20 6d 65 6e 75 0a 61 72 65 in the menu.are
3020: 20 70 72 6f 76 69 64 65 64 20 62 79 20 41 70 70 provided by App
3030: 6c 65 2e 20 53 69 6d 69 6c 61 72 20 74 6f 20 74 le. Similar to t
3040: 68 65 20 41 70 70 6c 65 20 4d 65 6e 75 2c 20 63 he Apple Menu, c
3050: 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 20 69 6e 20 ustomization in
3060: 74 68 69 73 0a 6d 65 6e 75 20 69 73 20 6c 69 6d this.menu is lim
3070: 69 74 65 64 20 74 6f 20 77 68 61 74 20 74 68 65 ited to what the
3080: 20 73 79 73 74 65 6d 20 70 72 6f 76 69 64 65 73 system provides
3090: 2e 0a 2e 50 50 0a 57 68 65 6e 20 54 6b 20 73 65 ...PP.When Tk se
30a0: 65 73 20 61 20 53 79 73 74 65 6d 20 6d 65 6e 75 es a System menu
30b0: 20 6f 6e 20 57 69 6e 64 6f 77 73 2c 20 69 74 73 on Windows, its
30c0: 20 69 74 65 6d 73 20 61 72 65 20 61 70 70 65 6e items are appen
30d0: 64 65 64 20 74 6f 20 74 68 65 20 0a 73 79 73 74 ded to the .syst
30e0: 65 6d 20 6d 65 6e 75 20 74 68 61 74 20 74 68 65 em menu that the
30f0: 20 6d 65 6e 75 62 61 72 20 69 73 20 61 74 74 61 menubar is atta
3100: 63 68 65 64 20 74 6f 2e 20 54 68 69 73 20 6d 65 ched to. This me
3110: 6e 75 20 68 61 73 20 61 6e 20 69 63 6f 6e 0a 72 nu has an icon.r
3120: 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20 73 70 epresenting a sp
3130: 61 63 65 62 61 72 2c 20 61 6e 64 20 63 61 6e 20 acebar, and can
3140: 62 65 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 be invoked with
3150: 74 68 65 20 6d 6f 75 73 65 20 6f 72 20 62 79 20 the mouse or by
3160: 74 79 70 69 6e 67 0a 41 6c 74 2b 53 70 61 63 65 typing.Alt+Space
3170: 62 61 72 2e 20 20 44 75 65 20 74 6f 20 6c 69 6d bar. Due to lim
3180: 69 74 61 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 itations in the
3190: 57 69 6e 64 6f 77 73 20 41 50 49 2c 20 61 6e 79 Windows API, any
31a0: 20 66 6f 6e 74 20 63 68 61 6e 67 65 73 2c 0a 63 font changes,.c
31b0: 6f 6c 6f 72 73 2c 20 69 6d 61 67 65 73 2c 20 62 olors, images, b
31c0: 69 74 6d 61 70 73 2c 20 6f 72 20 74 65 61 72 6f itmaps, or tearo
31d0: 66 66 20 69 6d 61 67 65 73 20 77 69 6c 6c 20 6e ff images will n
31e0: 6f 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 ot appear in the
31f0: 0a 73 79 73 74 65 6d 20 6d 65 6e 75 2e 0a 2e 50 .system menu...P
3200: 50 0a 57 68 65 6e 20 54 6b 20 73 65 65 20 61 20 P.When Tk see a
3210: 48 65 6c 70 20 6d 65 6e 75 20 6f 6e 20 58 20 57 Help menu on X W
3220: 69 6e 64 6f 77 73 2c 20 74 68 65 20 6d 65 6e 75 indows, the menu
3230: 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 62 65 20 is moved to be
3240: 6c 61 73 74 20 69 6e 0a 74 68 65 20 6d 65 6e 75 last in.the menu
3250: 62 61 72 20 61 6e 64 20 69 73 20 72 69 67 68 74 bar and is right
3260: 20 6a 75 73 74 69 66 69 65 64 2e 0a 2e 56 45 0a justified...VE.
3270: 0a 2e 56 53 0a 2e 53 48 20 22 43 4c 4f 4e 45 53 ..VS..SH "CLONES
3280: 22 0a 2e 50 50 0a 57 68 65 6e 20 61 20 6d 65 6e "..PP.When a men
3290: 75 20 69 73 20 73 65 74 20 61 73 20 61 20 6d 65 u is set as a me
32a0: 6e 75 62 61 72 20 66 6f 72 20 61 20 74 6f 70 6c nubar for a topl
32b0: 65 76 65 6c 20 77 69 6e 64 6f 77 2c 20 6f 72 20 evel window, or
32c0: 77 68 65 6e 20 61 20 6d 65 6e 75 0a 69 73 20 74 when a menu.is t
32d0: 6f 72 6e 20 6f 66 66 2c 20 61 20 63 6c 6f 6e 65 orn off, a clone
32e0: 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 69 73 20 of the menu is
32f0: 6d 61 64 65 2e 20 54 68 69 73 20 63 6c 6f 6e 65 made. This clone
3300: 20 69 73 20 61 20 6d 65 6e 75 20 77 69 64 67 65 is a menu widge
3310: 74 0a 69 6e 20 69 74 73 20 6f 77 6e 20 72 69 67 t.in its own rig
3320: 68 74 2c 20 62 75 74 20 69 74 20 69 73 20 61 20 ht, but it is a
3330: 63 68 69 6c 64 20 6f 66 20 74 68 65 20 6f 72 69 child of the ori
3340: 67 69 6e 61 6c 2e 20 43 68 61 6e 67 65 73 20 69 ginal. Changes i
3350: 6e 20 74 68 65 0a 63 6f 6e 66 69 67 75 72 61 74 n the.configurat
3360: 69 6f 6e 20 6f 66 20 74 68 65 20 6f 72 69 67 69 ion of the origi
3370: 6e 61 6c 20 61 72 65 20 72 65 66 6c 65 63 74 65 nal are reflecte
3380: 64 20 69 6e 20 74 68 65 0a 63 6c 6f 6e 65 2e 20 d in the.clone.
3390: 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 61 6e Additionally, an
33a0: 79 20 63 61 73 63 61 64 65 73 20 74 68 61 74 20 y cascades that
33b0: 61 72 65 20 70 6f 69 6e 74 65 64 20 74 6f 20 61 are pointed to a
33c0: 72 65 20 61 6c 73 6f 20 63 6c 6f 6e 65 64 0a 73 re also cloned.s
33d0: 6f 20 74 68 61 74 20 6d 65 6e 75 20 74 72 61 76 o that menu trav
33e0: 65 72 73 61 6c 20 77 69 6c 6c 20 77 6f 72 6b 20 ersal will work
33f0: 72 69 67 68 74 2e 20 43 6c 6f 6e 65 73 20 61 72 right. Clones ar
3400: 65 20 64 65 73 74 72 6f 79 65 64 20 77 68 65 6e e destroyed when
3410: 0a 65 69 74 68 65 72 20 74 68 65 20 74 65 61 72 .either the tear
3420: 6f 66 66 20 6f 72 20 6d 65 6e 75 62 61 72 20 67 off or menubar g
3430: 6f 65 73 20 61 77 61 79 2c 20 6f 72 20 77 68 65 oes away, or whe
3440: 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 6d n the original m
3450: 65 6e 75 20 69 73 0a 64 65 73 74 72 6f 79 65 64 enu is.destroyed
3460: 2e 20 0a 2e 56 45 0a 0a 2e 53 48 20 22 57 49 44 . ..VE...SH "WID
3470: 47 45 54 20 43 4f 4d 4d 41 4e 44 22 0a 2e 50 50 GET COMMAND"..PP
3480: 0a 54 68 65 20 5c 66 42 6d 65 6e 75 5c 66 52 20 .The \fBmenu\fR
3490: 63 6f 6d 6d 61 6e 64 20 63 72 65 61 74 65 73 20 command creates
34a0: 61 20 6e 65 77 20 54 63 6c 20 63 6f 6d 6d 61 6e a new Tcl comman
34b0: 64 20 77 68 6f 73 65 0a 6e 61 6d 65 20 69 73 20 d whose.name is
34c0: 5c 66 49 70 61 74 68 4e 61 6d 65 5c 66 52 2e 20 \fIpathName\fR.
34d0: 20 54 68 69 73 0a 63 6f 6d 6d 61 6e 64 20 6d 61 This.command ma
34e0: 79 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e 76 y be used to inv
34f0: 6f 6b 65 20 76 61 72 69 6f 75 73 0a 6f 70 65 72 oke various.oper
3500: 61 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 77 69 ations on the wi
3510: 64 67 65 74 2e 20 20 49 74 20 68 61 73 20 74 68 dget. It has th
3520: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 65 6e 65 e following gene
3530: 72 61 6c 20 66 6f 72 6d 3a 0a 2e 43 53 0a 5c 66 ral form:..CS.\f
3540: 49 70 61 74 68 4e 61 6d 65 20 6f 70 74 69 6f 6e IpathName option
3550: 20 5c 66 52 3f 5c 66 49 61 72 67 20 61 72 67 20 \fR?\fIarg arg
3560: 2e 2e 2e 5c 66 52 3f 0a 2e 43 45 0a 5c 66 49 4f ...\fR?..CE.\fIO
3570: 70 74 69 6f 6e 5c 66 52 20 61 6e 64 20 74 68 65 ption\fR and the
3580: 20 5c 66 49 61 72 67 5c 66 52 73 0a 64 65 74 65 \fIarg\fRs.dete
3590: 72 6d 69 6e 65 20 74 68 65 20 65 78 61 63 74 20 rmine the exact
35a0: 62 65 68 61 76 69 6f 72 20 6f 66 20 74 68 65 20 behavior of the
35b0: 63 6f 6d 6d 61 6e 64 2e 0a 2e 50 50 0a 4d 61 6e command...PP.Man
35c0: 79 20 6f 66 20 74 68 65 20 77 69 64 67 65 74 20 y of the widget
35d0: 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 61 20 6d commands for a m
35e0: 65 6e 75 20 74 61 6b 65 20 61 73 20 6f 6e 65 20 enu take as one
35f0: 61 72 67 75 6d 65 6e 74 20 61 6e 0a 69 6e 64 69 argument an.indi
3600: 63 61 74 6f 72 20 6f 66 20 77 68 69 63 68 20 65 cator of which e
3610: 6e 74 72 79 20 6f 66 20 74 68 65 20 6d 65 6e 75 ntry of the menu
3620: 20 74 6f 20 6f 70 65 72 61 74 65 20 6f 6e 2e 20 to operate on.
3630: 20 54 68 65 73 65 0a 69 6e 64 69 63 61 74 6f 72 These.indicator
3640: 73 20 61 72 65 20 63 61 6c 6c 65 64 20 5c 66 49 s are called \fI
3650: 69 6e 64 65 78 5c 66 52 65 73 20 61 6e 64 20 6d index\fRes and m
3660: 61 79 20 62 65 20 73 70 65 63 69 66 69 65 64 20 ay be specified
3670: 69 6e 0a 61 6e 79 20 6f 66 20 74 68 65 20 66 6f in.any of the fo
3680: 6c 6c 6f 77 69 6e 67 20 66 6f 72 6d 73 3a 0a 2e llowing forms:..
3690: 54 50 20 31 32 0a 5c 66 49 6e 75 6d 62 65 72 5c TP 12.\fInumber\
36a0: 66 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 fR.Specifies the
36b0: 20 65 6e 74 72 79 20 6e 75 6d 65 72 69 63 61 6c entry numerical
36c0: 6c 79 2c 20 77 68 65 72 65 20 30 20 63 6f 72 72 ly, where 0 corr
36d0: 65 73 70 6f 6e 64 73 0a 74 6f 20 74 68 65 20 74 esponds.to the t
36e0: 6f 70 2d 6d 6f 73 74 20 65 6e 74 72 79 20 6f 66 op-most entry of
36f0: 20 74 68 65 20 6d 65 6e 75 2c 20 31 20 74 6f 20 the menu, 1 to
3700: 74 68 65 20 65 6e 74 72 79 20 62 65 6c 6f 77 20 the entry below
3710: 69 74 2c 20 61 6e 64 0a 73 6f 20 6f 6e 2e 0a 2e it, and.so on...
3720: 54 50 20 31 32 0a 5c 66 42 61 63 74 69 76 65 5c TP 12.\fBactive\
3730: 66 52 0a 49 6e 64 69 63 61 74 65 73 20 74 68 65 fR.Indicates the
3740: 20 65 6e 74 72 79 20 74 68 61 74 20 69 73 20 63 entry that is c
3750: 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 2e urrently active.
3760: 20 20 49 66 20 6e 6f 20 65 6e 74 72 79 20 69 73 If no entry is
3770: 0a 61 63 74 69 76 65 20 74 68 65 6e 20 74 68 69 .active then thi
3780: 73 20 66 6f 72 6d 20 69 73 20 65 71 75 69 76 61 s form is equiva
3790: 6c 65 6e 74 20 74 6f 20 5c 66 42 6e 6f 6e 65 5c lent to \fBnone\
37a0: 66 52 2e 20 20 54 68 69 73 20 66 6f 72 6d 20 6d fR. This form m
37b0: 61 79 0a 6e 6f 74 20 62 65 20 61 62 62 72 65 76 ay.not be abbrev
37c0: 69 61 74 65 64 2e 0a 2e 54 50 20 31 32 0a 5c 66 iated...TP 12.\f
37d0: 42 65 6e 64 5c 66 52 0a 49 6e 64 69 63 61 74 65 Bend\fR.Indicate
37e0: 73 20 74 68 65 20 62 6f 74 74 6f 6d 6d 6f 73 74 s the bottommost
37f0: 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 6d 65 entry in the me
3800: 6e 75 2e 20 20 49 66 20 74 68 65 72 65 20 61 72 nu. If there ar
3810: 65 20 6e 6f 0a 65 6e 74 72 69 65 73 20 69 6e 20 e no.entries in
3820: 74 68 65 20 6d 65 6e 75 20 74 68 65 6e 20 74 68 the menu then th
3830: 69 73 20 66 6f 72 6d 20 69 73 20 65 71 75 69 76 is form is equiv
3840: 61 6c 65 6e 74 20 74 6f 20 5c 66 42 6e 6f 6e 65 alent to \fBnone
3850: 5c 66 52 2e 0a 54 68 69 73 20 66 6f 72 6d 20 6d \fR..This form m
3860: 61 79 20 6e 6f 74 20 62 65 20 61 62 62 72 65 76 ay not be abbrev
3870: 69 61 74 65 64 2e 0a 2e 54 50 20 31 32 0a 5c 66 iated...TP 12.\f
3880: 42 6c 61 73 74 5c 66 52 0a 53 61 6d 65 20 61 73 Blast\fR.Same as
3890: 20 5c 66 42 65 6e 64 5c 66 52 2e 0a 2e 54 50 20 \fBend\fR...TP
38a0: 31 32 0a 5c 66 42 6e 6f 6e 65 5c 66 52 0a 49 6e 12.\fBnone\fR.In
38b0: 64 69 63 61 74 65 73 20 60 60 6e 6f 20 65 6e 74 dicates ``no ent
38c0: 72 79 20 61 74 20 61 6c 6c 27 27 3b 20 20 74 68 ry at all''; th
38d0: 69 73 20 69 73 20 75 73 65 64 20 6d 6f 73 74 20 is is used most
38e0: 63 6f 6d 6d 6f 6e 6c 79 20 77 69 74 68 0a 74 68 commonly with.th
38f0: 65 20 5c 66 42 61 63 74 69 76 61 74 65 5c 66 52 e \fBactivate\fR
3900: 20 6f 70 74 69 6f 6e 20 74 6f 20 64 65 61 63 74 option to deact
3910: 69 76 61 74 65 20 61 6c 6c 20 74 68 65 20 65 6e ivate all the en
3920: 74 72 69 65 73 20 69 6e 20 74 68 65 0a 6d 65 6e tries in the.men
3930: 75 2e 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 u. In most case
3940: 73 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74 s the specificat
3950: 69 6f 6e 20 6f 66 20 5c 66 42 6e 6f 6e 65 5c 66 ion of \fBnone\f
3960: 52 20 63 61 75 73 65 73 0a 6e 6f 74 68 69 6e 67 R causes.nothing
3970: 20 74 6f 20 68 61 70 70 65 6e 20 69 6e 20 74 68 to happen in th
3980: 65 20 77 69 64 67 65 74 20 63 6f 6d 6d 61 6e 64 e widget command
3990: 2e 0a 54 68 69 73 20 66 6f 72 6d 20 6d 61 79 20 ..This form may
39a0: 6e 6f 74 20 62 65 20 61 62 62 72 65 76 69 61 74 not be abbreviat
39b0: 65 64 2e 0a 2e 54 50 20 31 32 0a 5c 66 42 40 5c ed...TP 12.\fB@\
39c0: 66 49 6e 75 6d 62 65 72 5c 66 52 0a 49 6e 20 74 fInumber\fR.In t
39d0: 68 69 73 20 66 6f 72 6d 2c 20 5c 66 49 6e 75 6d his form, \fInum
39e0: 62 65 72 5c 66 52 20 69 73 20 74 72 65 61 74 65 ber\fR is treate
39f0: 64 20 61 73 20 61 20 79 2d 63 6f 6f 72 64 69 6e d as a y-coordin
3a00: 61 74 65 20 69 6e 20 74 68 65 0a 6d 65 6e 75 27 ate in the.menu'
3a10: 73 20 77 69 6e 64 6f 77 3b 20 20 74 68 65 20 65 s window; the e
3a20: 6e 74 72 79 20 63 6c 6f 73 65 73 74 20 74 6f 20 ntry closest to
3a30: 74 68 61 74 20 79 2d 63 6f 6f 72 64 69 6e 61 74 that y-coordinat
3a40: 65 20 69 73 20 75 73 65 64 2e 0a 46 6f 72 20 65 e is used..For e
3a50: 78 61 6d 70 6c 65 2c 20 60 60 5c 66 42 40 30 5c xample, ``\fB@0\
3a60: 66 52 27 27 20 69 6e 64 69 63 61 74 65 73 20 74 fR'' indicates t
3a70: 68 65 20 74 6f 70 2d 6d 6f 73 74 20 65 6e 74 72 he top-most entr
3a80: 79 20 69 6e 20 74 68 65 0a 77 69 6e 64 6f 77 2e y in the.window.
3a90: 0a 2e 54 50 20 31 32 0a 5c 66 49 70 61 74 74 65 ..TP 12.\fIpatte
3aa0: 72 6e 5c 66 52 0a 49 66 20 74 68 65 20 69 6e 64 rn\fR.If the ind
3ab0: 65 78 20 64 6f 65 73 6e 27 74 20 73 61 74 69 73 ex doesn't satis
3ac0: 66 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 61 62 fy one of the ab
3ad0: 6f 76 65 20 66 6f 72 6d 73 20 74 68 65 6e 20 74 ove forms then t
3ae0: 68 69 73 0a 66 6f 72 6d 20 69 73 20 75 73 65 64 his.form is used
3af0: 2e 20 20 5c 66 49 50 61 74 74 65 72 6e 5c 66 52 . \fIPattern\fR
3b00: 20 69 73 20 70 61 74 74 65 72 6e 2d 6d 61 74 63 is pattern-matc
3b10: 68 65 64 20 61 67 61 69 6e 73 74 20 74 68 65 20 hed against the
3b20: 6c 61 62 65 6c 20 6f 66 0a 65 61 63 68 20 65 6e label of.each en
3b30: 74 72 79 20 69 6e 20 74 68 65 20 6d 65 6e 75 2c try in the menu,
3b40: 20 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d 20 74 in order from t
3b50: 68 65 20 74 6f 70 20 64 6f 77 6e 2c 20 75 6e 74 he top down, unt
3b60: 69 6c 20 61 0a 6d 61 74 63 68 69 6e 67 20 65 6e il a.matching en
3b70: 74 72 79 20 69 73 20 66 6f 75 6e 64 2e 20 20 54 try is found. T
3b80: 68 65 20 72 75 6c 65 73 20 6f 66 20 5c 66 42 54 he rules of \fBT
3b90: 63 6c 5f 53 74 72 69 6e 67 4d 61 74 63 68 5c 66 cl_StringMatch\f
3ba0: 52 0a 61 72 65 20 75 73 65 64 2e 0a 2e 50 50 0a R.are used...PP.
3bb0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 77 69 The following wi
3bc0: 64 67 65 74 20 63 6f 6d 6d 61 6e 64 73 20 61 72 dget commands ar
3bd0: 65 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 6d e possible for m
3be0: 65 6e 75 20 77 69 64 67 65 74 73 3a 0a 2e 54 50 enu widgets:..TP
3bf0: 0a 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 .\fIpathName \fB
3c00: 61 63 74 69 76 61 74 65 20 5c 66 49 69 6e 64 65 activate \fIinde
3c10: 78 5c 66 52 0a 43 68 61 6e 67 65 20 74 68 65 20 x\fR.Change the
3c20: 73 74 61 74 65 20 6f 66 20 74 68 65 20 65 6e 74 state of the ent
3c30: 72 79 20 69 6e 64 69 63 61 74 65 64 20 62 79 20 ry indicated by
3c40: 5c 66 49 69 6e 64 65 78 5c 66 52 20 74 6f 20 5c \fIindex\fR to \
3c50: 66 42 61 63 74 69 76 65 5c 66 52 0a 61 6e 64 20 fBactive\fR.and
3c60: 72 65 64 69 73 70 6c 61 79 20 69 74 20 75 73 69 redisplay it usi
3c70: 6e 67 20 69 74 73 20 61 63 74 69 76 65 20 63 6f ng its active co
3c80: 6c 6f 72 73 2e 0a 41 6e 79 20 70 72 65 76 69 6f lors..Any previo
3c90: 75 73 6c 79 2d 61 63 74 69 76 65 20 65 6e 74 72 usly-active entr
3ca0: 79 20 69 73 20 64 65 61 63 74 69 76 61 74 65 64 y is deactivated
3cb0: 2e 20 20 49 66 20 5c 66 49 69 6e 64 65 78 5c 66 . If \fIindex\f
3cc0: 52 0a 69 73 20 73 70 65 63 69 66 69 65 64 20 61 R.is specified a
3cd0: 73 20 5c 66 42 6e 6f 6e 65 5c 66 52 2c 20 6f 72 s \fBnone\fR, or
3ce0: 20 69 66 20 74 68 65 20 73 70 65 63 69 66 69 65 if the specifie
3cf0: 64 20 65 6e 74 72 79 20 69 73 0a 64 69 73 61 62 d entry is.disab
3d00: 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 6d 65 led, then the me
3d10: 6e 75 20 65 6e 64 73 20 75 70 20 77 69 74 68 20 nu ends up with
3d20: 6e 6f 20 61 63 74 69 76 65 20 65 6e 74 72 79 2e no active entry.
3d30: 0a 52 65 74 75 72 6e 73 20 61 6e 20 65 6d 70 74 .Returns an empt
3d40: 79 20 73 74 72 69 6e 67 2e 0a 2e 54 50 0a 5c 66 y string...TP.\f
3d50: 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 61 64 64 IpathName \fBadd
3d60: 20 5c 66 49 74 79 70 65 20 5c 66 52 3f 5c 66 49 \fItype \fR?\fI
3d70: 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 6f 70 74 option value opt
3d80: 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 5c 66 52 ion value ...\fR
3d90: 3f 0a 41 64 64 20 61 20 6e 65 77 20 65 6e 74 72 ?.Add a new entr
3da0: 79 20 74 6f 20 74 68 65 20 62 6f 74 74 6f 6d 20 y to the bottom
3db0: 6f 66 20 74 68 65 20 6d 65 6e 75 2e 20 20 54 68 of the menu. Th
3dc0: 65 20 6e 65 77 20 65 6e 74 72 79 27 73 20 74 79 e new entry's ty
3dd0: 70 65 0a 69 73 20 67 69 76 65 6e 20 62 79 20 5c pe.is given by \
3de0: 66 49 74 79 70 65 5c 66 52 20 61 6e 64 20 6d 75 fItype\fR and mu
3df0: 73 74 20 62 65 20 6f 6e 65 20 6f 66 20 5c 66 42 st be one of \fB
3e00: 63 61 73 63 61 64 65 5c 66 52 2c 0a 5c 66 42 63 cascade\fR,.\fBc
3e10: 68 65 63 6b 62 75 74 74 6f 6e 5c 66 52 2c 20 5c heckbutton\fR, \
3e20: 66 42 63 6f 6d 6d 61 6e 64 5c 66 52 2c 20 5c 66 fBcommand\fR, \f
3e30: 42 72 61 64 69 6f 62 75 74 74 6f 6e 5c 66 52 2c Bradiobutton\fR,
3e40: 20 6f 72 20 5c 66 42 73 65 70 61 72 61 74 6f 72 or \fBseparator
3e50: 5c 66 52 2c 0a 6f 72 20 61 20 75 6e 69 71 75 65 \fR,.or a unique
3e60: 20 61 62 62 72 65 76 69 61 74 69 6f 6e 20 6f 66 abbreviation of
3e70: 20 6f 6e 65 20 6f 66 20 74 68 65 20 61 62 6f 76 one of the abov
3e80: 65 2e 20 20 49 66 20 61 64 64 69 74 69 6f 6e 61 e. If additiona
3e90: 6c 20 61 72 67 75 6d 65 6e 74 73 0a 61 72 65 20 l arguments.are
3ea0: 70 72 65 73 65 6e 74 2c 20 74 68 65 79 20 73 70 present, they sp
3eb0: 65 63 69 66 79 20 61 6e 79 20 6f 66 20 74 68 65 ecify any of the
3ec0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6f following optio
3ed0: 6e 73 3a 0a 2e 52 53 0a 2e 54 50 0a 5c 66 42 5c ns:..RS..TP.\fB\
3ee0: 2d 61 63 74 69 76 65 62 61 63 6b 67 72 6f 75 6e -activebackgroun
3ef0: 64 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a 53 70 d \fIvalue\fR.Sp
3f00: 65 63 69 66 69 65 73 20 61 20 62 61 63 6b 67 72 ecifies a backgr
3f10: 6f 75 6e 64 20 63 6f 6c 6f 72 20 74 6f 20 75 73 ound color to us
3f20: 65 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 e for displaying
3f30: 20 74 68 69 73 20 65 6e 74 72 79 20 77 68 65 6e this entry when
3f40: 20 69 74 0a 69 73 20 61 63 74 69 76 65 2e 0a 49 it.is active..I
3f50: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 f this option is
3f60: 20 73 70 65 63 69 66 69 65 64 20 61 73 20 61 6e specified as an
3f70: 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 28 74 empty string (t
3f80: 68 65 20 64 65 66 61 75 6c 74 29 2c 20 74 68 65 he default), the
3f90: 6e 20 74 68 65 0a 5c 66 42 61 63 74 69 76 65 42 n the.\fBactiveB
3fa0: 61 63 6b 67 72 6f 75 6e 64 5c 66 52 20 6f 70 74 ackground\fR opt
3fb0: 69 6f 6e 20 66 6f 72 20 74 68 65 20 6f 76 65 72 ion for the over
3fc0: 61 6c 6c 20 6d 65 6e 75 20 69 73 20 75 73 65 64 all menu is used
3fd0: 2e 0a 49 66 20 74 68 65 20 5c 66 42 74 6b 5f 73 ..If the \fBtk_s
3fe0: 74 72 69 63 74 4d 6f 74 69 66 5c 66 52 20 76 61 trictMotif\fR va
3ff0: 72 69 61 62 6c 65 20 68 61 73 20 62 65 65 6e 20 riable has been
4000: 73 65 74 20 74 6f 20 72 65 71 75 65 73 74 20 73 set to request s
4010: 74 72 69 63 74 0a 4d 6f 74 69 66 20 63 6f 6d 70 trict.Motif comp
4020: 6c 69 61 6e 63 65 2c 20 74 68 65 6e 20 74 68 69 liance, then thi
4030: 73 20 6f 70 74 69 6f 6e 20 69 73 20 69 67 6e 6f s option is igno
4040: 72 65 64 20 61 6e 64 20 74 68 65 20 5c 66 42 5c red and the \fB\
4050: 2d 62 61 63 6b 67 72 6f 75 6e 64 5c 66 52 0a 6f -background\fR.o
4060: 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e ption is used in
4070: 20 69 74 73 20 70 6c 61 63 65 2e 0a 54 68 69 73 its place..This
4080: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 74 20 61 option is not a
4090: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73 65 70 vailable for sep
40a0: 61 72 61 74 6f 72 20 6f 72 20 74 65 61 72 2d 6f arator or tear-o
40b0: 66 66 20 65 6e 74 72 69 65 73 2e 0a 2e 54 50 0a ff entries...TP.
40c0: 5c 66 42 5c 2d 61 63 74 69 76 65 66 6f 72 65 67 \fB\-activeforeg
40d0: 72 6f 75 6e 64 20 5c 66 49 76 61 6c 75 65 5c 66 round \fIvalue\f
40e0: 52 0a 53 70 65 63 69 66 69 65 73 20 61 20 66 6f R.Specifies a fo
40f0: 72 65 67 72 6f 75 6e 64 20 63 6f 6c 6f 72 20 74 reground color t
4100: 6f 20 75 73 65 20 66 6f 72 20 64 69 73 70 6c 61 o use for displa
4110: 79 69 6e 67 20 74 68 69 73 20 65 6e 74 72 79 20 ying this entry
4120: 77 68 65 6e 20 69 74 0a 69 73 20 61 63 74 69 76 when it.is activ
4130: 65 2e 0a 49 66 20 74 68 69 73 20 6f 70 74 69 6f e..If this optio
4140: 6e 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 n is specified a
4150: 73 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 6e s an empty strin
4160: 67 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c g (the default),
4170: 20 74 68 65 6e 20 74 68 65 0a 5c 66 42 61 63 74 then the.\fBact
4180: 69 76 65 46 6f 72 65 67 72 6f 75 6e 64 5c 66 52 iveForeground\fR
4190: 20 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 option for the
41a0: 6f 76 65 72 61 6c 6c 20 6d 65 6e 75 20 69 73 20 overall menu is
41b0: 75 73 65 64 2e 0a 54 68 69 73 20 6f 70 74 69 6f used..This optio
41c0: 6e 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 n is not availab
41d0: 6c 65 20 66 6f 72 20 73 65 70 61 72 61 74 6f 72 le for separator
41e0: 20 6f 72 20 74 65 61 72 2d 6f 66 66 20 65 6e 74 or tear-off ent
41f0: 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 61 ries...TP.\fB\-a
4200: 63 63 65 6c 65 72 61 74 6f 72 20 5c 66 49 76 61 ccelerator \fIva
4210: 6c 75 65 5c 66 52 0a 53 70 65 63 69 66 69 65 73 lue\fR.Specifies
4220: 20 61 20 73 74 72 69 6e 67 20 74 6f 20 64 69 73 a string to dis
4230: 70 6c 61 79 20 61 74 20 74 68 65 20 72 69 67 68 play at the righ
4240: 74 20 73 69 64 65 20 6f 66 20 74 68 65 20 6d 65 t side of the me
4250: 6e 75 20 65 6e 74 72 79 2e 0a 4e 6f 72 6d 61 6c nu entry..Normal
4260: 6c 79 20 64 65 73 63 72 69 62 65 73 20 61 6e 20 ly describes an
4270: 61 63 63 65 6c 65 72 61 74 6f 72 20 6b 65 79 73 accelerator keys
4280: 74 72 6f 6b 65 20 73 65 71 75 65 6e 63 65 20 74 troke sequence t
4290: 68 61 74 20 6d 61 79 20 62 65 0a 74 79 70 65 64 hat may be.typed
42a0: 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 73 to invoke the s
42b0: 61 6d 65 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 ame function as
42c0: 74 68 65 20 6d 65 6e 75 20 65 6e 74 72 79 2e 20 the menu entry.
42d0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 0a 69 73 20 This option.is
42e0: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 66 6f not available fo
42f0: 72 20 73 65 70 61 72 61 74 6f 72 20 6f 72 20 74 r separator or t
4300: 65 61 72 2d 6f 66 66 20 65 6e 74 72 69 65 73 2e ear-off entries.
4310: 0a 2e 54 50 0a 5c 66 42 5c 2d 62 61 63 6b 67 72 ..TP.\fB\-backgr
4320: 6f 75 6e 64 20 5c 66 49 76 61 6c 75 65 5c 66 52 ound \fIvalue\fR
4330: 0a 53 70 65 63 69 66 69 65 73 20 61 20 62 61 63 .Specifies a bac
4340: 6b 67 72 6f 75 6e 64 20 63 6f 6c 6f 72 20 74 6f kground color to
4350: 20 75 73 65 20 66 6f 72 20 64 69 73 70 6c 61 79 use for display
4360: 69 6e 67 20 74 68 69 73 20 65 6e 74 72 79 20 77 ing this entry w
4370: 68 65 6e 20 69 74 0a 69 73 20 69 6e 20 74 68 65 hen it.is in the
4380: 20 6e 6f 72 6d 61 6c 20 73 74 61 74 65 20 28 6e normal state (n
4390: 65 69 74 68 65 72 20 61 63 74 69 76 65 20 6e 6f either active no
43a0: 72 20 64 69 73 61 62 6c 65 64 29 2e 0a 49 66 20 r disabled)..If
43b0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 73 this option is s
43c0: 70 65 63 69 66 69 65 64 20 61 73 20 61 6e 20 65 pecified as an e
43d0: 6d 70 74 79 20 73 74 72 69 6e 67 20 28 74 68 65 mpty string (the
43e0: 20 64 65 66 61 75 6c 74 29 2c 20 74 68 65 6e 20 default), then
43f0: 74 68 65 0a 5c 66 42 62 61 63 6b 67 72 6f 75 6e the.\fBbackgroun
4400: 64 5c 66 52 20 6f 70 74 69 6f 6e 20 66 6f 72 20 d\fR option for
4410: 74 68 65 20 6f 76 65 72 61 6c 6c 20 6d 65 6e 75 the overall menu
4420: 20 69 73 20 75 73 65 64 2e 0a 54 68 69 73 20 6f is used..This o
4430: 70 74 69 6f 6e 20 69 73 20 6e 6f 74 20 61 76 61 ption is not ava
4440: 69 6c 61 62 6c 65 20 66 6f 72 20 73 65 70 61 72 ilable for separ
4450: 61 74 6f 72 20 6f 72 20 74 65 61 72 2d 6f 66 66 ator or tear-off
4460: 20 65 6e 74 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 entries...TP.\f
4470: 42 5c 2d 62 69 74 6d 61 70 20 5c 66 49 76 61 6c B\-bitmap \fIval
4480: 75 65 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 ue\fR.Specifies
4490: 61 20 62 69 74 6d 61 70 20 74 6f 20 64 69 73 70 a bitmap to disp
44a0: 6c 61 79 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 lay in the menu
44b0: 69 6e 73 74 65 61 64 20 6f 66 20 61 20 74 65 78 instead of a tex
44c0: 74 75 61 6c 0a 6c 61 62 65 6c 2c 20 69 6e 20 61 tual.label, in a
44d0: 6e 79 20 6f 66 20 74 68 65 20 66 6f 72 6d 73 20 ny of the forms
44e0: 61 63 63 65 70 74 65 64 20 62 79 20 5c 66 42 54 accepted by \fBT
44f0: 6b 5f 47 65 74 42 69 74 6d 61 70 5c 66 52 2e 0a k_GetBitmap\fR..
4500: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 76 65 72 This option over
4510: 72 69 64 65 73 20 74 68 65 20 5c 66 42 5c 2d 6c rides the \fB\-l
4520: 61 62 65 6c 5c 66 52 20 6f 70 74 69 6f 6e 0a 28 abel\fR option.(
4530: 61 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 as controlled by
4540: 20 74 68 65 20 5c 66 42 5c 2d 63 6f 6d 70 6f 75 the \fB\-compou
4550: 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 29 0a 62 75 nd\fR option).bu
4560: 74 20 6d 61 79 20 62 65 20 72 65 73 65 74 0a 74 t may be reset.t
4570: 6f 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 6e o an empty strin
4580: 67 20 74 6f 20 65 6e 61 62 6c 65 20 61 20 74 65 g to enable a te
4590: 78 74 75 61 6c 20 6c 61 62 65 6c 20 74 6f 20 62 xtual label to b
45a0: 65 20 64 69 73 70 6c 61 79 65 64 2e 0a 49 66 20 e displayed..If
45b0: 61 20 5c 66 42 5c 2d 69 6d 61 67 65 5c 66 52 20 a \fB\-image\fR
45c0: 6f 70 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 option has been
45d0: 73 70 65 63 69 66 69 65 64 2c 20 69 74 20 6f 76 specified, it ov
45e0: 65 72 72 69 64 65 73 0a 5c 66 42 5c 2d 62 69 74 errides.\fB\-bit
45f0: 6d 61 70 5c 66 52 2e 0a 54 68 69 73 20 6f 70 74 map\fR..This opt
4600: 69 6f 6e 20 69 73 20 6e 6f 74 20 61 76 61 69 6c ion is not avail
4610: 61 62 6c 65 20 66 6f 72 20 73 65 70 61 72 61 74 able for separat
4620: 6f 72 20 6f 72 20 74 65 61 72 2d 6f 66 66 20 65 or or tear-off e
4630: 6e 74 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c ntries...TP.\fB\
4640: 2d 63 6f 6c 75 6d 6e 62 72 65 61 6b 20 5c 66 49 -columnbreak \fI
4650: 76 61 6c 75 65 5c 66 52 0a 2e 56 53 20 38 2e 30 value\fR..VS 8.0
4660: 0a 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f .When this optio
4670: 6e 20 69 73 20 7a 65 72 6f 2c 20 74 68 65 20 65 n is zero, the e
4680: 6e 74 72 79 20 61 70 70 65 61 72 73 20 62 65 6c ntry appears bel
4690: 6f 77 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 ow the previous
46a0: 65 6e 74 72 79 2e 20 57 68 65 6e 0a 74 68 69 73 entry. When.this
46b0: 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6e 65 2c 20 option is one,
46c0: 74 68 65 20 65 6e 74 72 79 20 61 70 70 65 61 72 the entry appear
46d0: 73 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 s at the top of
46e0: 61 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 69 6e 20 a new column in
46f0: 74 68 65 0a 6d 65 6e 75 2e 0a 2e 56 45 20 38 2e the.menu...VE 8.
4700: 30 0a 2e 54 50 0a 5c 66 42 5c 2d 63 6f 6d 6d 61 0..TP.\fB\-comma
4710: 6e 64 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a 53 nd \fIvalue\fR.S
4720: 70 65 63 69 66 69 65 73 20 61 20 54 63 6c 20 63 pecifies a Tcl c
4730: 6f 6d 6d 61 6e 64 20 74 6f 20 65 78 65 63 75 74 ommand to execut
4740: 65 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 e when the menu
4750: 65 6e 74 72 79 20 69 73 20 69 6e 76 6f 6b 65 64 entry is invoked
4760: 2e 0a 4e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 ..Not available
4770: 66 6f 72 20 73 65 70 61 72 61 74 6f 72 20 6f 72 for separator or
4780: 20 74 65 61 72 2d 6f 66 66 20 65 6e 74 72 69 65 tear-off entrie
4790: 73 2e 0a 2e 56 53 20 38 2e 34 0a 2e 54 50 0a 5c s...VS 8.4..TP.\
47a0: 66 42 5c 2d 63 6f 6d 70 6f 75 6e 64 20 5c 66 49 fB\-compound \fI
47b0: 76 61 6c 75 65 5c 66 52 0a 53 70 65 63 69 66 69 value\fR.Specifi
47c0: 65 73 20 77 68 65 74 68 65 72 20 74 68 65 20 6d es whether the m
47d0: 65 6e 75 20 65 6e 74 72 79 20 73 68 6f 75 6c 64 enu entry should
47e0: 20 64 69 73 70 6c 61 79 20 62 6f 74 68 20 61 6e display both an
47f0: 20 69 6d 61 67 65 20 61 6e 64 20 74 65 78 74 2c image and text,
4800: 0a 61 6e 64 20 69 66 20 73 6f 2c 20 77 68 65 72 .and if so, wher
4810: 65 20 74 68 65 20 69 6d 61 67 65 20 73 68 6f 75 e the image shou
4820: 6c 64 20 62 65 20 70 6c 61 63 65 64 20 72 65 6c ld be placed rel
4830: 61 74 69 76 65 20 74 6f 20 74 68 65 20 74 65 78 ative to the tex
4840: 74 2e 0a 56 61 6c 69 64 20 76 61 6c 75 65 73 20 t..Valid values
4850: 66 6f 72 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 for this option
4860: 61 72 65 20 5c 66 42 62 6f 74 74 6f 6d 5c 66 52 are \fBbottom\fR
4870: 2c 20 5c 66 42 63 65 6e 74 65 72 5c 66 52 2c 0a , \fBcenter\fR,.
4880: 5c 66 42 6c 65 66 74 5c 66 52 2c 20 5c 66 42 6e \fBleft\fR, \fBn
4890: 6f 6e 65 5c 66 52 2c 20 5c 66 42 72 69 67 68 74 one\fR, \fBright
48a0: 5c 66 52 20 61 6e 64 20 5c 66 42 74 6f 70 5c 66 \fR and \fBtop\f
48b0: 52 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 R. The default
48c0: 76 61 6c 75 65 0a 69 73 20 5c 66 42 6e 6f 6e 65 value.is \fBnone
48d0: 5c 66 52 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 \fR, meaning tha
48e0: 74 20 74 68 65 20 62 75 74 74 6f 6e 20 77 69 6c t the button wil
48f0: 6c 20 64 69 73 70 6c 61 79 20 65 69 74 68 65 72 l display either
4900: 20 61 6e 20 69 6d 61 67 65 20 6f 72 0a 74 65 78 an image or.tex
4910: 74 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 t, depending on
4920: 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 74 68 the values of th
4930: 65 20 5c 66 42 5c 2d 69 6d 61 67 65 5c 66 52 20 e \fB\-image\fR
4940: 61 6e 64 20 5c 66 42 5c 2d 62 69 74 6d 61 70 5c and \fB\-bitmap\
4950: 66 52 0a 6f 70 74 69 6f 6e 73 2e 0a 2e 56 45 0a fR.options...VE.
4960: 2e 54 50 0a 5c 66 42 5c 2d 66 6f 6e 74 20 5c 66 .TP.\fB\-font \f
4970: 49 76 61 6c 75 65 5c 66 52 0a 53 70 65 63 69 66 Ivalue\fR.Specif
4980: 69 65 73 20 74 68 65 20 66 6f 6e 74 20 74 6f 20 ies the font to
4990: 75 73 65 20 77 68 65 6e 20 64 72 61 77 69 6e 67 use when drawing
49a0: 20 74 68 65 20 6c 61 62 65 6c 20 6f 72 20 61 63 the label or ac
49b0: 63 65 6c 65 72 61 74 6f 72 0a 73 74 72 69 6e 67 celerator.string
49c0: 20 69 6e 20 74 68 69 73 20 65 6e 74 72 79 2e 0a in this entry..
49d0: 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 If this option i
49e0: 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 61 s specified as a
49f0: 6e 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 28 n empty string (
4a00: 74 68 65 20 64 65 66 61 75 6c 74 29 20 74 68 65 the default) the
4a10: 6e 0a 74 68 65 20 5c 66 42 66 6f 6e 74 5c 66 52 n.the \fBfont\fR
4a20: 20 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 option for the
4a30: 6f 76 65 72 61 6c 6c 20 6d 65 6e 75 20 69 73 20 overall menu is
4a40: 75 73 65 64 2e 0a 54 68 69 73 20 6f 70 74 69 6f used..This optio
4a50: 6e 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 n is not availab
4a60: 6c 65 20 66 6f 72 20 73 65 70 61 72 61 74 6f 72 le for separator
4a70: 20 6f 72 20 74 65 61 72 2d 6f 66 66 20 65 6e 74 or tear-off ent
4a80: 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 66 ries...TP.\fB\-f
4a90: 6f 72 65 67 72 6f 75 6e 64 20 5c 66 49 76 61 6c oreground \fIval
4aa0: 75 65 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 ue\fR.Specifies
4ab0: 61 20 66 6f 72 65 67 72 6f 75 6e 64 20 63 6f 6c a foreground col
4ac0: 6f 72 20 74 6f 20 75 73 65 20 66 6f 72 20 64 69 or to use for di
4ad0: 73 70 6c 61 79 69 6e 67 20 74 68 69 73 20 65 6e splaying this en
4ae0: 74 72 79 20 77 68 65 6e 20 69 74 0a 69 73 20 69 try when it.is i
4af0: 6e 20 74 68 65 20 6e 6f 72 6d 61 6c 20 73 74 61 n the normal sta
4b00: 74 65 20 28 6e 65 69 74 68 65 72 20 61 63 74 69 te (neither acti
4b10: 76 65 20 6e 6f 72 20 64 69 73 61 62 6c 65 64 29 ve nor disabled)
4b20: 2e 0a 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e ..If this option
4b30: 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 is specified as
4b40: 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 6e 67 an empty string
4b50: 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 (the default),
4b60: 74 68 65 6e 20 74 68 65 0a 5c 66 42 66 6f 72 65 then the.\fBfore
4b70: 67 72 6f 75 6e 64 5c 66 52 20 6f 70 74 69 6f 6e ground\fR option
4b80: 20 66 6f 72 20 74 68 65 20 6f 76 65 72 61 6c 6c for the overall
4b90: 20 6d 65 6e 75 20 69 73 20 75 73 65 64 2e 0a 54 menu is used..T
4ba0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f his option is no
4bb0: 74 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 t available for
4bc0: 73 65 70 61 72 61 74 6f 72 20 6f 72 20 74 65 61 separator or tea
4bd0: 72 2d 6f 66 66 20 65 6e 74 72 69 65 73 2e 0a 2e r-off entries...
4be0: 56 53 0a 2e 54 50 0a 5c 66 42 5c 2d 68 69 64 65 VS..TP.\fB\-hide
4bf0: 6d 61 72 67 69 6e 20 5c 66 49 76 61 6c 75 65 5c margin \fIvalue\
4c00: 66 52 0a 53 70 65 63 69 66 69 65 73 20 77 68 65 fR.Specifies whe
4c10: 74 68 65 72 20 74 68 65 20 73 74 61 6e 64 61 72 ther the standar
4c20: 64 20 6d 61 72 67 69 6e 73 20 73 68 6f 75 6c 64 d margins should
4c30: 20 62 65 20 64 72 61 77 6e 20 66 6f 72 20 74 68 be drawn for th
4c40: 69 73 20 6d 65 6e 75 0a 65 6e 74 72 79 2e 20 54 is menu.entry. T
4c50: 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 his is useful wh
4c60: 65 6e 20 63 72 65 61 74 69 6e 67 20 70 61 6c 65 en creating pale
4c70: 74 74 65 20 77 69 74 68 20 69 6d 61 67 65 73 20 tte with images
4c80: 69 6e 20 74 68 65 6d 2c 20 69 2e 65 2e 2c 0a 63 in them, i.e.,.c
4c90: 6f 6c 6f 72 20 70 61 6c 65 74 74 65 73 2c 20 70 olor palettes, p
4ca0: 61 74 74 65 72 6e 20 70 61 6c 65 74 74 65 73 2c attern palettes,
4cb0: 20 65 74 63 2e 20 31 20 69 6e 64 69 63 61 74 65 etc. 1 indicate
4cc0: 73 20 74 68 61 74 20 74 68 65 20 6d 61 72 67 69 s that the margi
4cd0: 6e 20 66 6f 72 0a 74 68 65 20 65 6e 74 72 79 20 n for.the entry
4ce0: 69 73 20 68 69 64 64 65 6e 3b 20 30 20 6d 65 61 is hidden; 0 mea
4cf0: 6e 73 20 74 68 61 74 20 74 68 65 20 6d 61 72 67 ns that the marg
4d00: 69 6e 20 69 73 20 75 73 65 64 2e 0a 2e 56 45 0a in is used...VE.
4d10: 2e 54 50 0a 5c 66 42 5c 2d 69 6d 61 67 65 20 5c .TP.\fB\-image \
4d20: 66 49 76 61 6c 75 65 5c 66 52 0a 53 70 65 63 69 fIvalue\fR.Speci
4d30: 66 69 65 73 20 61 6e 20 69 6d 61 67 65 20 74 6f fies an image to
4d40: 20 64 69 73 70 6c 61 79 20 69 6e 20 74 68 65 20 display in the
4d50: 6d 65 6e 75 20 69 6e 73 74 65 61 64 20 6f 66 20 menu instead of
4d60: 61 20 74 65 78 74 20 73 74 72 69 6e 67 0a 6f 72 a text string.or
4d70: 20 62 69 74 6d 61 70 2e 0a 54 68 65 20 69 6d 61 bitmap..The ima
4d80: 67 65 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 ge must have bee
4d90: 6e 20 63 72 65 61 74 65 64 20 62 79 20 73 6f 6d n created by som
4da0: 65 20 70 72 65 76 69 6f 75 73 20 69 6e 76 6f 63 e previous invoc
4db0: 61 74 69 6f 6e 20 6f 66 0a 5c 66 42 69 6d 61 67 ation of.\fBimag
4dc0: 65 20 63 72 65 61 74 65 5c 66 52 2e 0a 54 68 69 e create\fR..Thi
4dd0: 73 20 6f 70 74 69 6f 6e 20 6f 76 65 72 72 69 64 s option overrid
4de0: 65 73 20 74 68 65 20 5c 66 42 5c 2d 6c 61 62 65 es the \fB\-labe
4df0: 6c 5c 66 52 20 61 6e 64 20 5c 66 42 5c 2d 62 69 l\fR and \fB\-bi
4e00: 74 6d 61 70 5c 66 52 20 6f 70 74 69 6f 6e 73 0a tmap\fR options.
4e10: 28 61 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 (as controlled b
4e20: 79 20 74 68 65 20 5c 66 42 5c 2d 63 6f 6d 70 6f y the \fB\-compo
4e30: 75 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 29 0a 62 und\fR option).b
4e40: 75 74 20 6d 61 79 20 62 65 20 72 65 73 65 74 20 ut may be reset
4e50: 74 6f 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 to an empty stri
4e60: 6e 67 20 74 6f 20 65 6e 61 62 6c 65 20 61 20 74 ng to enable a t
4e70: 65 78 74 75 61 6c 20 6f 72 0a 62 69 74 6d 61 70 extual or.bitmap
4e80: 20 6c 61 62 65 6c 20 74 6f 20 62 65 20 64 69 73 label to be dis
4e90: 70 6c 61 79 65 64 2e 0a 54 68 69 73 20 6f 70 74 played..This opt
4ea0: 69 6f 6e 20 69 73 20 6e 6f 74 20 61 76 61 69 6c ion is not avail
4eb0: 61 62 6c 65 20 66 6f 72 20 73 65 70 61 72 61 74 able for separat
4ec0: 6f 72 20 6f 72 20 74 65 61 72 2d 6f 66 66 20 65 or or tear-off e
4ed0: 6e 74 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c ntries...TP.\fB\
4ee0: 2d 69 6e 64 69 63 61 74 6f 72 6f 6e 20 5c 66 49 -indicatoron \fI
4ef0: 76 61 6c 75 65 5c 66 52 0a 41 76 61 69 6c 61 62 value\fR.Availab
4f00: 6c 65 20 6f 6e 6c 79 20 66 6f 72 20 63 68 65 63 le only for chec
4f10: 6b 62 75 74 74 6f 6e 20 61 6e 64 20 72 61 64 69 kbutton and radi
4f20: 6f 62 75 74 74 6f 6e 20 65 6e 74 72 69 65 73 2e obutton entries.
4f30: 0a 5c 66 49 56 61 6c 75 65 5c 66 52 20 69 73 20 .\fIValue\fR is
4f40: 61 20 62 6f 6f 6c 65 61 6e 20 74 68 61 74 20 64 a boolean that d
4f50: 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 etermines whethe
4f60: 72 20 6f 72 20 6e 6f 74 20 74 68 65 0a 69 6e 64 r or not the.ind
4f70: 69 63 61 74 6f 72 20 73 68 6f 75 6c 64 20 62 65 icator should be
4f80: 20 64 69 73 70 6c 61 79 65 64 2e 0a 2e 54 50 0a displayed...TP.
4f90: 5c 66 42 5c 2d 6c 61 62 65 6c 20 5c 66 49 76 61 \fB\-label \fIva
4fa0: 6c 75 65 5c 66 52 0a 53 70 65 63 69 66 69 65 73 lue\fR.Specifies
4fb0: 20 61 20 73 74 72 69 6e 67 20 74 6f 20 64 69 73 a string to dis
4fc0: 70 6c 61 79 20 61 73 20 61 6e 20 69 64 65 6e 74 play as an ident
4fd0: 69 66 79 69 6e 67 20 6c 61 62 65 6c 20 69 6e 20 ifying label in
4fe0: 74 68 65 20 6d 65 6e 75 0a 65 6e 74 72 79 2e 20 the menu.entry.
4ff0: 20 4e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 66 Not available f
5000: 6f 72 20 73 65 70 61 72 61 74 6f 72 20 6f 72 20 or separator or
5010: 74 65 61 72 2d 6f 66 66 20 65 6e 74 72 69 65 73 tear-off entries
5020: 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 6d 65 6e 75 20 ...TP.\fB\-menu
5030: 5c 66 49 76 61 6c 75 65 5c 66 52 0a 41 76 61 69 \fIvalue\fR.Avai
5040: 6c 61 62 6c 65 20 6f 6e 6c 79 20 66 6f 72 20 63 lable only for c
5050: 61 73 63 61 64 65 20 65 6e 74 72 69 65 73 2e 20 ascade entries.
5060: 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 70 Specifies the p
5070: 61 74 68 20 6e 61 6d 65 20 6f 66 0a 74 68 65 20 ath name of.the
5080: 73 75 62 6d 65 6e 75 20 61 73 73 6f 63 69 61 74 submenu associat
5090: 65 64 20 77 69 74 68 20 74 68 69 73 20 65 6e 74 ed with this ent
50a0: 72 79 2e 0a 54 68 65 20 73 75 62 6d 65 6e 75 20 ry..The submenu
50b0: 6d 75 73 74 20 62 65 20 61 20 63 68 69 6c 64 20 must be a child
50c0: 6f 66 20 74 68 65 20 6d 65 6e 75 2e 0a 2e 54 50 of the menu...TP
50d0: 0a 5c 66 42 5c 2d 6f 66 66 76 61 6c 75 65 20 5c .\fB\-offvalue \
50e0: 66 49 76 61 6c 75 65 5c 66 52 0a 41 76 61 69 6c fIvalue\fR.Avail
50f0: 61 62 6c 65 20 6f 6e 6c 79 20 66 6f 72 20 63 68 able only for ch
5100: 65 63 6b 62 75 74 74 6f 6e 20 65 6e 74 72 69 65 eckbutton entrie
5110: 73 2e 20 20 53 70 65 63 69 66 69 65 73 20 74 68 s. Specifies th
5120: 65 20 76 61 6c 75 65 20 74 6f 0a 73 74 6f 72 65 e value to.store
5130: 20 69 6e 20 74 68 65 20 65 6e 74 72 79 27 73 20 in the entry's
5140: 61 73 73 6f 63 69 61 74 65 64 20 76 61 72 69 61 associated varia
5150: 62 6c 65 20 77 68 65 6e 20 74 68 65 20 65 6e 74 ble when the ent
5160: 72 79 20 69 73 0a 64 65 73 65 6c 65 63 74 65 64 ry is.deselected
5170: 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 6f 6e 76 61 6c ...TP.\fB\-onval
5180: 75 65 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a 41 ue \fIvalue\fR.A
5190: 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 66 6f vailable only fo
51a0: 72 20 63 68 65 63 6b 62 75 74 74 6f 6e 20 65 6e r checkbutton en
51b0: 74 72 69 65 73 2e 20 20 53 70 65 63 69 66 69 65 tries. Specifie
51c0: 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f 0a 73 s the value to.s
51d0: 74 6f 72 65 20 69 6e 20 74 68 65 20 65 6e 74 72 tore in the entr
51e0: 79 27 73 20 61 73 73 6f 63 69 61 74 65 64 20 76 y's associated v
51f0: 61 72 69 61 62 6c 65 20 77 68 65 6e 20 74 68 65 ariable when the
5200: 20 65 6e 74 72 79 20 69 73 20 73 65 6c 65 63 74 entry is select
5210: 65 64 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 73 65 6c ed...TP.\fB\-sel
5220: 65 63 74 63 6f 6c 6f 72 20 5c 66 49 76 61 6c 75 ectcolor \fIvalu
5230: 65 5c 66 52 0a 41 76 61 69 6c 61 62 6c 65 20 6f e\fR.Available o
5240: 6e 6c 79 20 66 6f 72 20 63 68 65 63 6b 62 75 74 nly for checkbut
5250: 74 6f 6e 20 61 6e 64 20 72 61 64 69 6f 62 75 74 ton and radiobut
5260: 74 6f 6e 20 65 6e 74 72 69 65 73 2e 0a 53 70 65 ton entries..Spe
5270: 63 69 66 69 65 73 20 74 68 65 20 63 6f 6c 6f 72 cifies the color
5280: 20 74 6f 20 64 69 73 70 6c 61 79 20 69 6e 20 74 to display in t
5290: 68 65 20 69 6e 64 69 63 61 74 6f 72 20 77 68 65 he indicator whe
52a0: 6e 20 74 68 65 20 65 6e 74 72 79 20 69 73 0a 73 n the entry is.s
52b0: 65 6c 65 63 74 65 64 2e 0a 49 66 20 74 68 65 20 elected..If the
52c0: 76 61 6c 75 65 20 69 73 20 61 6e 20 65 6d 70 74 value is an empt
52d0: 79 20 73 74 72 69 6e 67 20 28 74 68 65 20 64 65 y string (the de
52e0: 66 61 75 6c 74 29 20 74 68 65 6e 20 74 68 65 20 fault) then the
52f0: 5c 66 42 73 65 6c 65 63 74 43 6f 6c 6f 72 5c 66 \fBselectColor\f
5300: 52 0a 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 R.option for the
5310: 20 6d 65 6e 75 20 64 65 74 65 72 6d 69 6e 65 73 menu determines
5320: 20 74 68 65 20 69 6e 64 69 63 61 74 6f 72 20 63 the indicator c
5330: 6f 6c 6f 72 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 73 olor...TP.\fB\-s
5340: 65 6c 65 63 74 69 6d 61 67 65 20 5c 66 49 76 61 electimage \fIva
5350: 6c 75 65 5c 66 52 0a 41 76 61 69 6c 61 62 6c 65 lue\fR.Available
5360: 20 6f 6e 6c 79 20 66 6f 72 20 63 68 65 63 6b 62 only for checkb
5370: 75 74 74 6f 6e 20 61 6e 64 20 72 61 64 69 6f 62 utton and radiob
5380: 75 74 74 6f 6e 20 65 6e 74 72 69 65 73 2e 0a 53 utton entries..S
5390: 70 65 63 69 66 69 65 73 20 61 6e 20 69 6d 61 67 pecifies an imag
53a0: 65 20 74 6f 20 64 69 73 70 6c 61 79 20 69 6e 20 e to display in
53b0: 74 68 65 20 65 6e 74 72 79 20 28 69 6e 20 70 6c the entry (in pl
53c0: 61 63 65 20 6f 66 0a 74 68 65 20 5c 66 42 5c 2d ace of.the \fB\-
53d0: 69 6d 61 67 65 5c 66 52 20 6f 70 74 69 6f 6e 29 image\fR option)
53e0: 20 77 68 65 6e 20 69 74 20 69 73 20 73 65 6c 65 when it is sele
53f0: 63 74 65 64 2e 0a 5c 66 49 56 61 6c 75 65 5c 66 cted..\fIValue\f
5400: 52 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 R is the name of
5410: 20 61 6e 20 69 6d 61 67 65 2c 20 77 68 69 63 68 an image, which
5420: 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 6e 20 must have been
5430: 63 72 65 61 74 65 64 0a 62 79 20 73 6f 6d 65 20 created.by some
5440: 70 72 65 76 69 6f 75 73 20 69 6e 76 6f 63 61 74 previous invocat
5450: 69 6f 6e 20 6f 66 20 5c 66 42 69 6d 61 67 65 20 ion of \fBimage
5460: 63 72 65 61 74 65 5c 66 52 2e 0a 54 68 69 73 20 create\fR..This
5470: 6f 70 74 69 6f 6e 20 69 73 20 69 67 6e 6f 72 65 option is ignore
5480: 64 20 75 6e 6c 65 73 73 20 74 68 65 20 5c 66 42 d unless the \fB
5490: 5c 2d 69 6d 61 67 65 5c 66 52 20 6f 70 74 69 6f \-image\fR optio
54a0: 6e 20 68 61 73 0a 62 65 65 6e 20 73 70 65 63 69 n has.been speci
54b0: 66 69 65 64 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 73 fied...TP.\fB\-s
54c0: 74 61 74 65 20 5c 66 49 76 61 6c 75 65 5c 66 52 tate \fIvalue\fR
54d0: 0a 53 70 65 63 69 66 69 65 73 20 6f 6e 65 20 6f .Specifies one o
54e0: 66 20 74 68 72 65 65 20 73 74 61 74 65 73 20 66 f three states f
54f0: 6f 72 20 74 68 65 20 65 6e 74 72 79 3a 20 20 5c or the entry: \
5500: 66 42 6e 6f 72 6d 61 6c 5c 66 52 2c 20 5c 66 42 fBnormal\fR, \fB
5510: 61 63 74 69 76 65 5c 66 52 2c 0a 6f 72 20 5c 66 active\fR,.or \f
5520: 42 64 69 73 61 62 6c 65 64 5c 66 52 2e 20 20 49 Bdisabled\fR. I
5530: 6e 20 6e 6f 72 6d 61 6c 20 73 74 61 74 65 20 74 n normal state t
5540: 68 65 20 65 6e 74 72 79 20 69 73 20 64 69 73 70 he entry is disp
5550: 6c 61 79 65 64 20 75 73 69 6e 67 20 74 68 65 0a layed using the.
5560: 5c 66 42 66 6f 72 65 67 72 6f 75 6e 64 5c 66 52 \fBforeground\fR
5570: 20 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 option for the
5580: 6d 65 6e 75 20 61 6e 64 20 74 68 65 20 5c 66 42 menu and the \fB
5590: 62 61 63 6b 67 72 6f 75 6e 64 5c 66 52 0a 6f 70 background\fR.op
55a0: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 65 6e tion from the en
55b0: 74 72 79 20 6f 72 20 74 68 65 20 6d 65 6e 75 2e try or the menu.
55c0: 0a 54 68 65 20 61 63 74 69 76 65 20 73 74 61 74 .The active stat
55d0: 65 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 75 e is typically u
55e0: 73 65 64 20 77 68 65 6e 20 74 68 65 20 70 6f 69 sed when the poi
55f0: 6e 74 65 72 20 69 73 20 6f 76 65 72 20 74 68 65 nter is over the
5600: 20 65 6e 74 72 79 2e 0a 49 6e 20 61 63 74 69 76 entry..In activ
5610: 65 20 73 74 61 74 65 20 74 68 65 20 65 6e 74 72 e state the entr
5620: 79 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 75 y is displayed u
5630: 73 69 6e 67 20 74 68 65 20 5c 66 42 61 63 74 69 sing the \fBacti
5640: 76 65 46 6f 72 65 67 72 6f 75 6e 64 5c 66 52 0a veForeground\fR.
5650: 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6d option for the m
5660: 65 6e 75 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 enu along with t
5670: 68 65 20 5c 66 42 61 63 74 69 76 65 62 61 63 6b he \fBactiveback
5680: 67 72 6f 75 6e 64 5c 66 52 20 6f 70 74 69 6f 6e ground\fR option
5690: 20 66 72 6f 6d 0a 74 68 65 20 65 6e 74 72 79 2e from.the entry.
56a0: 20 20 44 69 73 61 62 6c 65 64 20 73 74 61 74 65 Disabled state
56b0: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
56c0: 65 6e 74 72 79 0a 73 68 6f 75 6c 64 20 62 65 20 entry.should be
56d0: 69 6e 73 65 6e 73 69 74 69 76 65 3a 20 20 74 68 insensitive: th
56e0: 65 20 64 65 66 61 75 6c 74 20 62 69 6e 64 69 6e e default bindin
56f0: 67 73 20 77 69 6c 6c 20 72 65 66 75 73 65 20 74 gs will refuse t
5700: 6f 20 61 63 74 69 76 61 74 65 0a 6f 72 20 69 6e o activate.or in
5710: 76 6f 6b 65 20 74 68 65 20 65 6e 74 72 79 2e 0a voke the entry..
5720: 49 6e 20 74 68 69 73 20 73 74 61 74 65 20 74 68 In this state th
5730: 65 20 65 6e 74 72 79 20 69 73 20 64 69 73 70 6c e entry is displ
5740: 61 79 65 64 20 61 63 63 6f 72 64 69 6e 67 20 74 ayed according t
5750: 6f 20 74 68 65 20 0a 5c 66 42 64 69 73 61 62 6c o the .\fBdisabl
5760: 65 64 46 6f 72 65 67 72 6f 75 6e 64 5c 66 52 20 edForeground\fR
5770: 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6d option for the m
5780: 65 6e 75 20 61 6e 64 20 74 68 65 0a 5c 66 42 62 enu and the.\fBb
5790: 61 63 6b 67 72 6f 75 6e 64 5c 66 52 20 6f 70 74 ackground\fR opt
57a0: 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 65 6e 74 ion from the ent
57b0: 72 79 2e 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 ry..This option
57c0: 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 is not available
57d0: 20 66 6f 72 20 73 65 70 61 72 61 74 6f 72 20 65 for separator e
57e0: 6e 74 72 69 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c ntries...TP.\fB\
57f0: 2d 75 6e 64 65 72 6c 69 6e 65 20 5c 66 49 76 61 -underline \fIva
5800: 6c 75 65 5c 66 52 0a 53 70 65 63 69 66 69 65 73 lue\fR.Specifies
5810: 20 74 68 65 20 69 6e 74 65 67 65 72 20 69 6e 64 the integer ind
5820: 65 78 20 6f 66 20 61 20 63 68 61 72 61 63 74 65 ex of a characte
5830: 72 20 74 6f 20 75 6e 64 65 72 6c 69 6e 65 20 69 r to underline i
5840: 6e 20 74 68 65 20 65 6e 74 72 79 2e 0a 54 68 69 n the entry..Thi
5850: 73 20 6f 70 74 69 6f 6e 20 69 73 20 61 6c 73 6f s option is also
5860: 20 71 75 65 72 69 65 64 20 62 79 20 74 68 65 20 queried by the
5870: 64 65 66 61 75 6c 74 20 62 69 6e 64 69 6e 67 73 default bindings
5880: 20 61 6e 64 20 75 73 65 64 20 74 6f 0a 69 6d 70 and used to.imp
5890: 6c 65 6d 65 6e 74 20 6b 65 79 62 6f 61 72 64 20 lement keyboard
58a0: 74 72 61 76 65 72 73 61 6c 2e 0a 30 20 63 6f 72 traversal..0 cor
58b0: 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 responds to the
58c0: 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 first character
58d0: 6f 66 20 74 68 65 20 74 65 78 74 20 64 69 73 70 of the text disp
58e0: 6c 61 79 65 64 20 69 6e 20 74 68 65 20 65 6e 74 layed in the ent
58f0: 72 79 2c 0a 31 20 74 6f 20 74 68 65 20 6e 65 78 ry,.1 to the nex
5900: 74 20 63 68 61 72 61 63 74 65 72 2c 20 61 6e 64 t character, and
5910: 20 73 6f 20 6f 6e 2e 0a 49 66 20 61 20 62 69 74 so on..If a bit
5920: 6d 61 70 20 6f 72 20 69 6d 61 67 65 20 69 73 20 map or image is
5930: 64 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 displayed in the
5940: 20 65 6e 74 72 79 20 74 68 65 6e 20 74 68 69 73 entry then this
5950: 20 6f 70 74 69 6f 6e 20 69 73 20 69 67 6e 6f 72 option is ignor
5960: 65 64 2e 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 ed..This option
5970: 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 is not available
5980: 20 66 6f 72 20 73 65 70 61 72 61 74 6f 72 20 6f for separator o
5990: 72 20 74 65 61 72 2d 6f 66 66 20 65 6e 74 72 69 r tear-off entri
59a0: 65 73 2e 0a 2e 54 50 0a 5c 66 42 5c 2d 76 61 6c es...TP.\fB\-val
59b0: 75 65 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a 41 ue \fIvalue\fR.A
59c0: 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 66 6f vailable only fo
59d0: 72 20 72 61 64 69 6f 62 75 74 74 6f 6e 20 65 6e r radiobutton en
59e0: 74 72 69 65 73 2e 20 20 53 70 65 63 69 66 69 65 tries. Specifie
59f0: 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f 0a 73 s the value to.s
5a00: 74 6f 72 65 20 69 6e 20 74 68 65 20 65 6e 74 72 tore in the entr
5a10: 79 27 73 20 61 73 73 6f 63 69 61 74 65 64 20 76 y's associated v
5a20: 61 72 69 61 62 6c 65 20 77 68 65 6e 20 74 68 65 ariable when the
5a30: 20 65 6e 74 72 79 20 69 73 20 73 65 6c 65 63 74 entry is select
5a40: 65 64 2e 0a 49 66 20 61 6e 20 65 6d 70 74 79 20 ed..If an empty
5a50: 73 74 72 69 6e 67 20 69 73 20 73 70 65 63 69 66 string is specif
5a60: 69 65 64 2c 20 74 68 65 6e 20 74 68 65 20 5c 66 ied, then the \f
5a70: 42 5c 2d 6c 61 62 65 6c 5c 66 52 20 6f 70 74 69 B\-label\fR opti
5a80: 6f 6e 0a 66 6f 72 20 74 68 65 20 65 6e 74 72 79 on.for the entry
5a90: 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f as the value to
5aa0: 20 73 74 6f 72 65 20 69 6e 20 74 68 65 20 76 61 store in the va
5ab0: 72 69 61 62 6c 65 2e 0a 2e 54 50 0a 5c 66 42 5c riable...TP.\fB\
5ac0: 2d 76 61 72 69 61 62 6c 65 20 5c 66 49 76 61 6c -variable \fIval
5ad0: 75 65 5c 66 52 0a 41 76 61 69 6c 61 62 6c 65 20 ue\fR.Available
5ae0: 6f 6e 6c 79 20 66 6f 72 20 63 68 65 63 6b 62 75 only for checkbu
5af0: 74 74 6f 6e 20 61 6e 64 20 72 61 64 69 6f 62 75 tton and radiobu
5b00: 74 74 6f 6e 20 65 6e 74 72 69 65 73 2e 20 20 53 tton entries. S
5b10: 70 65 63 69 66 69 65 73 0a 74 68 65 20 6e 61 6d pecifies.the nam
5b20: 65 20 6f 66 20 61 20 67 6c 6f 62 61 6c 20 76 61 e of a global va
5b30: 6c 75 65 20 74 6f 20 73 65 74 20 77 68 65 6e 20 lue to set when
5b40: 74 68 65 20 65 6e 74 72 79 20 69 73 20 73 65 6c the entry is sel
5b50: 65 63 74 65 64 2e 0a 46 6f 72 20 63 68 65 63 6b ected..For check
5b60: 62 75 74 74 6f 6e 20 65 6e 74 72 69 65 73 20 74 button entries t
5b70: 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 61 he variable is a
5b80: 6c 73 6f 20 73 65 74 20 77 68 65 6e 20 74 68 65 lso set when the
5b90: 20 65 6e 74 72 79 0a 69 73 20 64 65 73 65 6c 65 entry.is desele
5ba0: 63 74 65 64 2e 20 20 46 6f 72 20 72 61 64 69 6f cted. For radio
5bb0: 62 75 74 74 6f 6e 20 65 6e 74 72 69 65 73 2c 20 button entries,
5bc0: 63 68 61 6e 67 69 6e 67 20 74 68 65 20 76 61 72 changing the var
5bd0: 69 61 62 6c 65 0a 63 61 75 73 65 73 20 74 68 65 iable.causes the
5be0: 20 63 75 72 72 65 6e 74 6c 79 2d 73 65 6c 65 63 currently-selec
5bf0: 74 65 64 20 65 6e 74 72 79 20 74 6f 20 64 65 73 ted entry to des
5c00: 65 6c 65 63 74 20 69 74 73 65 6c 66 2e 0a 2e 4c elect itself...L
5c10: 50 0a 54 68 65 20 5c 66 42 61 64 64 5c 66 52 20 P.The \fBadd\fR
5c20: 77 69 64 67 65 74 20 63 6f 6d 6d 61 6e 64 20 72 widget command r
5c30: 65 74 75 72 6e 73 20 61 6e 20 65 6d 70 74 79 20 eturns an empty
5c40: 73 74 72 69 6e 67 2e 0a 2e 52 45 0a 2e 54 50 0a string...RE..TP.
5c50: 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 63 \fIpathName \fBc
5c60: 67 65 74 5c 66 52 20 5c 66 49 6f 70 74 69 6f 6e get\fR \fIoption
5c70: 5c 66 52 0a 52 65 74 75 72 6e 73 20 74 68 65 20 \fR.Returns the
5c80: 63 75 72 72 65 6e 74 20 76 61 6c 75 65 20 6f 66 current value of
5c90: 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 the configurati
5ca0: 6f 6e 20 6f 70 74 69 6f 6e 20 67 69 76 65 6e 0a on option given.
5cb0: 62 79 20 5c 66 49 6f 70 74 69 6f 6e 5c 66 52 2e by \fIoption\fR.
5cc0: 0a 5c 66 49 4f 70 74 69 6f 6e 5c 66 52 20 6d 61 .\fIOption\fR ma
5cd0: 79 20 68 61 76 65 20 61 6e 79 20 6f 66 20 74 68 y have any of th
5ce0: 65 20 76 61 6c 75 65 73 20 61 63 63 65 70 74 65 e values accepte
5cf0: 64 20 62 79 20 74 68 65 20 5c 66 42 6d 65 6e 75 d by the \fBmenu
5d00: 5c 66 52 0a 63 6f 6d 6d 61 6e 64 2e 0a 2e 56 53 \fR.command...VS
5d10: 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e 61 6d 65 ..TP.\fIpathName
5d20: 5c 66 52 20 5c 66 42 63 6c 6f 6e 65 5c 66 52 20 \fR \fBclone\fR
5d30: 5c 66 49 6e 65 77 50 61 74 68 6e 61 6d 65 20 3f \fInewPathname ?
5d40: 63 6c 6f 6e 65 54 79 70 65 3f 5c 66 52 0a 4d 61 cloneType?\fR.Ma
5d50: 6b 65 73 20 61 20 63 6c 6f 6e 65 20 6f 66 20 74 kes a clone of t
5d60: 68 65 20 63 75 72 72 65 6e 74 20 6d 65 6e 75 20 he current menu
5d70: 6e 61 6d 65 64 20 5c 66 49 6e 65 77 50 61 74 68 named \fInewPath
5d80: 4e 61 6d 65 5c 66 52 2e 20 54 68 69 73 20 63 6c Name\fR. This cl
5d90: 6f 6e 65 0a 69 73 20 61 20 6d 65 6e 75 20 69 6e one.is a menu in
5da0: 20 69 74 73 20 6f 77 6e 20 72 69 67 68 74 2c 20 its own right,
5db0: 62 75 74 20 61 6e 79 20 63 68 61 6e 67 65 73 20 but any changes
5dc0: 74 6f 20 74 68 65 20 63 6c 6f 6e 65 20 61 72 65 to the clone are
5dd0: 0a 70 72 6f 70 6f 67 61 74 65 64 20 74 6f 20 74 .propogated to t
5de0: 68 65 20 6f 72 69 67 69 6e 61 6c 20 6d 65 6e 75 he original menu
5df0: 20 61 6e 64 20 76 69 63 65 20 76 65 72 73 61 2e and vice versa.
5e00: 20 5c 66 49 63 6c 6f 6e 65 54 79 70 65 5c 66 52 \fIcloneType\fR
5e10: 20 63 61 6e 20 62 65 0a 5c 66 42 6e 6f 72 6d 61 can be.\fBnorma
5e20: 6c 5c 66 52 2c 20 5c 66 42 6d 65 6e 75 62 61 72 l\fR, \fBmenubar
5e30: 5c 66 52 2c 20 6f 72 20 5c 66 42 74 65 61 72 6f \fR, or \fBtearo
5e40: 66 66 5c 66 52 2e 20 53 68 6f 75 6c 64 20 6e 6f ff\fR. Should no
5e50: 74 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 0a 63 61 t normally be.ca
5e60: 6c 6c 65 64 20 6f 75 74 73 69 64 65 20 6f 66 20 lled outside of
5e70: 74 68 65 20 54 6b 20 6c 69 62 72 61 72 79 2e 20 the Tk library.
5e80: 53 65 65 20 74 68 65 20 5c 66 42 43 4c 4f 4e 45 See the \fBCLONE
5e90: 53 5c 66 52 20 73 65 63 74 69 6f 6e 20 66 6f 72 S\fR section for
5ea0: 0a 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f .more informatio
5eb0: 6e 2e 0a 2e 56 45 0a 2e 54 50 0a 5c 66 49 70 61 n...VE..TP.\fIpa
5ec0: 74 68 4e 61 6d 65 20 5c 66 42 63 6f 6e 66 69 67 thName \fBconfig
5ed0: 75 72 65 5c 66 52 20 3f 5c 66 49 6f 70 74 69 6f ure\fR ?\fIoptio
5ee0: 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 20 n\fR? ?\fIvalue
5ef0: 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e option value ...
5f00: 5c 66 52 3f 0a 51 75 65 72 79 20 6f 72 20 6d 6f \fR?.Query or mo
5f10: 64 69 66 79 20 74 68 65 20 63 6f 6e 66 69 67 75 dify the configu
5f20: 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 6f ration options o
5f30: 66 20 74 68 65 20 77 69 64 67 65 74 2e 0a 49 66 f the widget..If
5f40: 20 6e 6f 20 5c 66 49 6f 70 74 69 6f 6e 5c 66 52 no \fIoption\fR
5f50: 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 72 is specified, r
5f60: 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 64 65 eturns a list de
5f70: 73 63 72 69 62 69 6e 67 20 61 6c 6c 20 6f 66 0a scribing all of.
5f80: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 70 the available op
5f90: 74 69 6f 6e 73 20 66 6f 72 20 5c 66 49 70 61 74 tions for \fIpat
5fa0: 68 4e 61 6d 65 5c 66 52 20 28 73 65 65 20 5c 66 hName\fR (see \f
5fb0: 42 54 6b 5f 43 6f 6e 66 69 67 75 72 65 49 6e 66 BTk_ConfigureInf
5fc0: 6f 5c 66 52 20 66 6f 72 0a 69 6e 66 6f 72 6d 61 o\fR for.informa
5fd0: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 66 6f 72 6d tion on the form
5fe0: 61 74 20 6f 66 20 74 68 69 73 20 6c 69 73 74 29 at of this list)
5ff0: 2e 20 20 49 66 20 5c 66 49 6f 70 74 69 6f 6e 5c . If \fIoption\
6000: 66 52 20 69 73 20 73 70 65 63 69 66 69 65 64 0a fR is specified.
6010: 77 69 74 68 20 6e 6f 20 5c 66 49 76 61 6c 75 65 with no \fIvalue
6020: 5c 66 52 2c 20 74 68 65 6e 20 74 68 65 20 63 6f \fR, then the co
6030: 6d 6d 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 mmand returns a
6040: 6c 69 73 74 20 64 65 73 63 72 69 62 69 6e 67 20 list describing
6050: 74 68 65 0a 6f 6e 65 20 6e 61 6d 65 64 20 6f 70 the.one named op
6060: 74 69 6f 6e 20 28 74 68 69 73 20 6c 69 73 74 20 tion (this list
6070: 77 69 6c 6c 20 62 65 20 69 64 65 6e 74 69 63 61 will be identica
6080: 6c 20 74 6f 20 74 68 65 20 63 6f 72 72 65 73 70 l to the corresp
6090: 6f 6e 64 69 6e 67 0a 73 75 62 6c 69 73 74 20 6f onding.sublist o
60a0: 66 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 f the value retu
60b0: 72 6e 65 64 20 69 66 20 6e 6f 20 5c 66 49 6f 70 rned if no \fIop
60c0: 74 69 6f 6e 5c 66 52 20 69 73 20 73 70 65 63 69 tion\fR is speci
60d0: 66 69 65 64 29 2e 20 20 49 66 0a 6f 6e 65 20 6f fied). If.one o
60e0: 72 20 6d 6f 72 65 20 5c 66 49 6f 70 74 69 6f 6e r more \fIoption
60f0: 5c 2d 76 61 6c 75 65 5c 66 52 20 70 61 69 72 73 \-value\fR pairs
6100: 20 61 72 65 20 73 70 65 63 69 66 69 65 64 2c 20 are specified,
6110: 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 then the command
6120: 0a 6d 6f 64 69 66 69 65 73 20 74 68 65 20 67 69 .modifies the gi
6130: 76 65 6e 20 77 69 64 67 65 74 20 6f 70 74 69 6f ven widget optio
6140: 6e 28 73 29 20 74 6f 20 68 61 76 65 20 74 68 65 n(s) to have the
6150: 20 67 69 76 65 6e 20 76 61 6c 75 65 28 73 29 3b given value(s);
6160: 20 20 69 6e 0a 74 68 69 73 20 63 61 73 65 20 74 in.this case t
6170: 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 74 75 72 he command retur
6180: 6e 73 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 ns an empty stri
6190: 6e 67 2e 0a 5c 66 49 4f 70 74 69 6f 6e 5c 66 52 ng..\fIOption\fR
61a0: 20 6d 61 79 20 68 61 76 65 20 61 6e 79 20 6f 66 may have any of
61b0: 20 74 68 65 20 76 61 6c 75 65 73 20 61 63 63 65 the values acce
61c0: 70 74 65 64 20 62 79 20 74 68 65 20 5c 66 42 6d pted by the \fBm
61d0: 65 6e 75 5c 66 52 0a 63 6f 6d 6d 61 6e 64 2e 0a enu\fR.command..
61e0: 2e 54 50 0a 5c 66 49 70 61 74 68 4e 61 6d 65 20 .TP.\fIpathName
61f0: 5c 66 42 64 65 6c 65 74 65 20 5c 66 49 69 6e 64 \fBdelete \fIind
6200: 65 78 31 5c 66 52 20 3f 5c 66 49 69 6e 64 65 78 ex1\fR ?\fIindex
6210: 32 5c 66 52 3f 0a 44 65 6c 65 74 65 20 61 6c 6c 2\fR?.Delete all
6220: 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 65 6e 74 of the menu ent
6230: 72 69 65 73 20 62 65 74 77 65 65 6e 20 5c 66 49 ries between \fI
6240: 69 6e 64 65 78 31 5c 66 52 20 61 6e 64 0a 5c 66 index1\fR and.\f
6250: 49 69 6e 64 65 78 32 5c 66 52 20 69 6e 63 6c 75 Iindex2\fR inclu
6260: 73 69 76 65 2e 0a 49 66 20 5c 66 49 69 6e 64 65 sive..If \fIinde
6270: 78 32 5c 66 52 20 69 73 20 6f 6d 69 74 74 65 64 x2\fR is omitted
6280: 20 74 68 65 6e 20 69 74 20 64 65 66 61 75 6c 74 then it default
6290: 73 20 74 6f 20 5c 66 49 69 6e 64 65 78 31 5c 66 s to \fIindex1\f
62a0: 52 2e 0a 41 74 74 65 6d 70 74 73 20 74 6f 20 64 R..Attempts to d
62b0: 65 6c 65 74 65 20 61 20 74 65 61 72 2d 6f 66 66 elete a tear-off
62c0: 20 6d 65 6e 75 20 65 6e 74 72 79 20 61 72 65 20 menu entry are
62d0: 69 67 6e 6f 72 65 64 20 28 69 6e 73 74 65 61 64 ignored (instead
62e0: 2c 20 79 6f 75 0a 73 68 6f 75 6c 64 20 63 68 61 , you.should cha
62f0: 6e 67 65 20 74 68 65 20 5c 66 42 74 65 61 72 4f nge the \fBtearO
6300: 66 66 5c 66 52 20 6f 70 74 69 6f 6e 20 74 6f 20 ff\fR option to
6310: 72 65 6d 6f 76 65 20 74 68 65 20 74 65 61 72 2d remove the tear-
6320: 6f 66 66 20 65 6e 74 72 79 29 2e 0a 2e 54 50 0a off entry)...TP.
6330: 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 65 \fIpathName \fBe
6340: 6e 74 72 79 63 67 65 74 5c 66 52 20 5c 66 49 69 ntrycget\fR \fIi
6350: 6e 64 65 78 20 6f 70 74 69 6f 6e 5c 66 52 0a 52 ndex option\fR.R
6360: 65 74 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 eturns the curre
6370: 6e 74 20 76 61 6c 75 65 20 6f 66 20 61 20 63 6f nt value of a co
6380: 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 nfiguration opti
6390: 6f 6e 20 66 6f 72 0a 74 68 65 20 65 6e 74 72 79 on for.the entry
63a0: 20 67 69 76 65 6e 20 62 79 20 5c 66 49 69 6e 64 given by \fIind
63b0: 65 78 5c 66 52 2e 0a 5c 66 49 4f 70 74 69 6f 6e ex\fR..\fIOption
63c0: 5c 66 52 20 6d 61 79 20 68 61 76 65 20 61 6e 79 \fR may have any
63d0: 20 6f 66 20 74 68 65 20 76 61 6c 75 65 73 20 61 of the values a
63e0: 63 63 65 70 74 65 64 20 62 79 20 74 68 65 20 5c ccepted by the \
63f0: 66 42 61 64 64 5c 66 52 0a 77 69 64 67 65 74 20 fBadd\fR.widget
6400: 63 6f 6d 6d 61 6e 64 2e 0a 2e 54 50 0a 5c 66 49 command...TP.\fI
6410: 70 61 74 68 4e 61 6d 65 20 5c 66 42 65 6e 74 72 pathName \fBentr
6420: 79 63 6f 6e 66 69 67 75 72 65 20 5c 66 49 69 6e yconfigure \fIin
6430: 64 65 78 20 5c 66 52 3f 5c 66 49 6f 70 74 69 6f dex \fR?\fIoptio
6440: 6e 73 5c 66 52 3f 0a 54 68 69 73 20 63 6f 6d 6d ns\fR?.This comm
6450: 61 6e 64 20 69 73 20 73 69 6d 69 6c 61 72 20 74 and is similar t
6460: 6f 20 74 68 65 20 5c 66 42 63 6f 6e 66 69 67 75 o the \fBconfigu
6470: 72 65 5c 66 52 20 63 6f 6d 6d 61 6e 64 2c 20 65 re\fR command, e
6480: 78 63 65 70 74 20 74 68 61 74 0a 69 74 20 61 70 xcept that.it ap
6490: 70 6c 69 65 73 20 74 6f 20 74 68 65 20 6f 70 74 plies to the opt
64a0: 69 6f 6e 73 20 66 6f 72 20 61 6e 20 69 6e 64 69 ions for an indi
64b0: 76 69 64 75 61 6c 20 65 6e 74 72 79 2c 20 77 68 vidual entry, wh
64c0: 65 72 65 61 73 20 5c 66 42 63 6f 6e 66 69 67 75 ereas \fBconfigu
64d0: 72 65 5c 66 52 0a 61 70 70 6c 69 65 73 20 74 6f re\fR.applies to
64e0: 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 66 6f 72 the options for
64f0: 20 74 68 65 20 6d 65 6e 75 20 61 73 20 61 20 77 the menu as a w
6500: 68 6f 6c 65 2e 0a 5c 66 49 4f 70 74 69 6f 6e 73 hole..\fIOptions
6510: 5c 66 52 20 6d 61 79 20 68 61 76 65 20 61 6e 79 \fR may have any
6520: 20 6f 66 20 74 68 65 20 76 61 6c 75 65 73 20 61 of the values a
6530: 63 63 65 70 74 65 64 20 62 79 20 74 68 65 20 5c ccepted by the \
6540: 66 42 61 64 64 5c 66 52 0a 77 69 64 67 65 74 20 fBadd\fR.widget
6550: 63 6f 6d 6d 61 6e 64 2e 20 20 49 66 20 5c 66 49 command. If \fI
6560: 6f 70 74 69 6f 6e 73 5c 66 52 20 61 72 65 20 73 options\fR are s
6570: 70 65 63 69 66 69 65 64 2c 20 6f 70 74 69 6f 6e pecified, option
6580: 73 20 61 72 65 20 6d 6f 64 69 66 69 65 64 0a 61 s are modified.a
6590: 73 20 69 6e 64 69 63 61 74 65 64 0a 69 6e 20 74 s indicated.in t
65a0: 68 65 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74 he command and t
65b0: 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 74 75 72 he command retur
65c0: 6e 73 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 ns an empty stri
65d0: 6e 67 2e 0a 49 66 20 6e 6f 20 5c 66 49 6f 70 74 ng..If no \fIopt
65e0: 69 6f 6e 73 5c 66 52 20 61 72 65 20 73 70 65 63 ions\fR are spec
65f0: 69 66 69 65 64 2c 20 72 65 74 75 72 6e 73 20 61 ified, returns a
6600: 20 6c 69 73 74 20 64 65 73 63 72 69 62 69 6e 67 list describing
6610: 0a 74 68 65 20 63 75 72 72 65 6e 74 20 6f 70 74 .the current opt
6620: 69 6f 6e 73 20 66 6f 72 20 65 6e 74 72 79 20 5c ions for entry \
6630: 66 49 69 6e 64 65 78 5c 66 52 20 28 73 65 65 20 fIindex\fR (see
6640: 5c 66 42 54 6b 5f 43 6f 6e 66 69 67 75 72 65 49 \fBTk_ConfigureI
6650: 6e 66 6f 5c 66 52 20 66 6f 72 0a 69 6e 66 6f 72 nfo\fR for.infor
6660: 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 66 6f mation on the fo
6670: 72 6d 61 74 20 6f 66 20 74 68 69 73 20 6c 69 73 rmat of this lis
6680: 74 29 2e 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e t)...TP.\fIpathN
6690: 61 6d 65 20 5c 66 42 69 6e 64 65 78 20 5c 66 49 ame \fBindex \fI
66a0: 69 6e 64 65 78 5c 66 52 0a 52 65 74 75 72 6e 73 index\fR.Returns
66b0: 20 74 68 65 20 6e 75 6d 65 72 69 63 61 6c 20 69 the numerical i
66c0: 6e 64 65 78 20 63 6f 72 72 65 73 70 6f 6e 64 69 ndex correspondi
66d0: 6e 67 20 74 6f 20 5c 66 49 69 6e 64 65 78 5c 66 ng to \fIindex\f
66e0: 52 2c 20 6f 72 0a 5c 66 42 6e 6f 6e 65 5c 66 52 R, or.\fBnone\fR
66f0: 20 69 66 20 5c 66 49 69 6e 64 65 78 5c 66 52 20 if \fIindex\fR
6700: 77 61 73 20 73 70 65 63 69 66 69 65 64 20 61 73 was specified as
6710: 20 5c 66 42 6e 6f 6e 65 5c 66 52 2e 0a 2e 54 50 \fBnone\fR...TP
6720: 0a 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 .\fIpathName \fB
6730: 69 6e 73 65 72 74 20 5c 66 49 69 6e 64 65 78 5c insert \fIindex\
6740: 66 52 20 5c 66 49 74 79 70 65 20 5c 66 52 3f 5c fR \fItype \fR?\
6750: 66 49 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 6f fIoption value o
6760: 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 5c ption value ...\
6770: 66 52 3f 0a 53 61 6d 65 20 61 73 20 74 68 65 20 fR?.Same as the
6780: 5c 66 42 61 64 64 5c 66 52 20 77 69 64 67 65 74 \fBadd\fR widget
6790: 20 63 6f 6d 6d 61 6e 64 20 65 78 63 65 70 74 20 command except
67a0: 74 68 61 74 20 69 74 20 69 6e 73 65 72 74 73 20 that it inserts
67b0: 74 68 65 20 6e 65 77 0a 65 6e 74 72 79 20 6a 75 the new.entry ju
67c0: 73 74 20 62 65 66 6f 72 65 20 74 68 65 20 65 6e st before the en
67d0: 74 72 79 20 67 69 76 65 6e 20 62 79 20 5c 66 49 try given by \fI
67e0: 69 6e 64 65 78 5c 66 52 2c 20 69 6e 73 74 65 61 index\fR, instea
67f0: 64 20 6f 66 20 61 70 70 65 6e 64 69 6e 67 0a 74 d of appending.t
6800: 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 o the end of the
6810: 20 6d 65 6e 75 2e 20 20 54 68 65 20 5c 66 49 74 menu. The \fIt
6820: 79 70 65 5c 66 52 2c 20 5c 66 49 6f 70 74 69 6f ype\fR, \fIoptio
6830: 6e 5c 66 52 2c 20 61 6e 64 20 5c 66 49 76 61 6c n\fR, and \fIval
6840: 75 65 5c 66 52 0a 61 72 67 75 6d 65 6e 74 73 20 ue\fR.arguments
6850: 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 69 6e have the same in
6860: 74 65 72 70 72 65 74 61 74 69 6f 6e 20 61 73 20 terpretation as
6870: 66 6f 72 20 74 68 65 20 5c 66 42 61 64 64 5c 66 for the \fBadd\f
6880: 52 20 77 69 64 67 65 74 0a 63 6f 6d 6d 61 6e 64 R widget.command
6890: 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 . It is not pos
68a0: 73 69 62 6c 65 20 74 6f 20 69 6e 73 65 72 74 20 sible to insert
68b0: 6e 65 77 20 6d 65 6e 75 20 65 6e 74 72 69 65 73 new menu entries
68c0: 20 62 65 66 6f 72 65 20 74 68 65 0a 74 65 61 72 before the.tear
68d0: 2d 6f 66 66 20 65 6e 74 72 79 2c 20 69 66 20 74 -off entry, if t
68e0: 68 65 20 6d 65 6e 75 20 68 61 73 20 6f 6e 65 2e he menu has one.
68f0: 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e 61 6d 65 ..TP.\fIpathName
6900: 20 5c 66 42 69 6e 76 6f 6b 65 20 5c 66 49 69 6e \fBinvoke \fIin
6910: 64 65 78 5c 66 52 0a 49 6e 76 6f 6b 65 20 74 68 dex\fR.Invoke th
6920: 65 20 61 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 e action of the
6930: 6d 65 6e 75 20 65 6e 74 72 79 2e 20 20 53 65 65 menu entry. See
6940: 20 74 68 65 20 73 65 63 74 69 6f 6e 73 20 6f 6e the sections on
6950: 20 74 68 65 0a 69 6e 64 69 76 69 64 75 61 6c 20 the.individual
6960: 65 6e 74 72 69 65 73 20 61 62 6f 76 65 20 66 6f entries above fo
6970: 72 20 64 65 74 61 69 6c 73 20 6f 6e 20 77 68 61 r details on wha
6980: 74 20 68 61 70 70 65 6e 73 2e 20 20 49 66 20 74 t happens. If t
6990: 68 65 0a 6d 65 6e 75 20 65 6e 74 72 79 20 69 73 he.menu entry is
69a0: 20 64 69 73 61 62 6c 65 64 20 74 68 65 6e 20 6e disabled then n
69b0: 6f 74 68 69 6e 67 20 68 61 70 70 65 6e 73 2e 20 othing happens.
69c0: 20 49 66 20 74 68 65 0a 65 6e 74 72 79 20 68 61 If the.entry ha
69d0: 73 20 61 20 63 6f 6d 6d 61 6e 64 20 61 73 73 6f s a command asso
69e0: 63 69 61 74 65 64 20 77 69 74 68 20 69 74 20 74 ciated with it t
69f0: 68 65 6e 20 74 68 65 20 72 65 73 75 6c 74 20 6f hen the result o
6a00: 66 20 74 68 61 74 0a 63 6f 6d 6d 61 6e 64 20 69 f that.command i
6a10: 73 20 72 65 74 75 72 6e 65 64 20 61 73 20 74 68 s returned as th
6a20: 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 e result of the
6a30: 5c 66 42 69 6e 76 6f 6b 65 5c 66 52 20 77 69 64 \fBinvoke\fR wid
6a40: 67 65 74 0a 63 6f 6d 6d 61 6e 64 2e 20 20 4f 74 get.command. Ot
6a50: 68 65 72 77 69 73 65 20 74 68 65 20 72 65 73 75 herwise the resu
6a60: 6c 74 20 69 73 20 61 6e 20 65 6d 70 74 79 20 73 lt is an empty s
6a70: 74 72 69 6e 67 2e 20 20 4e 6f 74 65 3a 20 20 69 tring. Note: i
6a80: 6e 76 6f 6b 69 6e 67 0a 61 20 6d 65 6e 75 20 65 nvoking.a menu e
6a90: 6e 74 72 79 20 64 6f 65 73 20 6e 6f 74 20 61 75 ntry does not au
6aa0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 6e 70 6f tomatically unpo
6ab0: 73 74 20 74 68 65 20 6d 65 6e 75 3b 20 20 74 68 st the menu; th
6ac0: 65 20 64 65 66 61 75 6c 74 0a 62 69 6e 64 69 6e e default.bindin
6ad0: 67 73 20 6e 6f 72 6d 61 6c 6c 79 20 74 61 6b 65 gs normally take
6ae0: 20 63 61 72 65 20 6f 66 20 74 68 69 73 20 62 65 care of this be
6af0: 66 6f 72 65 20 69 6e 76 6f 6b 69 6e 67 20 74 68 fore invoking th
6b00: 65 20 5c 66 42 69 6e 76 6f 6b 65 5c 66 52 0a 77 e \fBinvoke\fR.w
6b10: 69 64 67 65 74 20 63 6f 6d 6d 61 6e 64 2e 0a 2e idget command...
6b20: 54 50 0a 5c 66 49 70 61 74 68 4e 61 6d 65 20 5c TP.\fIpathName \
6b30: 66 42 70 6f 73 74 20 5c 66 49 78 20 79 5c 66 52 fBpost \fIx y\fR
6b40: 0a 41 72 72 61 6e 67 65 20 66 6f 72 20 74 68 65 .Arrange for the
6b50: 20 6d 65 6e 75 20 74 6f 20 62 65 20 64 69 73 70 menu to be disp
6b60: 6c 61 79 65 64 20 6f 6e 20 74 68 65 20 73 63 72 layed on the scr
6b70: 65 65 6e 20 61 74 20 74 68 65 20 72 6f 6f 74 2d een at the root-
6b80: 77 69 6e 64 6f 77 0a 63 6f 6f 72 64 69 6e 61 74 window.coordinat
6b90: 65 73 20 67 69 76 65 6e 20 62 79 20 5c 66 49 78 es given by \fIx
6ba0: 5c 66 52 20 61 6e 64 20 5c 66 49 79 5c 66 52 2e \fR and \fIy\fR.
6bb0: 20 20 54 68 65 73 65 20 63 6f 6f 72 64 69 6e 61 These coordina
6bc0: 74 65 73 20 61 72 65 0a 61 64 6a 75 73 74 65 64 tes are.adjusted
6bd0: 20 69 66 20 6e 65 63 65 73 73 61 72 79 20 74 6f if necessary to
6be0: 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 20 guarantee that
6bf0: 74 68 65 20 65 6e 74 69 72 65 20 6d 65 6e 75 20 the entire menu
6c00: 69 73 20 76 69 73 69 62 6c 65 20 6f 6e 0a 74 68 is visible on.th
6c10: 65 20 73 63 72 65 65 6e 2e 20 20 54 68 69 73 20 e screen. This
6c20: 63 6f 6d 6d 61 6e 64 20 6e 6f 72 6d 61 6c 6c 79 command normally
6c30: 20 72 65 74 75 72 6e 73 20 61 6e 20 65 6d 70 74 returns an empt
6c40: 79 20 73 74 72 69 6e 67 2e 0a 49 66 20 74 68 65 y string..If the
6c50: 20 5c 66 42 70 6f 73 74 43 6f 6d 6d 61 6e 64 5c \fBpostCommand\
6c60: 66 52 20 6f 70 74 69 6f 6e 20 68 61 73 20 62 65 fR option has be
6c70: 65 6e 20 73 70 65 63 69 66 69 65 64 2c 20 74 68 en specified, th
6c80: 65 6e 20 69 74 73 20 76 61 6c 75 65 20 69 73 0a en its value is.
6c90: 65 78 65 63 75 74 65 64 20 61 73 20 61 20 54 63 executed as a Tc
6ca0: 6c 20 73 63 72 69 70 74 20 62 65 66 6f 72 65 20 l script before
6cb0: 70 6f 73 74 69 6e 67 20 74 68 65 20 6d 65 6e 75 posting the menu
6cc0: 20 61 6e 64 20 74 68 65 20 72 65 73 75 6c 74 20 and the result
6cd0: 6f 66 0a 74 68 61 74 20 73 63 72 69 70 74 20 69 of.that script i
6ce0: 73 20 72 65 74 75 72 6e 65 64 20 61 73 20 74 68 s returned as th
6cf0: 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 e result of the
6d00: 5c 66 42 70 6f 73 74 5c 66 52 20 77 69 64 67 65 \fBpost\fR widge
6d10: 74 0a 63 6f 6d 6d 61 6e 64 2e 0a 49 66 20 61 6e t.command..If an
6d20: 20 65 72 72 6f 72 20 72 65 74 75 72 6e 73 20 77 error returns w
6d30: 68 69 6c 65 20 65 78 65 63 75 74 69 6e 67 20 74 hile executing t
6d40: 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 6e he command, then
6d50: 20 74 68 65 20 65 72 72 6f 72 20 69 73 0a 72 65 the error is.re
6d60: 74 75 72 6e 65 64 20 77 69 74 68 6f 75 74 20 70 turned without p
6d70: 6f 73 74 69 6e 67 20 74 68 65 20 6d 65 6e 75 2e osting the menu.
6d80: 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e 61 6d 65 ..TP.\fIpathName
6d90: 20 5c 66 42 70 6f 73 74 63 61 73 63 61 64 65 20 \fBpostcascade
6da0: 5c 66 49 69 6e 64 65 78 5c 66 52 0a 50 6f 73 74 \fIindex\fR.Post
6db0: 73 20 74 68 65 20 73 75 62 6d 65 6e 75 20 61 73 s the submenu as
6dc0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
6dd0: 65 20 63 61 73 63 61 64 65 20 65 6e 74 72 79 20 e cascade entry
6de0: 67 69 76 65 6e 20 62 79 0a 5c 66 49 69 6e 64 65 given by.\fIinde
6df0: 78 5c 66 52 2c 20 61 6e 64 20 75 6e 70 6f 73 74 x\fR, and unpost
6e00: 73 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 s any previously
6e10: 20 70 6f 73 74 65 64 20 73 75 62 6d 65 6e 75 2e posted submenu.
6e20: 0a 49 66 20 5c 66 49 69 6e 64 65 78 5c 66 52 20 .If \fIindex\fR
6e30: 64 6f 65 73 6e 27 74 20 63 6f 72 72 65 73 70 6f doesn't correspo
6e40: 6e 64 20 74 6f 20 61 20 63 61 73 63 61 64 65 20 nd to a cascade
6e50: 65 6e 74 72 79 2c 0a 6f 72 20 69 66 20 5c 66 49 entry,.or if \fI
6e60: 70 61 74 68 4e 61 6d 65 5c 66 52 20 69 73 6e 27 pathName\fR isn'
6e70: 74 20 70 6f 73 74 65 64 2c 0a 74 68 65 20 63 6f t posted,.the co
6e80: 6d 6d 61 6e 64 20 68 61 73 20 6e 6f 20 65 66 66 mmand has no eff
6e90: 65 63 74 20 65 78 63 65 70 74 20 74 6f 20 75 6e ect except to un
6ea0: 70 6f 73 74 20 61 6e 79 20 63 75 72 72 65 6e 74 post any current
6eb0: 6c 79 20 70 6f 73 74 65 64 0a 73 75 62 6d 65 6e ly posted.submen
6ec0: 75 2e 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e 61 u...TP.\fIpathNa
6ed0: 6d 65 20 5c 66 42 74 79 70 65 20 5c 66 49 69 6e me \fBtype \fIin
6ee0: 64 65 78 5c 66 52 0a 52 65 74 75 72 6e 73 20 74 dex\fR.Returns t
6ef0: 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 6d he type of the m
6f00: 65 6e 75 20 65 6e 74 72 79 20 67 69 76 65 6e 20 enu entry given
6f10: 62 79 20 5c 66 49 69 6e 64 65 78 5c 66 52 2e 0a by \fIindex\fR..
6f20: 54 68 69 73 20 69 73 20 74 68 65 20 5c 66 49 74 This is the \fIt
6f30: 79 70 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 20 ype\fR argument
6f40: 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 5c 66 passed to the \f
6f50: 42 61 64 64 5c 66 52 20 77 69 64 67 65 74 0a 63 Badd\fR widget.c
6f60: 6f 6d 6d 61 6e 64 20 77 68 65 6e 20 74 68 65 20 ommand when the
6f70: 65 6e 74 72 79 20 77 61 73 20 63 72 65 61 74 65 entry was create
6f80: 64 2c 20 73 75 63 68 20 61 73 20 5c 66 42 63 6f d, such as \fBco
6f90: 6d 6d 61 6e 64 5c 66 52 0a 6f 72 20 5c 66 42 73 mmand\fR.or \fBs
6fa0: 65 70 61 72 61 74 6f 72 5c 66 52 2c 20 6f 72 20 eparator\fR, or
6fb0: 5c 66 42 74 65 61 72 6f 66 66 5c 66 52 20 66 6f \fBtearoff\fR fo
6fc0: 72 20 61 20 74 65 61 72 2d 6f 66 66 20 65 6e 74 r a tear-off ent
6fd0: 72 79 2e 0a 2e 54 50 0a 5c 66 49 70 61 74 68 4e ry...TP.\fIpathN
6fe0: 61 6d 65 20 5c 66 42 75 6e 70 6f 73 74 5c 66 52 ame \fBunpost\fR
6ff0: 0a 2e 56 53 0a 55 6e 6d 61 70 20 74 68 65 20 77 ..VS.Unmap the w
7000: 69 6e 64 6f 77 20 73 6f 20 74 68 61 74 20 69 74 indow so that it
7010: 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 64 69 is no longer di
7020: 73 70 6c 61 79 65 64 2e 20 20 49 66 20 61 0a 6c splayed. If a.l
7030: 6f 77 65 72 2d 6c 65 76 65 6c 20 63 61 73 63 61 ower-level casca
7040: 64 65 64 20 6d 65 6e 75 20 69 73 20 70 6f 73 74 ded menu is post
7050: 65 64 2c 20 75 6e 70 6f 73 74 20 74 68 61 74 20 ed, unpost that
7060: 6d 65 6e 75 2e 20 20 52 65 74 75 72 6e 73 20 61 menu. Returns a
7070: 6e 0a 65 6d 70 74 79 20 73 74 72 69 6e 67 2e 20 n.empty string.
7080: 54 68 69 73 20 73 75 62 63 6f 6d 6d 61 6e 64 20 This subcommand
7090: 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e does not work on
70a0: 20 57 69 6e 64 6f 77 73 20 61 6e 64 20 74 68 65 Windows and the
70b0: 0a 4d 61 63 69 6e 74 6f 73 68 2c 20 61 73 20 74 .Macintosh, as t
70c0: 68 6f 73 65 20 70 6c 61 74 66 6f 72 6d 73 20 68 hose platforms h
70d0: 61 76 65 20 74 68 65 69 72 20 6f 77 6e 20 77 61 ave their own wa
70e0: 79 20 6f 66 20 75 6e 70 6f 73 74 69 6e 67 20 6d y of unposting m
70f0: 65 6e 75 73 2e 0a 2e 56 45 0a 2e 54 50 0a 5c 66 enus...VE..TP.\f
7100: 49 70 61 74 68 4e 61 6d 65 20 5c 66 42 79 70 6f IpathName \fBypo
7110: 73 69 74 69 6f 6e 20 5c 66 49 69 6e 64 65 78 5c sition \fIindex\
7120: 66 52 0a 52 65 74 75 72 6e 73 20 61 20 64 65 63 fR.Returns a dec
7130: 69 6d 61 6c 20 73 74 72 69 6e 67 20 67 69 76 69 imal string givi
7140: 6e 67 20 74 68 65 20 79 2d 63 6f 6f 72 64 69 6e ng the y-coordin
7150: 61 74 65 20 77 69 74 68 69 6e 20 74 68 65 20 6d ate within the m
7160: 65 6e 75 0a 77 69 6e 64 6f 77 20 6f 66 20 74 68 enu.window of th
7170: 65 20 74 6f 70 6d 6f 73 74 20 70 69 78 65 6c 20 e topmost pixel
7180: 69 6e 20 74 68 65 20 65 6e 74 72 79 20 73 70 65 in the entry spe
7190: 63 69 66 69 65 64 20 62 79 20 5c 66 49 69 6e 64 cified by \fIind
71a0: 65 78 5c 66 52 2e 0a 0a 2e 53 48 20 22 4d 45 4e ex\fR....SH "MEN
71b0: 55 20 43 4f 4e 46 49 47 55 52 41 54 49 4f 4e 53 U CONFIGURATIONS
71c0: 22 0a 2e 50 50 0a 54 68 65 20 64 65 66 61 75 6c "..PP.The defaul
71d0: 74 20 62 69 6e 64 69 6e 67 73 20 73 75 70 70 6f t bindings suppo
71e0: 72 74 20 66 6f 75 72 20 64 69 66 66 65 72 65 6e rt four differen
71f0: 74 20 77 61 79 73 20 6f 66 20 75 73 69 6e 67 20 t ways of using
7200: 6d 65 6e 75 73 3a 0a 2e 56 53 0a 2e 54 50 0a 5c menus:..VS..TP.\
7210: 66 42 50 75 6c 6c 64 6f 77 6e 20 4d 65 6e 75 73 fBPulldown Menus
7220: 20 69 6e 20 4d 65 6e 75 62 61 72 5c 66 52 0a 54 in Menubar\fR.T
7230: 68 69 73 20 69 73 20 74 68 65 20 6d 6f 73 74 20 his is the most
7240: 63 6f 6d 6d 61 6e 64 20 63 61 73 65 2e 20 59 6f command case. Yo
7250: 75 20 63 72 65 61 74 65 20 61 20 6d 65 6e 75 20 u create a menu
7260: 77 69 64 67 65 74 20 74 68 61 74 20 77 69 6c 6c widget that will
7270: 20 62 65 63 6f 6d 65 20 74 68 65 0a 6d 65 6e 75 become the.menu
7280: 20 62 61 72 2e 20 59 6f 75 20 74 68 65 6e 20 61 bar. You then a
7290: 64 64 20 63 61 73 63 61 64 65 20 65 6e 74 72 69 dd cascade entri
72a0: 65 73 20 74 6f 20 74 68 69 73 20 6d 65 6e 75 2c es to this menu,
72b0: 20 73 70 65 63 69 66 79 69 6e 67 20 74 68 65 0a specifying the.
72c0: 70 75 6c 6c 20 64 6f 77 6e 20 6d 65 6e 75 73 20 pull down menus
72d0: 79 6f 75 20 77 69 73 68 20 74 6f 20 75 73 65 20 you wish to use
72e0: 69 6e 20 79 6f 75 72 20 6d 65 6e 75 20 62 61 72 in your menu bar
72f0: 2e 20 59 6f 75 20 74 68 65 6e 20 63 72 65 61 74 . You then creat
7300: 65 20 61 6c 6c 0a 6f 66 20 74 68 65 20 70 75 6c e all.of the pul
7310: 6c 64 6f 77 6e 73 2e 20 4f 6e 63 65 20 79 6f 75 ldowns. Once you
7320: 20 68 61 76 65 20 64 6f 6e 65 20 74 68 69 73 2c have done this,
7330: 20 73 70 65 63 69 66 79 20 74 68 65 20 6d 65 6e specify the men
7340: 75 20 75 73 69 6e 67 20 74 68 65 0a 5c 66 42 5c u using the.\fB\
7350: 2d 6d 65 6e 75 5c 66 52 20 6f 70 74 69 6f 6e 20 -menu\fR option
7360: 6f 66 20 74 68 65 20 74 6f 70 6c 65 76 65 6c 27 of the toplevel'
7370: 73 20 77 69 64 67 65 74 20 63 6f 6d 6d 61 6e 64 s widget command
7380: 2e 20 53 65 65 20 74 68 65 0a 5c 66 42 74 6f 70 . See the.\fBtop
7390: 6c 65 76 65 6c 5c 66 52 20 6d 61 6e 75 61 6c 20 level\fR manual
73a0: 65 6e 74 72 79 20 66 6f 72 20 64 65 74 61 69 6c entry for detail
73b0: 73 2e 0a 2e 56 45 0a 2e 54 50 0a 5c 66 42 50 75 s...VE..TP.\fBPu
73c0: 6c 6c 64 6f 77 6e 20 4d 65 6e 75 73 20 69 6e 20 lldown Menus in
73d0: 4d 65 6e 75 20 42 75 74 74 6f 6e 73 5c 66 52 0a Menu Buttons\fR.
73e0: 54 68 69 73 20 69 73 20 74 68 65 20 63 6f 6d 70 This is the comp
73f0: 61 74 69 62 6c 65 20 77 61 79 20 74 6f 20 64 6f atible way to do
7400: 20 6d 65 6e 75 20 62 61 72 73 2e 20 20 59 6f 75 menu bars. You
7410: 20 63 72 65 61 74 65 20 6f 6e 65 20 6d 65 6e 75 create one menu
7420: 62 75 74 74 6f 6e 0a 77 69 64 67 65 74 20 66 6f button.widget fo
7430: 72 20 65 61 63 68 20 74 6f 70 2d 6c 65 76 65 6c r each top-level
7440: 20 6d 65 6e 75 2c 20 61 6e 64 20 74 79 70 69 63 menu, and typic
7450: 61 6c 6c 79 20 79 6f 75 20 61 72 72 61 6e 67 65 ally you arrange
7460: 20 61 20 73 65 72 69 65 73 20 6f 66 0a 6d 65 6e a series of.men
7470: 75 62 75 74 74 6f 6e 73 20 69 6e 20 61 20 72 6f ubuttons in a ro
7480: 77 20 69 6e 20 61 20 6d 65 6e 75 62 61 72 20 77 w in a menubar w
7490: 69 6e 64 6f 77 2e 20 20 59 6f 75 20 61 6c 73 6f indow. You also
74a0: 20 63 72 65 61 74 65 20 74 68 65 20 74 6f 70 2d create the top-
74b0: 6c 65 76 65 6c 20 6d 65 6e 75 73 0a 61 6e 64 20 level menus.and
74c0: 61 6e 79 20 63 61 73 63 61 64 65 64 20 73 75 62 any cascaded sub
74d0: 6d 65 6e 75 73 2c 20 61 6e 64 20 74 69 65 20 74 menus, and tie t
74e0: 68 65 6d 20 74 6f 67 65 74 68 65 72 20 77 69 74 hem together wit
74f0: 68 20 5c 66 42 5c 2d 6d 65 6e 75 5c 66 52 0a 6f h \fB\-menu\fR.o
7500: 70 74 69 6f 6e 73 20 69 6e 20 6d 65 6e 75 62 75 ptions in menubu
7510: 74 74 6f 6e 73 20 61 6e 64 20 63 61 73 63 61 64 ttons and cascad
7520: 65 20 6d 65 6e 75 20 65 6e 74 72 69 65 73 2e 20 e menu entries.
7530: 20 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 6d The top-level m
7540: 65 6e 75 20 6d 75 73 74 0a 62 65 20 61 20 63 68 enu must.be a ch
7550: 69 6c 64 20 6f 66 20 74 68 65 20 6d 65 6e 75 62 ild of the menub
7560: 75 74 74 6f 6e 2c 20 61 6e 64 20 65 61 63 68 20 utton, and each
7570: 73 75 62 6d 65 6e 75 20 6d 75 73 74 20 62 65 20 submenu must be
7580: 61 20 63 68 69 6c 64 20 6f 66 20 74 68 65 0a 6d a child of the.m
7590: 65 6e 75 20 74 68 61 74 20 72 65 66 65 72 73 20 enu that refers
75a0: 74 6f 20 69 74 2e 20 20 4f 6e 63 65 20 79 6f 75 to it. Once you
75b0: 20 68 61 76 65 20 64 6f 6e 65 20 74 68 69 73 2c have done this,
75c0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 69 6e the default bin
75d0: 64 69 6e 67 73 0a 77 69 6c 6c 20 61 6c 6c 6f 77 dings.will allow
75e0: 20 75 73 65 72 73 20 74 6f 20 74 72 61 76 65 72 users to traver
75f0: 73 65 20 61 6e 64 20 69 6e 76 6f 6b 65 20 74 68 se and invoke th
7600: 65 20 74 72 65 65 20 6f 66 20 6d 65 6e 75 73 20 e tree of menus
7610: 76 69 61 20 69 74 73 0a 6d 65 6e 75 62 75 74 74 via its.menubutt
7620: 6f 6e 3b 20 20 73 65 65 20 74 68 65 20 5c 66 42 on; see the \fB
7630: 6d 65 6e 75 62 75 74 74 6f 6e 5c 66 52 20 6d 61 menubutton\fR ma
7640: 6e 75 61 6c 20 65 6e 74 72 79 20 66 6f 72 20 64 nual entry for d
7650: 65 74 61 69 6c 73 2e 0a 2e 54 50 0a 5c 66 42 50 etails...TP.\fBP
7660: 6f 70 75 70 20 4d 65 6e 75 73 5c 66 52 0a 50 6f opup Menus\fR.Po
7670: 70 75 70 20 6d 65 6e 75 73 20 74 79 70 69 63 61 pup menus typica
7680: 6c 6c 79 20 70 6f 73 74 20 69 6e 20 72 65 73 70 lly post in resp
7690: 6f 6e 73 65 20 74 6f 20 61 20 6d 6f 75 73 65 20 onse to a mouse
76a0: 62 75 74 74 6f 6e 20 70 72 65 73 73 20 6f 72 0a button press or.
76b0: 6b 65 79 73 74 72 6f 6b 65 2e 20 20 59 6f 75 20 keystroke. You
76c0: 63 72 65 61 74 65 20 74 68 65 20 70 6f 70 75 70 create the popup
76d0: 20 6d 65 6e 75 73 20 61 6e 64 20 61 6e 79 20 63 menus and any c
76e0: 61 73 63 61 64 65 64 20 73 75 62 6d 65 6e 75 73 ascaded submenus
76f0: 2c 0a 74 68 65 6e 20 79 6f 75 20 63 61 6c 6c 20 ,.then you call
7700: 74 68 65 20 5c 66 42 74 6b 5f 70 6f 70 75 70 5c the \fBtk_popup\
7710: 66 52 20 70 72 6f 63 65 64 75 72 65 20 61 74 20 fR procedure at
7720: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 the appropriate
7730: 74 69 6d 65 0a 74 6f 20 70 6f 73 74 20 74 68 65 time.to post the
7740: 20 74 6f 70 2d 6c 65 76 65 6c 20 6d 65 6e 75 2e top-level menu.
7750: 0a 2e 54 50 0a 5c 66 42 4f 70 74 69 6f 6e 20 4d ..TP.\fBOption M
7760: 65 6e 75 73 5c 66 52 0a 41 6e 20 6f 70 74 69 6f enus\fR.An optio
7770: 6e 20 6d 65 6e 75 20 63 6f 6e 73 69 73 74 73 20 n menu consists
7780: 6f 66 20 61 20 6d 65 6e 75 62 75 74 74 6f 6e 20 of a menubutton
7790: 77 69 74 68 20 61 6e 20 61 73 73 6f 63 69 61 74 with an associat
77a0: 65 64 20 6d 65 6e 75 0a 74 68 61 74 20 61 6c 6c ed menu.that all
77b0: 6f 77 73 20 79 6f 75 20 74 6f 20 73 65 6c 65 63 ows you to selec
77c0: 74 20 6f 6e 65 20 6f 66 20 73 65 76 65 72 61 6c t one of several
77d0: 20 76 61 6c 75 65 73 2e 20 20 54 68 65 20 63 75 values. The cu
77e0: 72 72 65 6e 74 20 76 61 6c 75 65 0a 69 73 20 64 rrent value.is d
77f0: 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 20 isplayed in the
7800: 6d 65 6e 75 62 75 74 74 6f 6e 20 61 6e 64 20 69 menubutton and i
7810: 73 20 61 6c 73 6f 20 73 74 6f 72 65 64 20 69 6e s also stored in
7820: 20 61 20 67 6c 6f 62 61 6c 0a 76 61 72 69 61 62 a global.variab
7830: 6c 65 2e 20 20 55 73 65 20 74 68 65 20 5c 66 42 le. Use the \fB
7840: 74 6b 5f 6f 70 74 69 6f 6e 4d 65 6e 75 5c 66 52 tk_optionMenu\fR
7850: 20 70 72 6f 63 65 64 75 72 65 20 74 6f 20 63 72 procedure to cr
7860: 65 61 74 65 20 6f 70 74 69 6f 6e 0a 6d 65 6e 75 eate option.menu
7870: 62 75 74 74 6f 6e 73 20 61 6e 64 20 74 68 65 69 buttons and thei
7880: 72 20 6d 65 6e 75 73 2e 0a 2e 54 50 0a 5c 66 42 r menus...TP.\fB
7890: 54 6f 72 6e 2d 6f 66 66 20 4d 65 6e 75 73 5c 66 Torn-off Menus\f
78a0: 52 0a 59 6f 75 20 63 72 65 61 74 65 20 61 20 74 R.You create a t
78b0: 6f 72 6e 2d 6f 66 66 20 6d 65 6e 75 20 62 79 20 orn-off menu by
78c0: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 74 65 61 invoking the tea
78d0: 72 2d 6f 66 66 20 65 6e 74 72 79 20 61 74 0a 74 r-off entry at.t
78e0: 68 65 20 74 6f 70 20 6f 66 20 61 6e 20 65 78 69 he top of an exi
78f0: 73 74 69 6e 67 20 6d 65 6e 75 2e 20 20 54 68 65 sting menu. The
7900: 20 64 65 66 61 75 6c 74 20 62 69 6e 64 69 6e 67 default binding
7910: 73 20 77 69 6c 6c 20 63 72 65 61 74 65 20 61 20 s will create a
7920: 6e 65 77 20 6d 65 6e 75 0a 74 68 61 74 20 69 73 new menu.that is
7930: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 6f a copy of the o
7940: 72 69 67 69 6e 61 6c 20 6d 65 6e 75 20 61 6e 64 riginal menu and
7950: 20 6c 65 61 76 65 20 69 74 20 70 65 72 6d 61 6e leave it perman
7960: 65 6e 74 6c 79 0a 70 6f 73 74 65 64 20 61 73 20 ently.posted as
7970: 61 20 74 6f 70 2d 6c 65 76 65 6c 20 77 69 6e 64 a top-level wind
7980: 6f 77 2e 20 20 54 68 65 20 74 6f 72 6e 2d 6f 66 ow. The torn-of
7990: 66 20 6d 65 6e 75 20 62 65 68 61 76 65 73 20 6a f menu behaves j
79a0: 75 73 74 0a 74 68 65 20 73 61 6d 65 20 61 73 20 ust.the same as
79b0: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 6d 65 6e the original men
79c0: 75 2e 0a 0a 2e 53 48 20 22 44 45 46 41 55 4c 54 u....SH "DEFAULT
79d0: 20 42 49 4e 44 49 4e 47 53 22 0a 2e 50 50 0a 54 BINDINGS"..PP.T
79e0: 6b 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 k automatically
79f0: 63 72 65 61 74 65 73 20 63 6c 61 73 73 20 62 69 creates class bi
7a00: 6e 64 69 6e 67 73 20 66 6f 72 20 6d 65 6e 75 73 ndings for menus
7a10: 20 74 68 61 74 20 67 69 76 65 20 74 68 65 6d 0a that give them.
7a20: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 64 65 the following de
7a30: 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 3a 0a fault behavior:.
7a40: 2e 49 50 20 5b 31 5d 0a 57 68 65 6e 20 74 68 65 .IP [1].When the
7a50: 20 6d 6f 75 73 65 20 65 6e 74 65 72 73 20 61 20 mouse enters a
7a60: 6d 65 6e 75 2c 20 74 68 65 20 65 6e 74 72 79 20 menu, the entry
7a70: 75 6e 64 65 72 6e 65 61 74 68 20 74 68 65 20 6d underneath the m
7a80: 6f 75 73 65 0a 63 75 72 73 6f 72 20 61 63 74 69 ouse.cursor acti
7a90: 76 61 74 65 73 3b 20 20 61 73 20 74 68 65 20 6d vates; as the m
7aa0: 6f 75 73 65 20 6d 6f 76 65 73 20 61 72 6f 75 6e ouse moves aroun
7ab0: 64 20 74 68 65 20 6d 65 6e 75 2c 20 74 68 65 20 d the menu, the
7ac0: 61 63 74 69 76 65 0a 65 6e 74 72 79 20 63 68 61 active.entry cha
7ad0: 6e 67 65 73 20 74 6f 20 74 72 61 63 6b 20 74 68 nges to track th
7ae0: 65 20 6d 6f 75 73 65 2e 0a 2e 49 50 20 5b 32 5d e mouse...IP [2]
7af0: 0a 57 68 65 6e 20 74 68 65 20 6d 6f 75 73 65 20 .When the mouse
7b00: 6c 65 61 76 65 73 20 61 20 6d 65 6e 75 20 61 6c leaves a menu al
7b10: 6c 20 6f 66 20 74 68 65 20 65 6e 74 72 69 65 73 l of the entries
7b20: 20 69 6e 20 74 68 65 20 6d 65 6e 75 0a 64 65 61 in the menu.dea
7b30: 63 74 69 76 61 74 65 2c 20 65 78 63 65 70 74 20 ctivate, except
7b40: 69 6e 20 74 68 65 20 73 70 65 63 69 61 6c 20 63 in the special c
7b50: 61 73 65 20 77 68 65 72 65 20 74 68 65 20 6d 6f ase where the mo
7b60: 75 73 65 20 6d 6f 76 65 73 20 66 72 6f 6d 0a 61 use moves from.a
7b70: 20 6d 65 6e 75 20 74 6f 20 61 20 63 61 73 63 61 menu to a casca
7b80: 64 65 64 20 73 75 62 6d 65 6e 75 2e 0a 2e 49 50 ded submenu...IP
7b90: 20 5b 33 5d 0a 57 68 65 6e 20 61 20 62 75 74 74 [3].When a butt
7ba0: 6f 6e 20 69 73 20 72 65 6c 65 61 73 65 64 20 6f on is released o
7bb0: 76 65 72 20 61 20 6d 65 6e 75 2c 20 74 68 65 20 ver a menu, the
7bc0: 61 63 74 69 76 65 20 65 6e 74 72 79 20 28 69 66 active entry (if
7bd0: 20 61 6e 79 29 20 69 73 20 69 6e 76 6f 6b 65 64 any) is invoked
7be0: 2e 0a 54 68 65 20 6d 65 6e 75 20 61 6c 73 6f 20 ..The menu also
7bf0: 75 6e 70 6f 73 74 73 20 75 6e 6c 65 73 73 20 69 unposts unless i
7c00: 74 20 69 73 20 61 20 74 6f 72 6e 2d 6f 66 66 20 t is a torn-off
7c10: 6d 65 6e 75 2e 0a 2e 49 50 20 5b 34 5d 0a 54 68 menu...IP [4].Th
7c20: 65 20 53 70 61 63 65 20 61 6e 64 20 52 65 74 75 e Space and Retu
7c30: 72 6e 20 6b 65 79 73 20 69 6e 76 6f 6b 65 20 74 rn keys invoke t
7c40: 68 65 20 61 63 74 69 76 65 20 65 6e 74 72 79 20 he active entry
7c50: 61 6e 64 0a 75 6e 70 6f 73 74 20 74 68 65 20 6d and.unpost the m
7c60: 65 6e 75 2e 0a 2e 49 50 20 5b 35 5d 0a 49 66 20 enu...IP [5].If
7c70: 61 6e 79 20 6f 66 20 74 68 65 20 65 6e 74 72 69 any of the entri
7c80: 65 73 20 69 6e 20 61 20 6d 65 6e 75 20 68 61 76 es in a menu hav
7c90: 65 20 6c 65 74 74 65 72 73 20 75 6e 64 65 72 6c e letters underl
7ca0: 69 6e 65 64 20 77 69 74 68 0a 74 68 65 20 5c 66 ined with.the \f
7cb0: 42 5c 2d 75 6e 64 65 72 6c 69 6e 65 5c 66 52 20 B\-underline\fR
7cc0: 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 70 72 65 option, then pre
7cd0: 73 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 ssing one of the
7ce0: 20 75 6e 64 65 72 6c 69 6e 65 64 0a 6c 65 74 74 underlined.lett
7cf0: 65 72 73 20 28 6f 72 20 69 74 73 20 75 70 70 65 ers (or its uppe
7d00: 72 2d 63 61 73 65 20 6f 72 20 6c 6f 77 65 72 2d r-case or lower-
7d10: 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 29 case equivalent)
7d20: 20 69 6e 76 6f 6b 65 73 20 74 68 61 74 0a 65 6e invokes that.en
7d30: 74 72 79 20 61 6e 64 20 75 6e 70 6f 73 74 73 20 try and unposts
7d40: 74 68 65 20 6d 65 6e 75 2e 0a 2e 49 50 20 5b 36 the menu...IP [6
7d50: 5d 0a 54 68 65 20 45 73 63 61 70 65 20 6b 65 79 ].The Escape key
7d60: 20 61 62 6f 72 74 73 20 61 20 6d 65 6e 75 20 73 aborts a menu s
7d70: 65 6c 65 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 election in prog
7d80: 72 65 73 73 20 77 69 74 68 6f 75 74 20 69 6e 76 ress without inv
7d90: 6f 6b 69 6e 67 20 61 6e 79 0a 65 6e 74 72 79 2e oking any.entry.
7da0: 20 20 49 74 20 61 6c 73 6f 20 75 6e 70 6f 73 74 It also unpost
7db0: 73 20 74 68 65 20 6d 65 6e 75 20 75 6e 6c 65 73 s the menu unles
7dc0: 73 20 69 74 20 69 73 20 61 20 74 6f 72 6e 2d 6f s it is a torn-o
7dd0: 66 66 20 6d 65 6e 75 2e 0a 2e 49 50 20 5b 37 5d ff menu...IP [7]
7de0: 0a 54 68 65 20 55 70 20 61 6e 64 20 44 6f 77 6e .The Up and Down
7df0: 20 6b 65 79 73 20 61 63 74 69 76 61 74 65 20 74 keys activate t
7e00: 68 65 20 6e 65 78 74 20 68 69 67 68 65 72 20 6f he next higher o
7e10: 72 20 6c 6f 77 65 72 20 65 6e 74 72 79 0a 69 6e r lower entry.in
7e20: 20 74 68 65 20 6d 65 6e 75 2e 20 20 57 68 65 6e the menu. When
7e30: 20 6f 6e 65 20 65 6e 64 20 6f 66 20 74 68 65 20 one end of the
7e40: 6d 65 6e 75 20 69 73 20 72 65 61 63 68 65 64 2c menu is reached,
7e50: 20 74 68 65 20 61 63 74 69 76 65 0a 65 6e 74 72 the active.entr
7e60: 79 20 77 72 61 70 73 20 61 72 6f 75 6e 64 20 74 y wraps around t
7e70: 6f 20 74 68 65 20 6f 74 68 65 72 20 65 6e 64 2e o the other end.
7e80: 0a 2e 49 50 20 5b 38 5d 0a 54 68 65 20 4c 65 66 ..IP [8].The Lef
7e90: 74 20 6b 65 79 20 6d 6f 76 65 73 20 74 6f 20 74 t key moves to t
7ea0: 68 65 20 6e 65 78 74 20 6d 65 6e 75 20 74 6f 20 he next menu to
7eb0: 74 68 65 20 6c 65 66 74 2e 0a 49 66 20 74 68 65 the left..If the
7ec0: 20 63 75 72 72 65 6e 74 20 6d 65 6e 75 20 69 73 current menu is
7ed0: 20 61 20 63 61 73 63 61 64 65 64 20 73 75 62 6d a cascaded subm
7ee0: 65 6e 75 2c 20 74 68 65 6e 20 74 68 65 20 73 75 enu, then the su
7ef0: 62 6d 65 6e 75 20 69 73 0a 75 6e 70 6f 73 74 65 bmenu is.unposte
7f00: 64 20 61 6e 64 20 74 68 65 20 63 75 72 72 65 6e d and the curren
7f10: 74 20 6d 65 6e 75 20 65 6e 74 72 79 20 62 65 63 t menu entry bec
7f20: 6f 6d 65 73 20 74 68 65 20 63 61 73 63 61 64 65 omes the cascade
7f30: 20 65 6e 74 72 79 0a 69 6e 20 74 68 65 20 70 61 entry.in the pa
7f40: 72 65 6e 74 2e 0a 49 66 20 74 68 65 20 63 75 72 rent..If the cur
7f50: 72 65 6e 74 20 6d 65 6e 75 20 69 73 20 61 20 74 rent menu is a t
7f60: 6f 70 2d 6c 65 76 65 6c 20 6d 65 6e 75 20 70 6f op-level menu po
7f70: 73 74 65 64 20 66 72 6f 6d 20 61 0a 6d 65 6e 75 sted from a.menu
7f80: 62 75 74 74 6f 6e 2c 20 74 68 65 6e 20 74 68 65 button, then the
7f90: 20 63 75 72 72 65 6e 74 20 6d 65 6e 75 62 75 74 current menubut
7fa0: 74 6f 6e 20 69 73 20 75 6e 70 6f 73 74 65 64 20 ton is unposted
7fb0: 61 6e 64 20 74 68 65 0a 6e 65 78 74 20 6d 65 6e and the.next men
7fc0: 75 62 75 74 74 6f 6e 20 74 6f 20 74 68 65 20 6c ubutton to the l
7fd0: 65 66 74 20 69 73 20 70 6f 73 74 65 64 2e 0a 4f eft is posted..O
7fe0: 74 68 65 72 77 69 73 65 20 74 68 65 20 6b 65 79 therwise the key
7ff0: 20 68 61 73 20 6e 6f 20 65 66 66 65 63 74 2e 0a has no effect..
8000: 54 68 65 20 6c 65 66 74 2d 72 69 67 68 74 20 6f The left-right o
8010: 72 64 65 72 20 6f 66 20 6d 65 6e 75 62 75 74 74 rder of menubutt
8020: 6f 6e 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 ons is determine
8030: 64 20 62 79 20 74 68 65 69 72 20 73 74 61 63 6b d by their stack
8040: 69 6e 67 0a 6f 72 64 65 72 3a 20 20 54 6b 20 61 ing.order: Tk a
8050: 73 73 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 ssumes that the
8060: 6c 6f 77 65 73 74 20 6d 65 6e 75 62 75 74 74 6f lowest menubutto
8070: 6e 20 28 77 68 69 63 68 20 62 79 20 64 65 66 61 n (which by defa
8080: 75 6c 74 0a 69 73 20 74 68 65 20 66 69 72 73 74 ult.is the first
8090: 20 6f 6e 65 20 63 72 65 61 74 65 64 29 20 69 73 one created) is
80a0: 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e 0a 2e 49 on the left...I
80b0: 50 20 5b 39 5d 0a 54 68 65 20 52 69 67 68 74 20 P [9].The Right
80c0: 6b 65 79 20 6d 6f 76 65 73 20 74 6f 20 74 68 65 key moves to the
80d0: 20 6e 65 78 74 20 6d 65 6e 75 20 74 6f 20 74 68 next menu to th
80e0: 65 20 72 69 67 68 74 2e 0a 49 66 20 74 68 65 20 e right..If the
80f0: 63 75 72 72 65 6e 74 20 65 6e 74 72 79 20 69 73 current entry is
8100: 20 61 20 63 61 73 63 61 64 65 20 65 6e 74 72 79 a cascade entry
8110: 2c 20 74 68 65 6e 20 74 68 65 20 73 75 62 6d 65 , then the subme
8120: 6e 75 20 69 73 0a 70 6f 73 74 65 64 20 61 6e 64 nu is.posted and
8130: 20 74 68 65 20 20 63 75 72 72 65 6e 74 20 6d 65 the current me
8140: 6e 75 20 65 6e 74 72 79 20 62 65 63 6f 6d 65 73 nu entry becomes
8150: 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 the first entry
8160: 0a 69 6e 20 74 68 65 20 73 75 62 6d 65 6e 75 2e .in the submenu.
8170: 0a 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 .Otherwise, if t
8180: 68 65 20 63 75 72 72 65 6e 74 20 6d 65 6e 75 20 he current menu
8190: 77 61 73 20 70 6f 73 74 65 64 20 66 72 6f 6d 20 was posted from
81a0: 61 0a 6d 65 6e 75 62 75 74 74 6f 6e 2c 20 74 68 a.menubutton, th
81b0: 65 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d en the current m
81c0: 65 6e 75 62 75 74 74 6f 6e 20 69 73 20 75 6e 70 enubutton is unp
81d0: 6f 73 74 65 64 20 61 6e 64 20 74 68 65 0a 6e 65 osted and the.ne
81e0: 78 74 20 6d 65 6e 75 62 75 74 74 6f 6e 20 74 6f xt menubutton to
81f0: 20 74 68 65 20 72 69 67 68 74 20 69 73 20 70 6f the right is po
8200: 73 74 65 64 2e 0a 2e 50 50 0a 44 69 73 61 62 6c sted...PP.Disabl
8210: 65 64 20 6d 65 6e 75 20 65 6e 74 72 69 65 73 20 ed menu entries
8220: 61 72 65 20 6e 6f 6e 2d 72 65 73 70 6f 6e 73 69 are non-responsi
8230: 76 65 3a 20 20 74 68 65 79 20 64 6f 6e 27 74 20 ve: they don't
8240: 61 63 74 69 76 61 74 65 20 61 6e 64 0a 74 68 65 activate and.the
8250: 79 20 69 67 6e 6f 72 65 20 6d 6f 75 73 65 20 62 y ignore mouse b
8260: 75 74 74 6f 6e 20 70 72 65 73 73 65 73 20 61 6e utton presses an
8270: 64 20 72 65 6c 65 61 73 65 73 2e 0a 2e 50 50 0a d releases...PP.
8280: 2e 56 53 20 38 2e 34 0a 53 65 76 65 72 61 6c 20 .VS 8.4.Several
8290: 6f 66 20 74 68 65 20 62 69 6e 64 69 6e 67 73 20 of the bindings
82a0: 6d 61 6b 65 20 75 73 65 20 6f 66 20 74 68 65 20 make use of the
82b0: 63 6f 6d 6d 61 6e 64 20 5c 66 42 74 6b 5f 6d 65 command \fBtk_me
82c0: 6e 75 53 65 74 46 6f 63 75 73 5c 66 52 2e 0a 49 nuSetFocus\fR..I
82d0: 74 20 73 61 76 65 73 20 74 68 65 20 63 75 72 72 t saves the curr
82e0: 65 6e 74 20 66 6f 63 75 73 20 61 6e 64 20 73 65 ent focus and se
82f0: 74 73 20 74 68 65 20 66 6f 63 75 73 20 74 6f 20 ts the focus to
8300: 69 74 73 20 5c 66 49 70 61 74 68 4e 61 6d 65 5c its \fIpathName\
8310: 66 52 0a 61 72 67 75 6d 65 6e 74 2c 20 77 68 69 fR.argument, whi
8320: 63 68 20 69 73 20 61 20 6d 65 6e 75 20 77 69 64 ch is a menu wid
8330: 67 65 74 2e 0a 2e 56 45 0a 2e 50 50 0a 54 68 65 get...VE..PP.The
8340: 20 62 65 68 61 76 69 6f 72 20 6f 66 20 6d 65 6e behavior of men
8350: 75 73 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 us can be change
8360: 64 20 62 79 20 64 65 66 69 6e 69 6e 67 20 6e 65 d by defining ne
8370: 77 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 0a 69 w bindings for.i
8380: 6e 64 69 76 69 64 75 61 6c 20 77 69 64 67 65 74 ndividual widget
8390: 73 20 6f 72 20 62 79 20 72 65 64 65 66 69 6e 69 s or by redefini
83a0: 6e 67 20 74 68 65 20 63 6c 61 73 73 20 62 69 6e ng the class bin
83b0: 64 69 6e 67 73 2e 0a 0a 2e 53 48 20 42 55 47 53 dings....SH BUGS
83c0: 0a 2e 50 50 0a 41 74 20 70 72 65 73 65 6e 74 20 ..PP.At present
83d0: 69 74 20 69 73 6e 27 74 20 70 6f 73 73 69 62 6c it isn't possibl
83e0: 65 20 74 6f 20 75 73 65 20 74 68 65 0a 6f 70 74 e to use the.opt
83f0: 69 6f 6e 20 64 61 74 61 62 61 73 65 20 74 6f 20 ion database to
8400: 73 70 65 63 69 66 79 20 76 61 6c 75 65 73 20 66 specify values f
8410: 6f 72 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 74 or the options t
8420: 6f 20 69 6e 64 69 76 69 64 75 61 6c 0a 65 6e 74 o individual.ent
8430: 72 69 65 73 2e 0a 0a 2e 53 48 20 4b 45 59 57 4f ries....SH KEYWO
8440: 52 44 53 0a 6d 65 6e 75 2c 20 77 69 64 67 65 74 RDS.menu, widget
8450: 0a .
