/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib2 / macui / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 6d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d module| \sectco|
|00000020| 64 65 7b 45 61 73 79 44 | 69 61 6c 6f 67 73 7d 7d |de{EasyD|ialogs}}|
|00000030| 0a 5c 73 74 6d 6f 64 69 | 6e 64 65 78 7b 45 61 73 |.\stmodi|ndex{Eas|
|00000040| 79 44 69 61 6c 6f 67 73 | 7d 0a 0a 54 68 65 20 5c |yDialogs|}..The \|
|00000050| 63 6f 64 65 7b 45 61 73 | 79 44 69 61 6c 6f 67 73 |code{Eas|yDialogs|
|00000060| 7d 20 6d 6f 64 75 6c 65 | 20 63 6f 6e 74 61 69 6e |} module| contain|
|00000070| 73 20 73 6f 6d 65 20 73 | 69 6d 70 6c 65 20 64 69 |s some s|imple di|
|00000080| 61 6c 6f 67 73 20 66 6f | 72 0a 74 68 65 20 4d 61 |alogs fo|r.the Ma|
|00000090| 63 69 6e 74 6f 73 68 2c | 20 6d 6f 64 65 6c 6c 65 |cintosh,| modelle|
|000000a0| 64 20 61 66 74 65 72 20 | 74 68 65 20 5c 63 6f 64 |d after |the \cod|
|000000b0| 65 7b 73 74 64 77 69 6e | 7d 20 64 69 61 6c 6f 67 |e{stdwin|} dialog|
|000000c0| 73 20 77 69 74 68 20 73 | 69 6d 69 6c 61 72 0a 6e |s with s|imilar.n|
|000000d0| 61 6d 65 73 2e 0a 0a 54 | 68 65 20 5c 63 6f 64 65 |ames...T|he \code|
|000000e0| 7b 45 61 73 79 44 69 61 | 6c 6f 67 73 7d 20 6d 6f |{EasyDia|logs} mo|
|000000f0| 64 75 6c 65 20 64 65 66 | 69 6e 65 73 20 74 68 65 |dule def|ines the|
|00000100| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 66 75 6e 63 74 | followi|ng funct|
|00000110| 69 6f 6e 73 3a 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |ions:..\|renewcom|
|00000120| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000130| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 45 |em}{(in |module E|
|00000140| 61 73 79 44 69 61 6c 6f | 67 73 29 7d 0a 0a 5c 62 |asyDialo|gs)}..\b|
|00000150| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 4d |egin{fun|cdesc}{M|
|00000160| 65 73 73 61 67 65 7d 7b | 73 74 72 7d 0a 41 20 6d |essage}{|str}.A m|
|00000170| 6f 64 61 6c 20 64 69 61 | 6c 6f 67 20 77 69 74 68 |odal dia|log with|
|00000180| 20 74 68 65 20 6d 65 73 | 73 61 67 65 20 74 65 78 | the mes|sage tex|
|00000190| 74 20 5c 76 61 72 7b 73 | 74 72 7d 2c 20 77 68 69 |t \var{s|tr}, whi|
|000001a0| 63 68 20 73 68 6f 75 6c | 64 20 62 65 20 61 74 0a |ch shoul|d be at.|
|000001b0| 6d 6f 73 74 20 32 35 35 | 20 63 68 61 72 61 63 74 |most 255| charact|
|000001c0| 65 72 73 20 6c 6f 6e 67 | 2c 20 69 73 20 64 69 73 |ers long|, is dis|
|000001d0| 70 6c 61 79 65 64 2e 20 | 43 6f 6e 74 72 6f 6c 20 |played. |Control |
|000001e0| 69 73 20 72 65 74 75 72 | 6e 65 64 20 77 68 65 6e |is retur|ned when|
|000001f0| 20 74 68 65 0a 75 73 65 | 72 20 63 6c 69 63 6b 73 | the.use|r clicks|
|00000200| 20 60 60 4f 4b 27 27 2e | 0a 5c 65 6e 64 7b 66 75 | ``OK''.|.\end{fu|
|00000210| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000220| 66 75 6e 63 64 65 73 63 | 7d 7b 41 73 6b 53 74 72 |funcdesc|}{AskStr|
|00000230| 69 6e 67 7d 7b 70 72 6f | 6d 70 74 5c 6f 70 74 69 |ing}{pro|mpt\opti|
|00000240| 6f 6e 61 6c 7b 5c 2c 20 | 64 65 66 61 75 6c 74 7d |onal{\, |default}|
|00000250| 7d 0a 41 73 6b 20 74 68 | 65 20 75 73 65 72 20 74 |}.Ask th|e user t|
|00000260| 6f 20 69 6e 70 75 74 20 | 61 20 73 74 72 69 6e 67 |o input |a string|
|00000270| 20 76 61 6c 75 65 2c 20 | 69 6e 20 61 20 6d 6f 64 | value, |in a mod|
|00000280| 61 6c 20 64 69 61 6c 6f | 67 2e 20 5c 76 61 72 7b |al dialo|g. \var{|
|00000290| 50 72 6f 6d 70 74 7d 0a | 69 73 20 74 68 65 20 70 |Prompt}.|is the p|
|000002a0| 72 6f 6d 74 20 6d 65 73 | 73 61 67 65 2c 20 74 68 |romt mes|sage, th|
|000002b0| 65 20 6f 70 74 69 6f 6e | 61 6c 20 5c 76 61 72 7b |e option|al \var{|
|000002c0| 64 65 66 61 75 6c 74 7d | 20 61 72 67 20 69 73 20 |default}| arg is |
|000002d0| 74 68 65 20 69 6e 69 74 | 69 61 6c 0a 76 61 6c 75 |the init|ial.valu|
|000002e0| 65 20 66 6f 72 20 74 68 | 65 20 73 74 72 69 6e 67 |e for th|e string|
|000002f0| 2e 20 41 6c 6c 20 73 74 | 72 69 6e 67 73 20 63 61 |. All st|rings ca|
|00000300| 6e 20 62 65 20 61 74 20 | 6d 6f 73 74 20 32 35 35 |n be at |most 255|
|00000310| 20 62 79 74 65 73 0a 6c | 6f 6e 67 2e 20 5c 76 61 | bytes.l|ong. \va|
|00000320| 72 7b 41 73 6b 53 74 72 | 69 6e 67 7d 20 72 65 74 |r{AskStr|ing} ret|
|00000330| 75 72 6e 73 20 74 68 65 | 20 73 74 72 69 6e 67 20 |urns the| string |
|00000340| 65 6e 74 65 72 65 64 20 | 6f 72 20 5c 63 6f 64 65 |entered |or \code|
|00000350| 7b 4e 6f 6e 65 7d 20 69 | 6e 0a 63 61 73 65 20 74 |{None} i|n.case t|
|00000360| 68 65 20 75 73 65 72 20 | 63 61 6e 63 65 6c 6c 65 |he user |cancelle|
|00000370| 64 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |d..\end{|funcdesc|
|00000380| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000390| 73 63 7d 7b 41 73 6b 59 | 65 73 4e 6f 43 61 6e 63 |sc}{AskY|esNoCanc|
|000003a0| 65 6c 7d 7b 71 75 65 73 | 74 69 6f 6e 5c 6f 70 74 |el}{ques|tion\opt|
|000003b0| 69 6f 6e 61 6c 7b 5c 2c | 20 64 65 66 61 75 6c 74 |ional{\,| default|
|000003c0| 7d 7d 0a 50 72 65 73 65 | 6e 74 20 61 20 64 69 61 |}}.Prese|nt a dia|
|000003d0| 6c 6f 67 20 77 69 74 68 | 20 74 65 78 74 20 5c 76 |log with| text \v|
|000003e0| 61 72 7b 71 75 65 73 74 | 69 6f 6e 7d 20 61 6e 64 |ar{quest|ion} and|
|000003f0| 20 74 68 72 65 65 20 62 | 75 74 74 6f 6e 73 20 6c | three b|uttons l|
|00000400| 61 62 65 6c 6c 65 64 0a | 60 60 79 65 73 27 27 2c |abelled.|``yes'',|
|00000410| 20 60 60 6e 6f 27 27 20 | 61 6e 64 20 60 60 63 61 | ``no'' |and ``ca|
|00000420| 6e 63 65 6c 27 27 2e 20 | 52 65 74 75 72 6e 20 5c |ncel''. |Return \|
|00000430| 63 6f 64 65 7b 31 7d 20 | 66 6f 72 20 79 65 73 2c |code{1} |for yes,|
|00000440| 20 5c 63 6f 64 65 7b 30 | 7d 20 66 6f 72 0a 6e 6f | \code{0|} for.no|
|00000450| 20 61 6e 64 20 5c 63 6f | 64 65 7b 2d 31 7d 20 66 | and \co|de{-1} f|
|00000460| 6f 72 20 63 61 6e 63 65 | 6c 2e 20 54 68 65 20 64 |or cance|l. The d|
|00000470| 65 66 61 75 6c 74 20 72 | 65 74 75 72 6e 20 76 61 |efault r|eturn va|
|00000480| 6c 75 65 20 63 68 6f 73 | 65 6e 20 62 79 0a 68 69 |lue chos|en by.hi|
|00000490| 74 74 69 6e 67 20 72 65 | 74 75 72 6e 20 69 73 20 |tting re|turn is |
|000004a0| 5c 63 6f 64 65 7b 30 7d | 2e 20 54 68 69 73 20 63 |\code{0}|. This c|
|000004b0| 61 6e 20 62 65 20 63 68 | 61 6e 67 65 64 20 77 69 |an be ch|anged wi|
|000004c0| 74 68 20 74 68 65 20 6f | 70 74 69 6f 6e 61 6c 0a |th the o|ptional.|
|000004d0| 5c 76 61 72 7b 64 65 66 | 61 75 6c 74 7d 20 61 72 |\var{def|ault} ar|
|000004e0| 67 75 6d 65 6e 74 2e 0a | 5c 65 6e 64 7b 66 75 6e |gument..|\end{fun|
|000004f0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000500| 75 6e 63 64 65 73 63 7d | 7b 50 72 6f 67 72 65 73 |uncdesc}|{Progres|
|00000510| 73 42 61 72 7d 7b 5c 6f | 70 74 69 6f 6e 61 6c 7b |sBar}{\o|ptional{|
|00000520| 6c 61 62 65 6c 5c 2c 20 | 6d 61 78 76 61 6c 7d 7d |label\, |maxval}}|
|00000530| 0a 44 69 73 70 6c 61 79 | 20 61 20 6d 6f 64 65 6c |.Display| a model|
|00000540| 65 73 73 20 70 72 6f 67 | 72 65 73 73 20 64 69 61 |ess prog|ress dia|
|00000550| 6c 6f 67 20 77 69 74 68 | 20 61 20 74 68 65 72 6d |log with| a therm|
|00000560| 6f 6d 65 74 65 72 20 62 | 61 72 2e 20 5c 76 61 72 |ometer b|ar. \var|
|00000570| 7b 4c 61 62 65 6c 7d 0a | 69 73 20 74 68 65 20 74 |{Label}.|is the t|
|00000580| 65 78 74 73 74 72 69 6e | 67 20 64 69 73 70 6c 61 |extstrin|g displa|
|00000590| 79 65 64 20 28 64 65 66 | 61 75 6c 74 20 60 60 57 |yed (def|ault ``W|
|000005a0| 6f 72 6b 69 6e 67 2e 2e | 2e 27 27 29 2c 20 5c 76 |orking..|.''), \v|
|000005b0| 61 72 7b 6d 61 78 76 61 | 6c 7d 20 69 73 0a 74 68 |ar{maxva|l} is.th|
|000005c0| 65 20 76 61 6c 75 65 20 | 61 74 20 77 68 69 63 68 |e value |at which|
|000005d0| 20 70 72 6f 67 72 65 73 | 73 20 69 73 20 63 6f 6d | progres|s is com|
|000005e0| 70 6c 65 74 65 20 28 64 | 65 66 61 75 6c 74 20 31 |plete (d|efault 1|
|000005f0| 30 30 29 2e 20 54 68 65 | 20 72 65 74 75 72 6e 65 |00). The| returne|
|00000600| 64 0a 6f 62 6a 65 63 74 | 20 68 61 73 20 6f 6e 65 |d.object| has one|
|00000610| 20 6d 65 74 68 6f 64 2c | 20 5c 63 6f 64 65 7b 73 | method,| \code{s|
|00000620| 65 74 28 76 61 6c 75 65 | 29 7d 2c 20 77 68 69 63 |et(value|)}, whic|
|00000630| 68 20 73 65 74 73 20 74 | 68 65 20 76 61 6c 75 65 |h sets t|he value|
|00000640| 20 6f 66 20 74 68 65 0a | 70 72 6f 67 72 65 73 73 | of the.|progress|
|00000650| 20 62 61 72 2e 20 54 68 | 65 20 62 61 72 20 72 65 | bar. Th|e bar re|
|00000660| 6d 61 69 6e 73 20 76 69 | 73 69 62 6c 65 20 75 6e |mains vi|sible un|
|00000670| 74 69 6c 20 74 68 65 20 | 6f 62 6a 65 63 74 20 72 |til the |object r|
|00000680| 65 74 75 72 6e 65 64 20 | 69 73 0a 64 69 73 63 61 |eturned |is.disca|
|00000690| 72 64 65 64 2e 0a 0a 54 | 68 65 20 70 72 6f 67 72 |rded...T|he progr|
|000006a0| 65 73 73 20 62 61 72 20 | 68 61 73 20 61 20 60 60 |ess bar |has a ``|
|000006b0| 63 61 6e 63 65 6c 27 27 | 20 62 75 74 74 6f 6e 2c |cancel''| button,|
|000006c0| 20 62 75 74 20 69 74 20 | 69 73 20 63 75 72 72 65 | but it |is curre|
|000006d0| 6e 74 6c 79 0a 6e 6f 6e | 2d 66 75 6e 63 74 69 6f |ntly.non|-functio|
|000006e0| 6e 61 6c 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |nal..\en|d{funcde|
|000006f0| 73 63 7d 0a 0a 4e 6f 74 | 65 20 74 68 61 74 20 5c |sc}..Not|e that \|
|00000700| 63 6f 64 65 7b 45 61 73 | 79 44 69 61 6c 6f 67 73 |code{Eas|yDialogs|
|00000710| 7d 20 64 6f 65 73 20 6e | 6f 74 20 63 75 72 72 65 |} does n|ot curre|
|00000720| 6e 74 6c 79 20 75 73 65 | 20 74 68 65 20 6e 6f 74 |ntly use| the not|
|00000730| 69 66 69 63 61 74 69 6f | 6e 0a 6d 61 6e 61 67 65 |ificatio|n.manage|
|00000740| 72 2e 20 54 68 69 73 20 | 6d 65 61 6e 73 20 74 68 |r. This |means th|
|00000750| 61 74 20 64 69 73 70 6c | 61 79 69 6e 67 20 64 69 |at displ|aying di|
|00000760| 61 6c 6f 67 73 20 77 68 | 69 6c 65 20 74 68 65 20 |alogs wh|ile the |
|00000770| 70 72 6f 67 72 61 6d 20 | 69 73 20 69 6e 0a 74 68 |program |is in.th|
|00000780| 65 20 62 61 63 6b 67 72 | 6f 75 6e 64 20 77 69 6c |e backgr|ound wil|
|00000790| 6c 20 6c 65 61 64 20 74 | 6f 20 75 6e 65 78 70 65 |l lead t|o unexpe|
|000007a0| 63 74 65 64 20 72 65 73 | 75 6c 74 73 20 61 6e 64 |cted res|ults and|
|000007b0| 20 70 6f 73 73 69 62 6c | 79 0a 63 72 61 73 68 65 | possibl|y.crashe|
|000007c0| 73 2e 20 41 6c 73 6f 2c | 20 61 6c 6c 20 64 69 61 |s. Also,| all dia|
|000007d0| 6c 6f 67 73 20 61 72 65 | 20 6d 6f 64 65 6c 65 73 |logs are| modeles|
|000007e0| 73 20 61 6e 64 20 68 65 | 6e 63 65 20 65 78 70 65 |s and he|nce expe|
|000007f0| 63 74 20 74 6f 20 62 65 | 20 61 74 20 74 68 65 0a |ct to be| at the.|
|00000800| 74 6f 70 20 6f 66 20 74 | 68 65 20 73 74 61 63 6b |top of t|he stack|
|00000810| 69 6e 67 20 6f 72 64 65 | 72 2e 20 54 68 69 73 20 |ing orde|r. This |
|00000820| 69 73 20 74 72 75 65 20 | 77 68 65 6e 20 74 68 65 |is true |when the|
|00000830| 20 64 69 61 6c 6f 67 73 | 20 61 72 65 20 63 72 65 | dialogs| are cre|
|00000840| 61 74 65 64 2c 0a 62 75 | 74 20 77 69 6e 64 6f 77 |ated,.bu|t window|
|00000850| 73 20 74 68 61 74 20 70 | 6f 70 2d 75 70 20 6c 61 |s that p|op-up la|
|00000860| 74 65 72 20 28 6c 69 6b | 65 20 61 20 63 6f 6e 73 |ter (lik|e a cons|
|00000870| 6f 6c 65 20 77 69 6e 64 | 6f 77 29 20 6d 61 79 20 |ole wind|ow) may |
|00000880| 61 6c 73 6f 20 72 65 73 | 75 6c 74 0a 69 6e 20 63 |also res|ult.in c|
|00000890| 72 61 73 68 65 73 2e 0a | 0a 0a 5c 73 65 63 74 69 |rashes..|..\secti|
|000008a0| 6f 6e 7b 53 74 61 6e 64 | 61 72 64 20 6d 6f 64 75 |on{Stand|ard modu|
|000008b0| 6c 65 20 5c 73 65 63 74 | 63 6f 64 65 7b 46 72 61 |le \sect|code{Fra|
|000008c0| 6d 65 57 6f 72 6b 7d 7d | 0a 5c 73 74 6d 6f 64 69 |meWork}}|.\stmodi|
|000008d0| 6e 64 65 78 7b 46 72 61 | 6d 65 57 6f 72 6b 7d 0a |ndex{Fra|meWork}.|
|000008e0| 0a 54 68 65 20 5c 63 6f | 64 65 7b 46 72 61 6d 65 |.The \co|de{Frame|
|000008f0| 57 6f 72 6b 7d 20 6d 6f | 64 75 6c 65 20 63 6f 6e |Work} mo|dule con|
|00000900| 74 61 69 6e 73 20 63 6c | 61 73 73 65 73 20 74 68 |tains cl|asses th|
|00000910| 61 74 20 74 6f 67 65 74 | 68 65 72 20 70 72 6f 76 |at toget|her prov|
|00000920| 69 64 65 20 61 0a 66 72 | 61 6d 65 77 6f 72 6b 20 |ide a.fr|amework |
|00000930| 66 6f 72 20 61 6e 20 69 | 6e 74 65 72 61 63 74 69 |for an i|nteracti|
|00000940| 76 65 20 4d 61 63 69 6e | 74 6f 73 68 20 61 70 70 |ve Macin|tosh app|
|00000950| 6c 69 63 61 74 69 6f 6e | 2e 20 54 68 65 20 70 72 |lication|. The pr|
|00000960| 6f 67 72 61 6d 6d 65 72 | 0a 62 75 69 6c 64 73 20 |ogrammer|.builds |
|00000970| 61 6e 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 62 |an appli|cation b|
|00000980| 79 20 63 72 65 61 74 69 | 6e 67 20 73 75 62 63 6c |y creati|ng subcl|
|00000990| 61 73 73 65 73 20 74 68 | 61 74 20 6f 76 65 72 72 |asses th|at overr|
|000009a0| 69 64 65 20 76 61 72 69 | 6f 75 73 0a 6d 65 74 68 |ide vari|ous.meth|
|000009b0| 6f 64 73 20 6f 66 20 74 | 68 65 20 62 61 73 65 73 |ods of t|he bases|
|000009c0| 20 63 6c 61 73 73 65 73 | 2c 20 74 68 65 72 65 62 | classes|, thereb|
|000009d0| 79 20 69 6d 70 6c 65 6d | 65 6e 74 69 6e 67 20 74 |y implem|enting t|
|000009e0| 68 65 20 66 75 6e 63 74 | 69 6f 6e 61 6c 69 74 79 |he funct|ionality|
|000009f0| 0a 77 61 6e 74 65 64 2e | 20 4f 76 65 72 72 69 64 |.wanted.| Overrid|
|00000a00| 69 6e 67 20 66 75 6e 63 | 74 69 6f 6e 61 6c 69 74 |ing func|tionalit|
|00000a10| 79 20 63 61 6e 20 6f 66 | 74 65 6e 20 62 65 20 64 |y can of|ten be d|
|00000a20| 6f 6e 65 20 6f 6e 20 76 | 61 72 69 6f 75 73 0a 64 |one on v|arious.d|
|00000a30| 69 66 66 65 72 65 6e 74 | 20 6c 65 76 65 6c 73 2c |ifferent| levels,|
|00000a40| 20 69 2e 65 2e 20 74 6f | 20 68 61 6e 64 6c 65 20 | i.e. to| handle |
|00000a50| 63 6c 69 63 6b 73 20 69 | 6e 20 61 20 73 69 6e 67 |clicks i|n a sing|
|00000a60| 6c 65 20 64 69 61 6c 6f | 67 20 77 69 6e 64 6f 77 |le dialo|g window|
|00000a70| 20 69 6e 20 61 0a 6e 6f | 6e 2d 73 74 61 6e 64 61 | in a.no|n-standa|
|00000a80| 72 64 20 77 61 79 20 69 | 74 20 69 73 20 6e 6f 74 |rd way i|t is not|
|00000a90| 20 6e 65 63 65 73 73 61 | 72 79 20 74 6f 20 6f 76 | necessa|ry to ov|
|00000aa0| 65 72 72 69 64 65 20 74 | 68 65 20 63 6f 6d 70 6c |erride t|he compl|
|00000ab0| 65 74 65 20 65 76 65 6e | 74 0a 68 61 6e 64 6c 69 |ete even|t.handli|
|00000ac0| 6e 67 2e 0a 0a 54 68 65 | 20 5c 63 6f 64 65 7b 46 |ng...The| \code{F|
|00000ad0| 72 61 6d 65 57 6f 72 6b | 7d 20 69 73 20 73 74 69 |rameWork|} is sti|
|00000ae0| 6c 6c 20 76 65 72 79 20 | 6d 75 63 68 20 77 6f 72 |ll very |much wor|
|00000af0| 6b 2d 69 6e 2d 70 72 6f | 67 72 65 73 73 2c 20 61 |k-in-pro|gress, a|
|00000b00| 6e 64 20 74 68 65 0a 64 | 6f 63 75 6d 65 6e 74 61 |nd the.d|ocumenta|
|00000b10| 74 69 6f 6e 20 64 65 73 | 63 72 69 62 65 73 20 6f |tion des|cribes o|
|00000b20| 6e 6c 79 20 74 68 65 20 | 6d 6f 73 74 20 69 6d 70 |nly the |most imp|
|00000b30| 6f 72 74 61 6e 74 20 66 | 75 6e 63 74 69 6f 6e 61 |ortant f|unctiona|
|00000b40| 6c 69 74 79 2c 20 61 6e | 64 20 6e 6f 74 0a 69 6e |lity, an|d not.in|
|00000b50| 20 74 68 65 20 6d 6f 73 | 74 20 6c 6f 67 69 63 61 | the mos|t logica|
|00000b60| 6c 20 6d 61 6e 6e 65 72 | 20 61 74 20 74 68 61 74 |l manner| at that|
|00000b70| 2e 20 45 78 61 6d 69 6e | 65 20 74 68 65 20 73 6f |. Examin|e the so|
|00000b80| 75 72 63 65 20 6f 72 20 | 74 68 65 20 65 78 61 6d |urce or |the exam|
|00000b90| 70 6c 65 73 0a 66 6f 72 | 20 6d 6f 72 65 20 64 65 |ples.for| more de|
|00000ba0| 74 61 69 6c 73 2e 0a 0a | 54 68 65 20 5c 63 6f 64 |tails...|The \cod|
|00000bb0| 65 7b 46 72 61 6d 65 57 | 6f 72 6b 7d 20 6d 6f 64 |e{FrameW|ork} mod|
|00000bc0| 75 6c 65 20 64 65 66 69 | 6e 65 73 20 74 68 65 20 |ule defi|nes the |
|00000bd0| 66 6f 6c 6c 6f 77 69 6e | 67 20 66 75 6e 63 74 69 |followin|g functi|
|00000be0| 6f 6e 73 3a 0a 0a 5c 72 | 65 6e 65 77 63 6f 6d 6d |ons:..\r|enewcomm|
|00000bf0| 61 6e 64 7b 5c 69 6e 64 | 65 78 73 75 62 69 74 65 |and{\ind|exsubite|
|00000c00| 6d 7d 7b 28 69 6e 20 6d | 6f 64 75 6c 65 20 46 72 |m}{(in m|odule Fr|
|00000c10| 61 6d 65 57 6f 72 6b 29 | 7d 0a 0a 5c 62 65 67 69 |ameWork)|}..\begi|
|00000c20| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 41 70 70 6c |n{funcde|sc}{Appl|
|00000c30| 69 63 61 74 69 6f 6e 7d | 7b 7d 0a 41 6e 20 6f 62 |ication}|{}.An ob|
|00000c40| 6a 65 63 74 20 72 65 70 | 72 65 73 65 6e 74 69 6e |ject rep|resentin|
|00000c50| 67 20 74 68 65 20 63 6f | 6d 70 6c 65 74 65 20 61 |g the co|mplete a|
|00000c60| 70 70 6c 69 63 61 74 69 | 6f 6e 2e 20 53 65 65 20 |pplicati|on. See |
|00000c70| 62 65 6c 6f 77 20 66 6f | 72 20 61 0a 64 65 73 63 |below fo|r a.desc|
|00000c80| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 6d |ription |of the m|
|00000c90| 65 74 68 6f 64 73 2e 20 | 54 68 65 20 64 65 66 61 |ethods. |The defa|
|00000ca0| 75 6c 74 20 5c 63 6f 64 | 65 7b 5f 5f 69 6e 69 74 |ult \cod|e{__init|
|00000cb0| 5f 5f 7d 20 72 6f 75 74 | 69 6e 65 0a 63 72 65 61 |__} rout|ine.crea|
|00000cc0| 74 65 73 20 61 6e 20 65 | 6d 70 74 79 20 77 69 6e |tes an e|mpty win|
|00000cd0| 64 6f 77 20 64 69 63 74 | 69 6f 6e 61 72 79 20 61 |dow dict|ionary a|
|00000ce0| 6e 64 20 61 20 6d 65 6e | 75 20 62 61 72 20 77 69 |nd a men|u bar wi|
|00000cf0| 74 68 20 61 6e 20 61 70 | 70 6c 65 20 6d 65 6e 75 |th an ap|ple menu|
|00000d00| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000d10| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000d20| 63 7d 7b 4d 65 6e 75 42 | 61 72 7d 7b 7d 0a 41 6e |c}{MenuB|ar}{}.An|
|00000d30| 20 6f 62 6a 65 63 74 20 | 72 65 70 72 65 73 65 6e | object |represen|
|00000d40| 74 69 6e 67 20 74 68 65 | 20 6d 65 6e 75 62 61 72 |ting the| menubar|
|00000d50| 2e 20 54 68 69 73 20 6f | 62 6a 65 63 74 20 69 73 |. This o|bject is|
|00000d60| 20 75 73 75 61 6c 6c 79 | 20 6e 6f 74 20 63 72 65 | usually| not cre|
|00000d70| 61 74 65 64 0a 62 79 20 | 74 68 65 20 75 73 65 72 |ated.by |the user|
|00000d80| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000d90| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000da0| 63 7d 7b 4d 65 6e 75 7d | 7b 62 61 72 5c 2c 20 74 |c}{Menu}|{bar\, t|
|00000db0| 69 74 6c 65 5c 6f 70 74 | 69 6f 6e 61 6c 7b 5c 2c |itle\opt|ional{\,|
|00000dc0| 20 61 66 74 65 72 7d 7d | 0a 41 6e 20 6f 62 6a 65 | after}}|.An obje|
|00000dd0| 63 74 20 72 65 70 72 65 | 73 65 6e 74 69 6e 67 20 |ct repre|senting |
|00000de0| 61 20 6d 65 6e 75 2e 20 | 55 70 6f 6e 20 63 72 65 |a menu. |Upon cre|
|00000df0| 61 74 69 6f 6e 20 79 6f | 75 20 70 61 73 73 20 74 |ation yo|u pass t|
|00000e00| 68 65 0a 5c 63 6f 64 65 | 7b 4d 65 6e 75 42 61 72 |he.\code|{MenuBar|
|00000e10| 7d 20 74 68 65 20 6d 65 | 6e 75 20 61 70 70 65 61 |} the me|nu appea|
|00000e20| 72 73 20 69 6e 2c 20 74 | 68 65 20 5c 76 61 72 7b |rs in, t|he \var{|
|00000e30| 74 69 74 6c 65 7d 20 73 | 74 72 69 6e 67 20 61 6e |title} s|tring an|
|00000e40| 64 20 61 0a 70 6f 73 69 | 74 69 6f 6e 20 28 31 2d |d a.posi|tion (1-|
|00000e50| 62 61 73 65 64 29 20 5c | 76 61 72 7b 61 66 74 65 |based) \|var{afte|
|00000e60| 72 7d 20 77 68 65 72 65 | 20 74 68 65 20 6d 65 6e |r} where| the men|
|00000e70| 75 20 73 68 6f 75 6c 64 | 20 61 70 70 65 61 72 20 |u should| appear |
|00000e80| 28 64 65 66 61 75 6c 74 | 3a 0a 61 74 20 74 68 65 |(default|:.at the|
|00000e90| 20 65 6e 64 29 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 | end)..\|end{func|
|00000ea0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000eb0| 6e 63 64 65 73 63 7d 7b | 4d 65 6e 75 49 74 65 6d |ncdesc}{|MenuItem|
|00000ec0| 7d 7b 6d 65 6e 75 5c 2c | 20 74 69 74 6c 65 5c 6f |}{menu\,| title\o|
|00000ed0| 70 74 69 6f 6e 61 6c 7b | 5c 2c 20 73 68 6f 72 74 |ptional{|\, short|
|00000ee0| 63 75 74 5c 2c 20 63 61 | 6c 6c 62 61 63 6b 7d 7d |cut\, ca|llback}}|
|00000ef0| 0a 43 72 65 61 74 65 20 | 61 20 6d 65 6e 75 20 69 |.Create |a menu i|
|00000f00| 74 65 6d 20 6f 62 6a 65 | 63 74 2e 20 54 68 65 20 |tem obje|ct. The |
|00000f10| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 74 68 |argument|s are th|
|00000f20| 65 20 6d 65 6e 75 20 74 | 6f 20 63 72 61 74 65 20 |e menu t|o crate |
|00000f30| 74 68 65 0a 69 74 65 6d | 20 69 74 2c 20 74 68 65 |the.item| it, the|
|00000f40| 20 69 74 65 6d 20 74 69 | 74 6c 65 20 73 74 72 69 | item ti|tle stri|
|00000f50| 6e 67 20 61 6e 64 20 6f | 70 74 69 6f 6e 61 6c 6c |ng and o|ptionall|
|00000f60| 79 20 74 68 65 20 6b 65 | 79 62 6f 61 72 64 20 73 |y the ke|yboard s|
|00000f70| 68 6f 72 74 63 75 74 0a | 61 6e 64 20 61 20 63 61 |hortcut.|and a ca|
|00000f80| 6c 6c 62 61 63 6b 20 72 | 6f 75 74 69 6e 65 2e 20 |llback r|outine. |
|00000f90| 54 68 65 20 63 61 6c 6c | 62 61 63 6b 20 69 73 20 |The call|back is |
|00000fa0| 63 61 6c 6c 65 64 20 77 | 69 74 68 20 74 68 65 20 |called w|ith the |
|00000fb0| 61 72 67 75 6d 65 6e 74 | 73 0a 6d 65 6e 75 2d 69 |argument|s.menu-i|
|00000fc0| 64 2c 20 69 74 65 6d 20 | 6e 75 6d 62 65 72 20 77 |d, item |number w|
|00000fd0| 69 74 68 69 6e 20 6d 65 | 6e 75 20 28 31 2d 62 61 |ithin me|nu (1-ba|
|00000fe0| 73 65 64 29 2c 20 63 75 | 72 72 65 6e 74 20 66 72 |sed), cu|rrent fr|
|00000ff0| 6f 6e 74 20 77 69 6e 64 | 6f 77 20 61 6e 64 0a 74 |ont wind|ow and.t|
|00001000| 68 65 20 65 76 65 6e 74 | 20 72 65 63 6f 72 64 2e |he event| record.|
|00001010| 0a 0a 49 6e 20 73 74 65 | 61 64 20 6f 66 20 61 20 |..In ste|ad of a |
|00001020| 63 61 6c 6c 61 62 6c 65 | 20 6f 62 6a 65 63 74 20 |callable| object |
|00001030| 74 68 65 20 63 61 6c 6c | 62 61 63 6b 20 63 61 6e |the call|back can|
|00001040| 20 61 6c 73 6f 20 62 65 | 20 61 20 73 74 72 69 6e | also be| a strin|
|00001050| 67 2e 20 49 6e 0a 74 68 | 69 73 20 63 61 73 65 20 |g. In.th|is case |
|00001060| 6d 65 6e 75 20 73 65 6c | 65 63 74 69 6f 6e 20 63 |menu sel|ection c|
|00001070| 61 75 73 65 73 20 74 68 | 65 20 6c 6f 6f 6b 75 70 |auses th|e lookup|
|00001080| 20 6f 66 20 61 20 6d 65 | 74 68 6f 64 20 69 6e 20 | of a me|thod in |
|00001090| 74 68 65 20 74 6f 70 6d | 6f 73 74 0a 77 69 6e 64 |the topm|ost.wind|
|000010a0| 6f 77 20 61 6e 64 20 74 | 68 65 20 61 70 70 6c 69 |ow and t|he appli|
|000010b0| 63 61 74 69 6f 6e 2e 20 | 54 68 65 20 6d 65 74 68 |cation. |The meth|
|000010c0| 6f 64 20 6e 61 6d 65 20 | 69 73 20 74 68 65 20 63 |od name |is the c|
|000010d0| 61 6c 6c 62 61 63 6b 20 | 73 74 72 69 6e 67 0a 77 |allback |string.w|
|000010e0| 69 74 68 20 5c 63 6f 64 | 65 7b 27 64 6f 6d 65 6e |ith \cod|e{'domen|
|000010f0| 75 5f 27 7d 20 70 72 65 | 70 65 6e 64 65 64 2e 0a |u_'} pre|pended..|
|00001100| 0a 43 61 6c 6c 69 6e 67 | 20 74 68 65 20 5c 63 6f |.Calling| the \co|
|00001110| 64 65 7b 4d 65 6e 75 42 | 61 72 7d 20 5c 63 6f 64 |de{MenuB|ar} \cod|
|00001120| 65 7b 66 69 78 6d 65 6e | 75 64 69 6d 73 74 61 74 |e{fixmen|udimstat|
|00001130| 65 7d 20 6d 65 74 68 6f | 64 20 73 65 74 73 20 74 |e} metho|d sets t|
|00001140| 68 65 0a 63 6f 72 72 65 | 63 74 20 64 69 6d 6d 69 |he.corre|ct dimmi|
|00001150| 6e 67 20 66 6f 72 20 61 | 6c 6c 20 6d 65 6e 75 20 |ng for a|ll menu |
|00001160| 69 74 65 6d 73 20 62 61 | 73 65 64 20 6f 6e 20 74 |items ba|sed on t|
|00001170| 68 65 20 63 75 72 72 65 | 6e 74 20 66 72 6f 6e 74 |he curre|nt front|
|00001180| 20 77 69 6e 64 6f 77 2e | 0a 5c 65 6e 64 7b 66 75 | window.|.\end{fu|
|00001190| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000011a0| 66 75 6e 63 64 65 73 63 | 7d 7b 53 65 70 61 72 61 |funcdesc|}{Separa|
|000011b0| 74 6f 72 7d 7b 6d 65 6e | 75 7d 0a 41 64 64 20 61 |tor}{men|u}.Add a|
|000011c0| 20 73 65 70 61 72 61 74 | 6f 72 20 74 6f 20 74 68 | separat|or to th|
|000011d0| 65 20 65 6e 64 20 6f 66 | 20 61 20 6d 65 6e 75 2e |e end of| a menu.|
|000011e0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|000011f0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001200| 7d 7b 53 75 62 4d 65 6e | 75 7d 7b 6d 65 6e 75 5c |}{SubMen|u}{menu\|
|00001210| 2c 20 6c 61 62 65 6c 7d | 0a 43 72 65 61 74 65 20 |, label}|.Create |
|00001220| 61 20 73 75 62 6d 65 6e | 75 20 6e 61 6d 65 64 20 |a submen|u named |
|00001230| 5c 76 61 72 7b 6c 61 62 | 65 6c 7d 20 75 6e 64 65 |\var{lab|el} unde|
|00001240| 72 20 6d 65 6e 75 20 5c | 76 61 72 7b 6d 65 6e 75 |r menu \|var{menu|
|00001250| 7d 2e 20 54 68 65 20 6d | 65 6e 75 0a 6f 62 6a 65 |}. The m|enu.obje|
|00001260| 63 74 20 69 73 20 72 65 | 74 75 72 6e 65 64 2e 0a |ct is re|turned..|
|00001270| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00001280| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00001290| 7b 57 69 6e 64 6f 77 7d | 7b 70 61 72 65 6e 74 7d |{Window}|{parent}|
|000012a0| 0a 43 72 65 61 74 65 73 | 20 61 20 28 6d 6f 64 65 |.Creates| a (mode|
|000012b0| 6c 65 73 73 29 20 77 69 | 6e 64 6f 77 2e 20 5c 76 |less) wi|ndow. \v|
|000012c0| 61 72 7b 50 61 72 65 6e | 74 7d 20 69 73 20 74 68 |ar{Paren|t} is th|
|000012d0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 6f 62 |e applic|ation ob|
|000012e0| 6a 65 63 74 20 74 6f 0a | 77 68 69 63 68 20 74 68 |ject to.|which th|
|000012f0| 65 20 77 69 6e 64 6f 77 | 20 62 65 6c 6f 6e 67 73 |e window| belongs|
|00001300| 2e 20 54 68 65 20 77 69 | 6e 64 6f 77 20 69 73 20 |. The wi|ndow is |
|00001310| 6e 6f 74 20 64 69 73 70 | 6c 61 79 65 64 20 75 6e |not disp|layed un|
|00001320| 74 69 6c 20 6c 61 74 65 | 72 2e 0a 5c 65 6e 64 7b |til late|r..\end{|
|00001330| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00001340| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 44 69 61 6c |n{funcde|sc}{Dial|
|00001350| 6f 67 57 69 6e 64 6f 77 | 7d 7b 70 61 72 65 6e 74 |ogWindow|}{parent|
|00001360| 7d 0a 43 72 65 61 74 65 | 73 20 61 20 6d 6f 64 65 |}.Create|s a mode|
|00001370| 6c 65 73 73 20 64 69 61 | 6c 6f 67 20 77 69 6e 64 |less dia|log wind|
|00001380| 6f 77 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ow..\end|{funcdes|
|00001390| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|000013a0| 65 73 63 7d 7b 77 69 6e | 64 6f 77 62 6f 75 6e 64 |esc}{win|dowbound|
|000013b0| 73 7d 7b 77 69 64 74 68 | 5c 2c 20 68 65 69 67 68 |s}{width|\, heigh|
|000013c0| 74 7d 0a 52 65 74 75 72 | 6e 20 61 20 5c 63 6f 64 |t}.Retur|n a \cod|
|000013d0| 65 7b 28 6c 65 66 74 2c | 20 74 6f 70 2c 20 72 69 |e{(left,| top, ri|
|000013e0| 67 68 74 2c 20 62 6f 74 | 74 6f 6d 29 7d 20 74 75 |ght, bot|tom)} tu|
|000013f0| 70 6c 65 20 73 75 69 74 | 61 62 6c 65 20 66 6f 72 |ple suit|able for|
|00001400| 20 63 72 65 61 74 69 6f | 6e 0a 6f 66 20 61 20 77 | creatio|n.of a w|
|00001410| 69 6e 64 6f 77 20 6f 66 | 20 67 69 76 65 6e 20 77 |indow of| given w|
|00001420| 69 64 74 68 20 61 6e 64 | 20 68 65 69 67 68 74 2e |idth and| height.|
|00001430| 20 54 68 65 20 77 69 6e | 64 6f 77 20 77 69 6c 6c | The win|dow will|
|00001440| 20 62 65 20 73 74 61 67 | 67 65 72 65 64 0a 77 69 | be stag|gered.wi|
|00001450| 74 68 20 72 65 73 70 65 | 63 74 20 74 6f 20 70 72 |th respe|ct to pr|
|00001460| 65 76 69 6f 75 73 20 77 | 69 6e 64 6f 77 73 2c 20 |evious w|indows, |
|00001470| 61 6e 64 20 61 6e 20 61 | 74 74 65 6d 70 74 20 69 |and an a|ttempt i|
|00001480| 73 20 6d 61 64 65 20 74 | 6f 20 6b 65 65 70 20 74 |s made t|o keep t|
|00001490| 68 65 0a 77 68 6f 6c 65 | 20 77 69 6e 64 6f 77 20 |he.whole| window |
|000014a0| 6f 6e 2d 73 63 72 65 65 | 6e 2e 20 54 68 65 20 77 |on-scree|n. The w|
|000014b0| 69 6e 64 6f 77 20 77 69 | 6c 6c 20 68 6f 77 65 76 |indow wi|ll howev|
|000014c0| 65 72 20 61 6c 77 61 79 | 73 20 62 65 20 65 78 61 |er alway|s be exa|
|000014d0| 63 74 20 74 68 65 0a 73 | 69 7a 65 20 67 69 76 65 |ct the.s|ize give|
|000014e0| 6e 2c 20 73 6f 20 70 61 | 72 74 73 20 6d 61 79 20 |n, so pa|rts may |
|000014f0| 62 65 20 6f 66 66 73 63 | 72 65 65 6e 2e 0a 5c 65 |be offsc|reen..\e|
|00001500| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001510| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00001520| 65 74 77 61 74 63 68 63 | 75 72 73 6f 72 7d 7b 7d |etwatchc|ursor}{}|
|00001530| 0a 53 65 74 20 74 68 65 | 20 6d 6f 75 73 65 20 63 |.Set the| mouse c|
|00001540| 75 72 73 6f 72 20 74 6f | 20 61 20 77 61 74 63 68 |ursor to| a watch|
|00001550| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001560| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001570| 63 7d 7b 73 65 74 61 72 | 72 6f 77 63 75 72 73 6f |c}{setar|rowcurso|
|00001580| 72 7d 7b 7d 0a 53 65 74 | 20 74 68 65 20 6d 6f 75 |r}{}.Set| the mou|
|00001590| 73 65 20 63 75 72 73 6f | 72 20 74 6f 20 61 6e 20 |se curso|r to an |
|000015a0| 61 72 72 6f 77 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |arrow..\|end{func|
|000015b0| 64 65 73 63 7d 0a 0a 5c | 73 75 62 73 65 63 74 69 |desc}..\|subsecti|
|000015c0| 6f 6e 7b 41 70 70 6c 69 | 63 61 74 69 6f 6e 20 6f |on{Appli|cation o|
|000015d0| 62 6a 65 63 74 73 7d 0a | 41 70 70 6c 69 63 61 74 |bjects}.|Applicat|
|000015e0| 69 6f 6e 20 6f 62 6a 65 | 63 74 73 20 68 61 76 65 |ion obje|cts have|
|000015f0| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 6d | the fol|lowing m|
|00001600| 65 74 68 6f 64 73 2c 20 | 61 6d 6f 6e 67 20 6f 74 |ethods, |among ot|
|00001610| 68 65 72 73 3a 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |hers:..\|renewcom|
|00001620| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00001630| 65 6d 7d 7b 28 41 70 70 | 6c 69 63 61 74 69 6f 6e |em}{(App|lication|
|00001640| 20 6d 65 74 68 6f 64 29 | 7d 0a 0a 5c 62 65 67 69 | method)|}..\begi|
|00001650| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 6d 61 6b 65 |n{funcde|sc}{make|
|00001660| 75 73 65 72 6d 65 6e 75 | 73 7d 7b 7d 0a 4f 76 65 |usermenu|s}{}.Ove|
|00001670| 72 72 69 64 65 20 74 68 | 69 73 20 6d 65 74 68 6f |rride th|is metho|
|00001680| 64 20 69 66 20 79 6f 75 | 20 6e 65 65 64 20 6d 65 |d if you| need me|
|00001690| 6e 75 73 20 69 6e 20 79 | 6f 75 72 20 61 70 70 6c |nus in y|our appl|
|000016a0| 69 63 61 74 69 6f 6e 2e | 20 41 70 70 65 6e 64 20 |ication.| Append |
|000016b0| 74 68 65 0a 6d 65 6e 75 | 73 20 74 6f 20 5c 63 6f |the.menu|s to \co|
|000016c0| 64 65 7b 73 65 6c 66 2e | 6d 65 6e 75 62 61 72 7d |de{self.|menubar}|
|000016d0| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|000016e0| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000016f0| 63 7d 7b 67 65 74 61 62 | 6f 75 74 74 65 78 74 7d |c}{getab|outtext}|
|00001700| 7b 7d 0a 4f 76 65 72 72 | 69 64 65 20 74 68 69 73 |{}.Overr|ide this|
|00001710| 20 6d 65 74 68 6f 64 20 | 74 6f 20 72 65 74 75 72 | method |to retur|
|00001720| 6e 20 61 20 74 65 78 74 | 20 73 74 72 69 6e 67 20 |n a text| string |
|00001730| 64 65 73 63 72 69 62 69 | 6e 67 20 79 6f 75 72 0a |describi|ng your.|
|00001740| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 20 41 6c 74 |applicat|ion. Alt|
|00001750| 65 72 6e 61 74 69 76 65 | 6c 79 2c 20 6f 76 65 72 |ernative|ly, over|
|00001760| 72 69 64 65 20 74 68 65 | 20 5c 63 6f 64 65 7b 64 |ride the| \code{d|
|00001770| 6f 5f 61 62 6f 75 74 7d | 20 6d 65 74 68 6f 64 20 |o_about}| method |
|00001780| 66 6f 72 0a 6d 6f 72 65 | 20 65 6c 61 62 6f 72 61 |for.more| elabora|
|00001790| 74 65 20 61 62 6f 75 74 | 20 6d 65 73 73 61 67 65 |te about| message|
|000017a0| 73 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |s..\end{|funcdesc|
|000017b0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000017c0| 73 63 7d 7b 6d 61 69 6e | 6c 6f 6f 70 7d 7b 5c 6f |sc}{main|loop}{\o|
|000017d0| 70 74 69 6f 6e 61 6c 7b | 6d 61 73 6b 5c 2c 20 77 |ptional{|mask\, w|
|000017e0| 61 69 74 7d 7d 0a 54 68 | 69 73 20 72 6f 75 74 69 |ait}}.Th|is routi|
|000017f0| 6e 65 20 69 73 20 74 68 | 65 20 6d 61 69 6e 20 65 |ne is th|e main e|
|00001800| 76 65 6e 74 20 6c 6f 6f | 70 2c 20 63 61 6c 6c 20 |vent loo|p, call |
|00001810| 69 74 20 74 6f 20 73 65 | 74 20 79 6f 75 72 20 61 |it to se|t your a|
|00001820| 70 70 6c 69 63 61 74 69 | 6f 6e 0a 72 6f 6c 6c 69 |pplicati|on.rolli|
|00001830| 6e 67 2e 20 5c 76 61 72 | 7b 4d 61 73 6b 7d 20 69 |ng. \var|{Mask} i|
|00001840| 73 20 74 68 65 20 6d 61 | 73 6b 20 6f 66 20 65 76 |s the ma|sk of ev|
|00001850| 65 6e 74 73 20 79 6f 75 | 20 77 61 6e 74 20 74 6f |ents you| want to|
|00001860| 20 68 61 6e 64 6c 65 2c | 0a 5c 76 61 72 7b 77 61 | handle,|.\var{wa|
|00001870| 69 74 7d 20 69 73 20 74 | 68 65 20 6e 75 6d 62 65 |it} is t|he numbe|
|00001880| 72 20 6f 66 20 74 69 63 | 6b 73 20 79 6f 75 20 77 |r of tic|ks you w|
|00001890| 61 6e 74 20 74 6f 20 6c | 65 61 76 65 20 74 6f 20 |ant to l|eave to |
|000018a0| 6f 74 68 65 72 0a 63 6f | 6e 63 75 72 72 65 6e 74 |other.co|ncurrent|
|000018b0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 28 64 65 | applica|tion (de|
|000018c0| 66 61 75 6c 74 20 30 2c | 20 77 68 69 63 68 20 69 |fault 0,| which i|
|000018d0| 73 20 70 72 6f 62 61 62 | 6c 79 20 6e 6f 74 20 61 |s probab|ly not a|
|000018e0| 20 67 6f 6f 64 0a 69 64 | 65 61 29 2e 20 57 68 69 | good.id|ea). Whi|
|000018f0| 6c 65 20 72 61 69 73 69 | 6e 67 20 5c 63 6f 64 65 |le raisi|ng \code|
|00001900| 7b 73 65 6c 66 7d 20 74 | 6f 20 65 78 69 74 20 74 |{self} t|o exit t|
|00001910| 68 65 20 6d 61 69 6e 6c | 6f 6f 70 20 69 73 20 73 |he mainl|oop is s|
|00001920| 74 69 6c 6c 0a 73 75 70 | 70 6f 72 74 65 64 20 69 |till.sup|ported i|
|00001930| 74 20 69 73 20 6e 6f 74 | 20 72 65 63 6f 6d 6d 65 |t is not| recomme|
|00001940| 6e 64 65 64 2c 20 63 61 | 6c 6c 20 5c 63 6f 64 65 |nded, ca|ll \code|
|00001950| 7b 73 65 6c 66 2e 5f 71 | 75 69 74 7d 20 69 6e 73 |{self._q|uit} ins|
|00001960| 74 65 61 64 2e 0a 0a 54 | 68 65 20 65 76 65 6e 74 |tead...T|he event|
|00001970| 20 6c 6f 6f 70 20 69 73 | 20 73 70 6c 69 74 20 69 | loop is| split i|
|00001980| 6e 74 6f 20 6d 61 6e 79 | 20 73 6d 61 6c 6c 20 70 |nto many| small p|
|00001990| 61 72 74 73 2c 20 65 61 | 63 68 20 6f 66 20 77 68 |arts, ea|ch of wh|
|000019a0| 69 63 68 20 63 61 6e 20 | 62 65 0a 6f 76 65 72 72 |ich can |be.overr|
|000019b0| 69 64 64 65 6e 2e 20 54 | 68 65 20 64 65 66 61 75 |idden. T|he defau|
|000019c0| 6c 74 20 6d 65 74 68 6f | 64 73 20 74 61 6b 65 20 |lt metho|ds take |
|000019d0| 63 61 72 65 20 6f 66 20 | 64 69 73 70 61 74 63 68 |care of |dispatch|
|000019e0| 69 6e 67 20 65 76 65 6e | 74 73 20 74 6f 0a 77 69 |ing even|ts to.wi|
|000019f0| 6e 64 6f 77 73 20 61 6e | 64 20 64 69 61 6c 6f 67 |ndows an|d dialog|
|00001a00| 73 2c 20 68 61 6e 64 6c | 69 6e 67 20 64 72 61 67 |s, handl|ing drag|
|00001a10| 73 20 61 6e 64 20 72 65 | 73 69 7a 65 73 2c 20 41 |s and re|sizes, A|
|00001a20| 70 70 6c 65 20 45 76 65 | 6e 74 73 2c 20 65 76 65 |pple Eve|nts, eve|
|00001a30| 6e 74 73 0a 66 6f 72 20 | 6e 6f 6e 2d 46 72 61 6d |nts.for |non-Fram|
|00001a40| 65 57 6f 72 6b 20 77 69 | 6e 64 6f 77 73 2c 20 65 |eWork wi|ndows, e|
|00001a50| 74 63 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |tc..\end|{funcdes|
|00001a60| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001a70| 65 73 63 7d 7b 5f 71 75 | 69 74 7d 7b 7d 0a 54 65 |esc}{_qu|it}{}.Te|
|00001a80| 72 6d 69 6e 61 74 65 20 | 74 68 65 20 65 76 65 6e |rminate |the even|
|00001a90| 74 20 5c 63 6f 64 65 7b | 6d 61 69 6e 6c 6f 6f 70 |t \code{|mainloop|
|00001aa0| 7d 20 61 74 20 74 68 65 | 20 6e 65 78 74 20 63 6f |} at the| next co|
|00001ab0| 6e 76 65 6e 69 65 6e 74 | 20 6d 6f 6d 65 6e 74 2e |nvenient| moment.|
|00001ac0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00001ad0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001ae0| 7d 7b 64 6f 5f 63 68 61 | 72 7d 7b 63 5c 2c 20 65 |}{do_cha|r}{c\, e|
|00001af0| 76 65 6e 74 7d 0a 54 68 | 65 20 75 73 65 72 20 74 |vent}.Th|e user t|
|00001b00| 79 70 65 64 20 63 68 61 | 72 61 63 74 65 72 20 5c |yped cha|racter \|
|00001b10| 76 61 72 7b 63 7d 2e 20 | 54 68 65 20 63 6f 6d 70 |var{c}. |The comp|
|00001b20| 6c 65 74 65 20 64 65 74 | 61 69 6c 73 20 6f 66 20 |lete det|ails of |
|00001b30| 74 68 65 20 65 76 65 6e | 74 0a 63 61 6e 20 62 65 |the even|t.can be|
|00001b40| 20 66 6f 75 6e 64 20 69 | 6e 20 74 68 65 20 5c 76 | found i|n the \v|
|00001b50| 61 72 7b 65 76 65 6e 74 | 7d 20 73 74 72 75 63 74 |ar{event|} struct|
|00001b60| 75 72 65 2e 20 54 68 69 | 73 20 6d 65 74 68 6f 64 |ure. Thi|s method|
|00001b70| 20 63 61 6e 20 61 6c 73 | 6f 20 62 65 0a 70 72 6f | can als|o be.pro|
|00001b80| 76 69 64 65 64 20 69 6e | 20 61 20 5c 63 6f 64 65 |vided in| a \code|
|00001b90| 7b 57 69 6e 64 6f 77 7d | 20 6f 62 6a 65 63 74 2c |{Window}| object,|
|00001ba0| 20 77 68 69 63 68 20 6f | 76 65 72 72 69 64 65 73 | which o|verrides|
|00001bb0| 20 74 68 65 0a 61 70 70 | 6c 69 63 61 74 69 6f 6e | the.app|lication|
|00001bc0| 2d 77 69 64 65 20 68 61 | 6e 64 6c 65 72 20 69 66 |-wide ha|ndler if|
|00001bd0| 20 74 68 65 20 77 69 6e | 64 6f 77 20 69 73 20 66 | the win|dow is f|
|00001be0| 72 6f 6e 74 6d 6f 73 74 | 2e 0a 5c 65 6e 64 7b 66 |rontmost|..\end{f|
|00001bf0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00001c00| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 64 6f 5f 64 69 |{funcdes|c}{do_di|
|00001c10| 61 6c 6f 67 65 76 65 6e | 74 7d 7b 65 76 65 6e 74 |alogeven|t}{event|
|00001c20| 7d 0a 43 61 6c 6c 65 64 | 20 65 61 72 6c 79 20 69 |}.Called| early i|
|00001c30| 6e 20 74 68 65 20 65 76 | 65 6e 74 20 6c 6f 6f 70 |n the ev|ent loop|
|00001c40| 20 74 6f 20 68 61 6e 64 | 6c 65 20 6d 6f 64 65 6c | to hand|le model|
|00001c50| 65 73 73 20 64 69 61 6c | 6f 67 20 65 76 65 6e 74 |ess dial|og event|
|00001c60| 73 2e 20 54 68 65 0a 64 | 65 66 61 75 6c 74 20 6d |s. The.d|efault m|
|00001c70| 65 74 68 6f 64 20 73 69 | 6d 70 6c 79 20 64 69 73 |ethod si|mply dis|
|00001c80| 70 61 74 63 68 65 73 20 | 74 68 65 20 65 76 65 6e |patches |the even|
|00001c90| 74 20 74 6f 20 74 68 65 | 20 72 65 6c 65 76 61 6e |t to the| relevan|
|00001ca0| 74 20 64 69 61 6c 6f 67 | 20 28 6e 6f 74 0a 74 68 |t dialog| (not.th|
|00001cb0| 72 6f 75 67 68 20 74 68 | 65 20 74 68 65 20 5c 63 |rough th|e the \c|
|00001cc0| 6f 64 65 7b 44 69 61 6c | 6f 67 57 69 6e 64 6f 77 |ode{Dial|ogWindow|
|00001cd0| 7d 20 6f 62 6a 65 63 74 | 20 69 6e 76 6f 6c 76 65 |} object| involve|
|00001ce0| 64 29 2e 20 4f 76 65 72 | 72 69 64 65 20 69 66 20 |d). Over|ride if |
|00001cf0| 79 6f 75 0a 6e 65 65 64 | 20 73 70 65 63 69 61 6c |you.need| special|
|00001d00| 20 68 61 6e 64 6c 69 6e | 67 20 6f 66 20 64 69 61 | handlin|g of dia|
|00001d10| 6c 6f 67 20 65 76 65 6e | 74 73 20 28 6b 65 79 62 |log even|ts (keyb|
|00001d20| 6f 61 72 64 20 73 68 6f | 72 74 63 75 74 73 2c 20 |oard sho|rtcuts, |
|00001d30| 65 74 63 29 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |etc)..\e|nd{funcd|
|00001d40| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00001d50| 63 64 65 73 63 7d 7b 69 | 64 6c 65 7d 7b 65 76 65 |cdesc}{i|dle}{eve|
|00001d60| 6e 74 7d 0a 43 61 6c 6c | 65 64 20 62 79 20 74 68 |nt}.Call|ed by th|
|00001d70| 65 20 6d 61 69 6e 20 65 | 76 65 6e 74 20 6c 6f 6f |e main e|vent loo|
|00001d80| 70 20 77 68 65 6e 20 6e | 6f 20 65 76 65 6e 74 73 |p when n|o events|
|00001d90| 20 61 72 65 20 61 76 61 | 69 6c 61 62 6c 65 2e 20 | are ava|ilable. |
|00001da0| 54 68 65 0a 6e 75 6c 6c | 2d 65 76 65 6e 74 20 69 |The.null|-event i|
|00001db0| 73 20 70 61 73 73 65 64 | 20 28 73 6f 20 79 6f 75 |s passed| (so you|
|00001dc0| 20 63 61 6e 20 6c 6f 6f | 6b 20 61 74 20 6d 6f 75 | can loo|k at mou|
|00001dd0| 73 65 20 70 6f 73 69 74 | 69 6f 6e 2c 20 65 74 63 |se posit|ion, etc|
|00001de0| 29 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |)..\end{|funcdesc|
|00001df0| 7d 0a 0a 5c 73 75 62 73 | 65 63 74 69 6f 6e 7b 57 |}..\subs|ection{W|
|00001e00| 69 6e 64 6f 77 20 4f 62 | 6a 65 63 74 73 7d 0a 0a |indow Ob|jects}..|
|00001e10| 57 69 6e 64 6f 77 20 6f | 62 6a 65 63 74 73 20 68 |Window o|bjects h|
|00001e20| 61 76 65 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ave the |followin|
|00001e30| 67 20 6d 65 74 68 6f 64 | 73 2c 20 61 6d 6f 6e 67 |g method|s, among|
|00001e40| 20 6f 74 68 65 72 73 3a | 0a 0a 5c 72 65 6e 65 77 | others:|..\renew|
|00001e50| 63 6f 6d 6d 61 6e 64 7b | 5c 69 6e 64 65 78 73 75 |command{|\indexsu|
|00001e60| 62 69 74 65 6d 7d 7b 28 | 57 69 6e 64 6f 77 20 6d |bitem}{(|Window m|
|00001e70| 65 74 68 6f 64 29 7d 0a | 0a 5c 62 65 67 69 6e 7b |ethod)}.|.\begin{|
|00001e80| 66 75 6e 63 64 65 73 63 | 7d 7b 6f 70 65 6e 7d 7b |funcdesc|}{open}{|
|00001e90| 7d 0a 4f 76 65 72 72 69 | 64 65 20 74 68 69 73 20 |}.Overri|de this |
|00001ea0| 6d 65 74 68 6f 64 20 74 | 6f 20 6f 70 65 6e 20 61 |method t|o open a|
|00001eb0| 20 77 69 6e 64 6f 77 2e | 20 53 74 6f 72 65 20 74 | window.| Store t|
|00001ec0| 68 65 20 4d 61 63 4f 53 | 20 77 69 6e 64 6f 77 2d |he MacOS| window-|
|00001ed0| 69 64 20 69 6e 0a 5c 63 | 6f 64 65 7b 73 65 6c 66 |id in.\c|ode{self|
|00001ee0| 2e 77 69 64 7d 20 61 6e | 64 20 63 61 6c 6c 20 5c |.wid} an|d call \|
|00001ef0| 63 6f 64 65 7b 73 65 6c | 66 2e 64 6f 5f 70 6f 73 |code{sel|f.do_pos|
|00001f00| 74 6f 70 65 6e 7d 20 74 | 6f 20 72 65 67 69 73 74 |topen} t|o regist|
|00001f10| 65 72 20 74 68 65 0a 77 | 69 6e 64 6f 77 20 77 69 |er the.w|indow wi|
|00001f20| 74 68 20 74 68 65 20 70 | 61 72 65 6e 74 20 61 70 |th the p|arent ap|
|00001f30| 70 6c 69 63 61 74 69 6f | 6e 2e 0a 5c 65 6e 64 7b |plicatio|n..\end{|
|00001f40| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00001f50| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 63 6c 6f 73 |n{funcde|sc}{clos|
|00001f60| 65 7d 7b 7d 0a 4f 76 65 | 72 72 69 64 65 20 74 68 |e}{}.Ove|rride th|
|00001f70| 69 73 20 6d 65 74 68 6f | 64 20 74 6f 20 64 6f 20 |is metho|d to do |
|00001f80| 61 6e 79 20 73 70 65 63 | 69 61 6c 20 70 72 6f 63 |any spec|ial proc|
|00001f90| 65 73 73 69 6e 67 20 6f | 6e 20 77 69 6e 64 6f 77 |essing o|n window|
|00001fa0| 0a 63 6c 6f 73 65 2e 20 | 43 61 6c 6c 20 5c 63 6f |.close. |Call \co|
|00001fb0| 64 65 7b 73 65 6c 66 2e | 64 6f 5f 70 6f 73 74 63 |de{self.|do_postc|
|00001fc0| 6c 6f 73 65 7d 20 74 6f | 20 63 6c 65 61 6e 75 70 |lose} to| cleanup|
|00001fd0| 20 74 68 65 20 70 61 72 | 65 6e 74 20 73 74 61 74 | the par|ent stat|
|00001fe0| 65 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |e..\end{|funcdesc|
|00001ff0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00002000| 73 63 7d 7b 64 6f 5f 70 | 6f 73 74 72 65 73 69 7a |sc}{do_p|ostresiz|
|00002010| 65 7d 7b 77 69 64 74 68 | 5c 2c 20 68 65 69 67 68 |e}{width|\, heigh|
|00002020| 74 5c 2c 20 6d 61 63 6f | 73 77 69 6e 64 6f 77 69 |t\, maco|swindowi|
|00002030| 64 7d 0a 43 61 6c 6c 65 | 64 20 61 66 74 65 72 20 |d}.Calle|d after |
|00002040| 74 68 65 20 77 69 6e 64 | 6f 77 20 69 73 20 72 65 |the wind|ow is re|
|00002050| 73 69 7a 65 64 2e 20 4f | 76 65 72 72 69 64 65 20 |sized. O|verride |
|00002060| 69 66 20 6d 6f 72 65 20 | 6e 65 65 64 73 20 74 6f |if more |needs to|
|00002070| 20 62 65 20 64 6f 6e 65 | 0a 74 68 61 6e 20 63 61 | be done|.than ca|
|00002080| 6c 6c 69 6e 67 20 5c 63 | 6f 64 65 7b 49 6e 76 61 |lling \c|ode{Inva|
|00002090| 6c 52 65 63 74 7d 2e 0a | 5c 65 6e 64 7b 66 75 6e |lRect}..|\end{fun|
|000020a0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|000020b0| 75 6e 63 64 65 73 63 7d | 7b 64 6f 5f 63 6f 6e 74 |uncdesc}|{do_cont|
|000020c0| 65 6e 74 63 6c 69 63 6b | 7d 7b 6c 6f 63 61 6c 5c |entclick|}{local\|
|000020d0| 2c 20 6d 6f 64 69 66 69 | 65 72 73 5c 2c 20 65 76 |, modifi|ers\, ev|
|000020e0| 65 6e 74 7d 0a 54 68 65 | 20 75 73 65 72 20 63 6c |ent}.The| user cl|
|000020f0| 69 63 6b 65 64 20 69 6e | 20 74 68 65 20 63 6f 6e |icked in| the con|
|00002100| 74 65 6e 74 20 70 61 72 | 74 20 6f 66 20 61 20 77 |tent par|t of a w|
|00002110| 69 6e 64 6f 77 2e 20 54 | 68 65 20 61 72 67 75 6d |indow. T|he argum|
|00002120| 65 6e 74 73 20 61 72 65 | 0a 74 68 65 20 63 6f 6f |ents are|.the coo|
|00002130| 72 64 69 6e 61 74 65 73 | 20 28 77 69 6e 64 6f 77 |rdinates| (window|
|00002140| 2d 72 65 6c 61 74 69 76 | 65 29 2c 20 74 68 65 20 |-relativ|e), the |
|00002150| 6b 65 79 20 6d 6f 64 69 | 66 69 65 72 73 20 61 6e |key modi|fiers an|
|00002160| 64 20 74 68 65 20 72 61 | 77 0a 65 76 65 6e 74 2e |d the ra|w.event.|
|00002170| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00002180| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002190| 7d 7b 64 6f 5f 75 70 64 | 61 74 65 7d 7b 6d 61 63 |}{do_upd|ate}{mac|
|000021a0| 6f 73 77 69 6e 64 6f 77 | 69 64 5c 2c 20 65 76 65 |oswindow|id\, eve|
|000021b0| 6e 74 7d 0a 41 6e 20 75 | 70 64 61 74 65 20 65 76 |nt}.An u|pdate ev|
|000021c0| 65 6e 74 20 66 6f 72 20 | 74 68 65 20 77 69 6e 64 |ent for |the wind|
|000021d0| 6f 77 20 77 61 73 20 72 | 65 63 65 69 76 65 64 2e |ow was r|eceived.|
|000021e0| 20 52 65 64 72 61 77 20 | 74 68 65 20 77 69 6e 64 | Redraw |the wind|
|000021f0| 6f 77 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ow..\end|{funcdes|
|00002200| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00002210| 65 73 63 7d 7b 64 6f 5f | 61 63 74 69 76 61 74 65 |esc}{do_|activate|
|00002220| 7d 7b 61 63 74 69 76 61 | 74 65 5c 2c 20 65 76 65 |}{activa|te\, eve|
|00002230| 6e 74 7d 0a 54 68 65 20 | 77 69 6e 64 6f 77 20 77 |nt}.The |window w|
|00002240| 61 73 20 61 63 74 69 76 | 61 74 65 64 20 28 5c 63 |as activ|ated (\c|
|00002250| 6f 64 65 7b 61 63 74 69 | 76 61 74 65 3d 3d 31 7d |ode{acti|vate==1}|
|00002260| 29 20 6f 72 20 64 65 61 | 63 74 69 76 61 74 65 64 |) or dea|ctivated|
|00002270| 0a 28 5c 63 6f 64 65 7b | 61 63 74 69 76 61 74 65 |.(\code{|activate|
|00002280| 3d 3d 30 7d 29 2e 20 48 | 61 6e 64 6c 65 20 74 68 |==0}). H|andle th|
|00002290| 69 6e 67 73 20 6c 69 6b | 65 20 66 6f 63 75 73 20 |ings lik|e focus |
|000022a0| 68 69 67 68 6c 69 67 68 | 74 69 6e 67 2c 20 65 74 |highligh|ting, et|
|000022b0| 63 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |c..\end{|funcdesc|
|000022c0| 7d 0a 0a 5c 73 75 62 73 | 65 63 74 69 6f 6e 7b 43 |}..\subs|ection{C|
|000022d0| 6f 6e 74 72 6f 6c 73 57 | 69 6e 64 6f 77 20 4f 62 |ontrolsW|indow Ob|
|000022e0| 6a 65 63 74 7d 0a 0a 43 | 6f 6e 74 72 6f 6c 73 57 |ject}..C|ontrolsW|
|000022f0| 69 6e 64 6f 77 20 6f 62 | 6a 65 63 74 73 20 68 61 |indow ob|jects ha|
|00002300| 76 65 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |ve the f|ollowing|
|00002310| 20 6d 65 74 68 6f 64 73 | 20 62 65 73 69 64 65 73 | methods| besides|
|00002320| 20 74 68 6f 73 65 20 6f | 66 0a 5c 63 6f 64 65 7b | those o|f.\code{|
|00002330| 57 69 6e 64 6f 77 7d 20 | 6f 62 6a 65 63 74 73 3a |Window} |objects:|
|00002340| 0a 0a 5c 72 65 6e 65 77 | 63 6f 6d 6d 61 6e 64 7b |..\renew|command{|
|00002350| 5c 69 6e 64 65 78 73 75 | 62 69 74 65 6d 7d 7b 28 |\indexsu|bitem}{(|
|00002360| 43 6f 6e 74 72 6f 6c 73 | 57 69 6e 64 6f 77 20 6d |Controls|Window m|
|00002370| 65 74 68 6f 64 29 7d 0a | 0a 5c 62 65 67 69 6e 7b |ethod)}.|.\begin{|
|00002380| 66 75 6e 63 64 65 73 63 | 7d 7b 64 6f 5f 63 6f 6e |funcdesc|}{do_con|
|00002390| 74 72 6f 6c 68 69 74 7d | 7b 77 69 6e 64 6f 77 5c |trolhit}|{window\|
|000023a0| 2c 20 63 6f 6e 74 72 6f | 6c 5c 2c 20 70 63 6f 64 |, contro|l\, pcod|
|000023b0| 65 5c 2c 20 65 76 65 6e | 74 7d 0a 50 61 72 74 20 |e\, even|t}.Part |
|000023c0| 5c 63 6f 64 65 7b 70 63 | 6f 64 65 7d 20 6f 66 20 |\code{pc|ode} of |
|000023d0| 63 6f 6e 74 72 6f 6c 20 | 5c 63 6f 64 65 7b 63 6f |control |\code{co|
|000023e0| 6e 74 72 6f 6c 7d 20 77 | 61 73 20 68 69 74 20 62 |ntrol} w|as hit b|
|000023f0| 79 20 74 68 65 0a 75 73 | 65 72 2e 20 54 72 61 63 |y the.us|er. Trac|
|00002400| 6b 69 6e 67 20 61 6e 64 | 20 73 75 63 68 20 68 61 |king and| such ha|
|00002410| 73 20 61 6c 72 65 61 64 | 79 20 62 65 65 6e 20 74 |s alread|y been t|
|00002420| 61 6b 65 6e 20 63 61 72 | 65 20 6f 66 2e 0a 5c 65 |aken car|e of..\e|
|00002430| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 73 |nd{funcd|esc}..\s|
|00002440| 75 62 73 65 63 74 69 6f | 6e 7b 53 63 72 6f 6c 6c |ubsectio|n{Scroll|
|00002450| 65 64 57 69 6e 64 6f 77 | 20 4f 62 6a 65 63 74 7d |edWindow| Object}|
|00002460| 0a 0a 53 63 72 6f 6c 6c | 65 64 57 69 6e 64 6f 77 |..Scroll|edWindow|
|00002470| 20 6f 62 6a 65 63 74 73 | 20 61 72 65 20 43 6f 6e | objects| are Con|
|00002480| 74 72 6f 6c 73 57 69 6e | 64 6f 77 20 6f 62 6a 65 |trolsWin|dow obje|
|00002490| 63 74 73 20 77 69 74 68 | 20 74 68 65 20 66 6f 6c |cts with| the fol|
|000024a0| 6c 6f 77 69 6e 67 0a 65 | 78 74 72 61 20 6d 65 74 |lowing.e|xtra met|
|000024b0| 68 6f 64 73 3a 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |hods:..\|renewcom|
|000024c0| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|000024d0| 65 6d 7d 7b 28 53 63 72 | 6f 6c 6c 65 64 57 69 6e |em}{(Scr|olledWin|
|000024e0| 64 6f 77 20 6d 65 74 68 | 6f 64 29 7d 0a 0a 5c 62 |dow meth|od)}..\b|
|000024f0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00002500| 63 72 6f 6c 6c 62 61 72 | 73 7d 7b 5c 6f 70 74 69 |crollbar|s}{\opti|
|00002510| 6f 6e 61 6c 7b 77 61 6e | 74 78 5c 2c 20 77 61 6e |onal{wan|tx\, wan|
|00002520| 74 79 7d 7d 0a 43 72 65 | 61 74 65 20 28 6f 72 20 |ty}}.Cre|ate (or |
|00002530| 64 65 73 74 72 6f 79 29 | 20 68 6f 72 69 7a 6f 6e |destroy)| horizon|
|00002540| 74 61 6c 20 61 6e 64 20 | 76 65 72 74 69 63 61 6c |tal and |vertical|
|00002550| 20 73 63 72 6f 6c 6c 62 | 61 72 73 2e 20 54 68 65 | scrollb|ars. The|
|00002560| 20 61 72 67 75 6d 65 6e | 74 73 0a 73 70 65 63 69 | argumen|ts.speci|
|00002570| 66 79 20 77 68 69 63 68 | 20 79 6f 75 20 77 61 6e |fy which| you wan|
|00002580| 74 20 28 64 65 66 61 75 | 6c 74 3a 20 62 6f 74 68 |t (defau|lt: both|
|00002590| 29 2e 20 54 68 65 20 73 | 63 72 6f 6c 6c 62 61 72 |). The s|crollbar|
|000025a0| 73 20 61 6c 77 61 79 73 | 20 68 61 76 65 0a 6d 69 |s always| have.mi|
|000025b0| 6e 69 6d 75 6d 20 5c 63 | 6f 64 65 7b 30 7d 20 61 |nimum \c|ode{0} a|
|000025c0| 6e 64 20 6d 61 78 69 6d | 75 6d 20 5c 63 6f 64 65 |nd maxim|um \code|
|000025d0| 7b 33 32 37 36 37 7d 2e | 0a 5c 65 6e 64 7b 66 75 |{32767}.|.\end{fu|
|000025e0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000025f0| 66 75 6e 63 64 65 73 63 | 7d 7b 67 65 74 73 63 72 |funcdesc|}{getscr|
|00002600| 6f 6c 6c 62 61 72 76 61 | 6c 75 65 73 7d 7b 7d 0a |ollbarva|lues}{}.|
|00002610| 59 6f 75 20 6d 75 73 74 | 20 73 75 70 70 6c 79 20 |You must| supply |
|00002620| 74 68 69 73 20 6d 65 74 | 68 6f 64 2e 20 49 74 20 |this met|hod. It |
|00002630| 73 68 6f 75 6c 64 20 72 | 65 74 75 72 6e 20 61 20 |should r|eturn a |
|00002640| 74 75 70 6c 65 20 5c 63 | 6f 64 65 7b 78 2c 20 79 |tuple \c|ode{x, y|
|00002650| 7d 0a 67 69 76 69 6e 67 | 20 74 68 65 20 63 75 72 |}.giving| the cur|
|00002660| 72 65 6e 74 20 70 6f 73 | 69 74 69 6f 6e 20 6f 66 |rent pos|ition of|
|00002670| 20 74 68 65 20 73 63 72 | 6f 6c 6c 62 61 72 73 20 | the scr|ollbars |
|00002680| 28 62 65 74 77 65 65 6e | 20 5c 63 6f 64 65 7b 30 |(between| \code{0|
|00002690| 7d 20 61 6e 64 0a 5c 63 | 6f 64 65 7b 33 32 37 36 |} and.\c|ode{3276|
|000026a0| 37 7d 29 2e 20 59 6f 75 | 20 63 61 6e 20 72 65 74 |7}). You| can ret|
|000026b0| 75 72 6e 20 5c 63 6f 64 | 65 7b 4e 6f 6e 65 7d 20 |urn \cod|e{None} |
|000026c0| 66 6f 72 20 65 69 74 68 | 65 72 20 74 6f 20 69 6e |for eith|er to in|
|000026d0| 64 69 63 61 74 65 20 74 | 68 65 0a 77 68 6f 6c 65 |dicate t|he.whole|
|000026e0| 20 64 6f 63 75 6d 65 6e | 74 20 69 73 20 76 69 73 | documen|t is vis|
|000026f0| 69 62 6c 65 20 69 6e 20 | 74 68 61 74 20 64 69 72 |ible in |that dir|
|00002700| 65 63 74 69 6f 6e 2e 0a | 5c 65 6e 64 7b 66 75 6e |ection..|\end{fun|
|00002710| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00002720| 75 6e 63 64 65 73 63 7d | 7b 75 70 64 61 74 65 73 |uncdesc}|{updates|
|00002730| 63 72 6f 6c 6c 62 61 72 | 73 7d 7b 7d 0a 43 61 6c |crollbar|s}{}.Cal|
|00002740| 6c 20 74 68 69 73 20 6d | 65 74 68 6f 64 20 77 68 |l this m|ethod wh|
|00002750| 65 6e 20 74 68 65 20 64 | 6f 63 75 6d 65 6e 74 20 |en the d|ocument |
|00002760| 68 61 73 20 63 68 61 6e | 67 65 64 2e 20 49 74 20 |has chan|ged. It |
|00002770| 77 69 6c 6c 20 63 61 6c | 6c 0a 5c 63 6f 64 65 7b |will cal|l.\code{|
|00002780| 67 65 74 73 63 72 6f 6c | 6c 62 61 72 76 61 6c 75 |getscrol|lbarvalu|
|00002790| 65 73 7d 20 61 6e 64 20 | 75 70 64 61 74 65 20 74 |es} and |update t|
|000027a0| 68 65 20 73 63 72 6f 6c | 6c 62 61 72 73 2e 0a 5c |he scrol|lbars..\|
|000027b0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|000027c0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000027d0| 73 63 72 6f 6c 6c 62 61 | 72 5f 63 61 6c 6c 62 61 |scrollba|r_callba|
|000027e0| 63 6b 7d 7b 77 68 69 63 | 68 5c 2c 20 77 68 61 74 |ck}{whic|h\, what|
|000027f0| 5c 2c 20 76 61 6c 75 65 | 7d 0a 53 75 70 70 6c 69 |\, value|}.Suppli|
|00002800| 65 64 20 62 79 20 79 6f | 75 20 61 6e 64 20 63 61 |ed by yo|u and ca|
|00002810| 6c 6c 65 64 20 61 66 74 | 65 72 20 75 73 65 72 20 |lled aft|er user |
|00002820| 69 6e 74 65 72 61 63 74 | 69 6f 6e 2e 20 5c 63 6f |interact|ion. \co|
|00002830| 64 65 7b 57 68 69 63 68 | 7d 20 77 69 6c 6c 0a 62 |de{Which|} will.b|
|00002840| 65 20 5c 63 6f 64 65 7b | 27 78 27 7d 20 6f 72 20 |e \code{|'x'} or |
|00002850| 5c 63 6f 64 65 7b 27 79 | 27 7d 2c 20 5c 63 6f 64 |\code{'y|'}, \cod|
|00002860| 65 7b 77 68 61 74 7d 20 | 77 69 6c 6c 20 62 65 20 |e{what} |will be |
|00002870| 5c 63 6f 64 65 7b 27 2d | 27 7d 2c 0a 5c 63 6f 64 |\code{'-|'},.\cod|
|00002880| 65 7b 27 2d 2d 27 7d 2c | 20 5c 63 6f 64 65 7b 27 |e{'--'},| \code{'|
|00002890| 73 65 74 27 7d 2c 20 5c | 63 6f 64 65 7b 27 2b 2b |set'}, \|code{'++|
|000028a0| 27 7d 20 6f 72 20 5c 63 | 6f 64 65 7b 27 2b 27 7d |'} or \c|ode{'+'}|
|000028b0| 2e 20 46 6f 72 0a 5c 63 | 6f 64 65 7b 27 73 65 74 |. For.\c|ode{'set|
|000028c0| 27 7d 2c 20 5c 63 6f 64 | 65 7b 76 61 6c 75 65 7d |'}, \cod|e{value}|
|000028d0| 20 77 69 6c 6c 20 63 6f | 6e 74 61 69 6e 20 74 68 | will co|ntain th|
|000028e0| 65 20 6e 65 77 20 73 63 | 72 6f 6c 6c 62 61 72 20 |e new sc|rollbar |
|000028f0| 70 6f 73 69 74 69 6f 6e | 2e 0a 5c 65 6e 64 7b 66 |position|..\end{f|
|00002900| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00002910| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 73 63 61 6c 65 |{funcdes|c}{scale|
|00002920| 62 61 72 76 61 6c 75 65 | 73 7d 7b 61 62 73 6d 69 |barvalue|s}{absmi|
|00002930| 6e 5c 2c 20 61 62 73 6d | 61 78 5c 2c 20 63 75 72 |n\, absm|ax\, cur|
|00002940| 6d 69 6e 5c 2c 20 63 75 | 72 6d 61 78 7d 0a 41 75 |min\, cu|rmax}.Au|
|00002950| 78 69 6c 69 61 72 79 20 | 6d 65 74 68 6f 64 20 74 |xiliary |method t|
|00002960| 6f 20 68 65 6c 70 20 79 | 6f 75 20 63 61 6c 63 75 |o help y|ou calcu|
|00002970| 6c 61 74 65 20 76 61 6c | 75 65 73 20 74 6f 20 72 |late val|ues to r|
|00002980| 65 74 75 72 6e 20 66 72 | 6f 6d 0a 5c 63 6f 64 65 |eturn fr|om.\code|
|00002990| 7b 67 65 74 73 63 72 6f | 6c 6c 62 61 72 76 61 6c |{getscro|llbarval|
|000029a0| 75 65 73 7d 2e 20 59 6f | 75 20 70 61 73 73 20 64 |ues}. Yo|u pass d|
|000029b0| 6f 63 75 6d 65 6e 74 20 | 6d 69 6e 69 6d 75 6d 20 |ocument |minimum |
|000029c0| 61 6e 64 20 6d 61 78 69 | 6d 75 6d 20 76 61 6c 75 |and maxi|mum valu|
|000029d0| 65 0a 61 6e 64 20 74 6f | 70 6d 6f 73 74 20 28 6c |e.and to|pmost (l|
|000029e0| 65 66 74 6d 6f 73 74 29 | 20 61 6e 64 20 62 6f 74 |eftmost)| and bot|
|000029f0| 74 6f 6d 6d 6f 73 74 20 | 28 72 69 67 68 74 6d 6f |tommost |(rightmo|
|00002a00| 73 74 29 20 76 69 73 69 | 62 6c 65 20 76 61 6c 75 |st) visi|ble valu|
|00002a10| 65 73 20 61 6e 64 0a 69 | 74 20 72 65 74 75 72 6e |es and.i|t return|
|00002a20| 73 20 74 68 65 20 63 6f | 72 72 65 63 74 20 6e 75 |s the co|rrect nu|
|00002a30| 6d 62 65 72 20 6f 72 20 | 5c 63 6f 64 65 7b 4e 6f |mber or |\code{No|
|00002a40| 6e 65 7d 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ne}..\en|d{funcde|
|00002a50| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00002a60| 64 65 73 63 7d 7b 64 6f | 5f 61 63 74 69 76 61 74 |desc}{do|_activat|
|00002a70| 65 7d 7b 6f 6e 6f 66 66 | 5c 2c 20 65 76 65 6e 74 |e}{onoff|\, event|
|00002a80| 7d 0a 54 61 6b 65 73 20 | 63 61 72 65 20 6f 66 20 |}.Takes |care of |
|00002a90| 64 69 6d 6d 69 6e 67 2f | 68 69 67 68 6c 69 67 68 |dimming/|highligh|
|00002aa0| 74 69 6e 67 20 73 63 72 | 6f 6c 6c 62 61 72 73 20 |ting scr|ollbars |
|00002ab0| 77 68 65 6e 20 61 20 77 | 69 6e 64 6f 77 20 62 65 |when a w|indow be|
|00002ac0| 63 6f 6d 65 73 0a 66 72 | 6f 6e 74 6d 6f 73 74 20 |comes.fr|ontmost |
|00002ad0| 76 76 2e 20 49 66 20 79 | 6f 75 20 6f 76 65 72 72 |vv. If y|ou overr|
|00002ae0| 69 64 65 20 74 68 69 73 | 20 6d 65 74 68 6f 64 20 |ide this| method |
|00002af0| 63 61 6c 6c 20 74 68 69 | 73 20 6f 6e 65 20 61 74 |call thi|s one at|
|00002b00| 20 74 68 65 20 65 6e 64 | 20 6f 66 0a 79 6f 75 72 | the end| of.your|
|00002b10| 20 6d 65 74 68 6f 64 2e | 0a 5c 65 6e 64 7b 66 75 | method.|.\end{fu|
|00002b20| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00002b30| 66 75 6e 63 64 65 73 63 | 7d 7b 64 6f 5f 70 6f 73 |funcdesc|}{do_pos|
|00002b40| 74 72 65 73 69 7a 65 7d | 7b 77 69 64 74 68 5c 2c |tresize}|{width\,|
|00002b50| 20 68 65 69 67 68 74 5c | 2c 20 77 69 6e 64 6f 77 | height\|, window|
|00002b60| 7d 0a 4d 6f 76 65 73 20 | 73 63 72 6f 6c 6c 62 61 |}.Moves |scrollba|
|00002b70| 72 73 20 74 6f 20 74 68 | 65 20 63 6f 72 72 65 63 |rs to th|e correc|
|00002b80| 74 20 70 6f 73 69 74 69 | 6f 6e 2e 20 43 61 6c 6c |t positi|on. Call|
|00002b90| 20 74 68 69 73 20 6d 65 | 74 68 6f 64 20 69 6e 69 | this me|thod ini|
|00002ba0| 74 69 61 6c 6c 79 0a 69 | 66 20 79 6f 75 20 6f 76 |tially.i|f you ov|
|00002bb0| 65 72 72 69 64 65 20 69 | 74 2e 0a 5c 65 6e 64 7b |erride i|t..\end{|
|00002bc0| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00002bd0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 64 6f 5f 63 |n{funcde|sc}{do_c|
|00002be0| 6f 6e 74 72 6f 6c 68 69 | 74 7d 7b 77 69 6e 64 6f |ontrolhi|t}{windo|
|00002bf0| 77 5c 2c 20 63 6f 6e 74 | 72 6f 6c 5c 2c 20 70 63 |w\, cont|rol\, pc|
|00002c00| 6f 64 65 5c 2c 20 65 76 | 65 6e 74 7d 0a 48 61 6e |ode\, ev|ent}.Han|
|00002c10| 64 6c 65 73 20 73 63 72 | 6f 6c 6c 62 61 72 20 69 |dles scr|ollbar i|
|00002c20| 6e 74 65 72 61 63 74 69 | 6f 6e 2e 20 49 66 20 79 |nteracti|on. If y|
|00002c30| 6f 75 20 6f 76 65 72 72 | 69 64 65 20 69 74 20 63 |ou overr|ide it c|
|00002c40| 61 6c 6c 20 74 68 69 73 | 20 6d 65 74 68 6f 64 0a |all this| method.|
|00002c50| 66 69 72 73 74 2c 20 61 | 20 6e 6f 6e 7a 65 72 6f |first, a| nonzero|
|00002c60| 20 72 65 74 75 72 6e 20 | 76 61 6c 75 65 20 69 6e | return |value in|
|00002c70| 64 69 63 61 74 65 73 20 | 74 68 65 20 68 69 74 20 |dicates |the hit |
|00002c80| 77 61 73 20 69 6e 20 74 | 68 65 20 73 63 72 6f 6c |was in t|he scrol|
|00002c90| 6c 62 61 72 73 0a 61 6e | 64 20 68 61 73 20 62 65 |lbars.an|d has be|
|00002ca0| 65 6e 20 68 61 6e 64 6c | 65 64 2e 0a 5c 65 6e 64 |en handl|ed..\end|
|00002cb0| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 73 75 62 |{funcdes|c}..\sub|
|00002cc0| 73 65 63 74 69 6f 6e 7b | 44 69 61 6c 6f 67 57 69 |section{|DialogWi|
|00002cd0| 6e 64 6f 77 20 4f 62 6a | 65 63 74 73 7d 0a 0a 44 |ndow Obj|ects}..D|
|00002ce0| 69 61 6c 6f 67 57 69 6e | 64 6f 77 20 6f 62 6a 65 |ialogWin|dow obje|
|00002cf0| 63 74 73 20 68 61 76 65 | 20 74 68 65 20 66 6f 6c |cts have| the fol|
|00002d00| 6c 6f 77 69 6e 67 20 6d | 65 74 68 6f 64 73 20 62 |lowing m|ethods b|
|00002d10| 65 73 69 64 65 73 20 74 | 68 6f 73 65 20 6f 66 0a |esides t|hose of.|
|00002d20| 5c 63 6f 64 65 7b 57 69 | 6e 64 6f 77 7d 20 6f 62 |\code{Wi|ndow} ob|
|00002d30| 6a 65 63 74 73 3a 0a 0a | 5c 72 65 6e 65 77 63 6f |jects:..|\renewco|
|00002d40| 6d 6d 61 6e 64 7b 5c 69 | 6e 64 65 78 73 75 62 69 |mmand{\i|ndexsubi|
|00002d50| 74 65 6d 7d 7b 28 44 69 | 61 6c 6f 67 57 69 6e 64 |tem}{(Di|alogWind|
|00002d60| 6f 77 20 6d 65 74 68 6f | 64 29 7d 0a 0a 5c 62 65 |ow metho|d)}..\be|
|00002d70| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 6f 70 |gin{func|desc}{op|
|00002d80| 65 6e 7d 7b 72 65 73 69 | 64 7d 0a 43 72 65 61 74 |en}{resi|d}.Creat|
|00002d90| 65 20 74 68 65 20 64 69 | 61 6c 6f 67 20 77 69 6e |e the di|alog win|
|00002da0| 64 6f 77 2c 20 66 72 6f | 6d 20 74 68 65 20 44 4c |dow, fro|m the DL|
|00002db0| 4f 47 20 72 65 73 6f 75 | 72 63 65 20 77 69 74 68 |OG resou|rce with|
|00002dc0| 20 69 64 0a 5c 76 61 72 | 7b 72 65 73 69 64 7d 2e | id.\var|{resid}.|
|00002dd0| 20 54 68 65 20 64 69 61 | 6c 6f 67 20 6f 62 6a 65 | The dia|log obje|
|00002de0| 63 74 20 69 73 20 73 74 | 6f 72 65 64 20 69 6e 20 |ct is st|ored in |
|00002df0| 5c 63 6f 64 65 7b 73 65 | 6c 66 2e 77 69 64 7d 2e |\code{se|lf.wid}.|
|00002e00| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00002e10| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002e20| 7d 7b 64 6f 5f 69 74 65 | 6d 68 69 74 7d 7b 69 74 |}{do_ite|mhit}{it|
|00002e30| 65 6d 5c 2c 20 65 76 65 | 6e 74 7d 0a 49 74 65 6d |em\, eve|nt}.Item|
|00002e40| 20 6e 75 6d 62 65 72 20 | 5c 76 61 72 7b 69 74 65 | number |\var{ite|
|00002e50| 6d 7d 20 77 61 73 20 68 | 69 74 2e 20 59 6f 75 20 |m} was h|it. You |
|00002e60| 61 72 65 20 72 65 73 70 | 6f 6e 73 69 62 6c 65 20 |are resp|onsible |
|00002e70| 66 6f 72 20 72 65 64 72 | 61 77 69 6e 67 0a 74 6f |for redr|awing.to|
|00002e80| 67 67 6c 65 20 62 75 74 | 74 6f 6e 73 2c 20 65 74 |ggle but|tons, et|
|00002e90| 63 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |c..\end{|funcdesc|
|00002ea0| 7d 0a 0a 5c 73 65 63 74 | 69 6f 6e 7b 53 74 61 6e |}..\sect|ion{Stan|
|00002eb0| 64 61 72 64 20 6d 6f 64 | 75 6c 65 20 5c 73 65 63 |dard mod|ule \sec|
|00002ec0| 74 63 6f 64 65 7b 4d 69 | 6e 69 41 45 46 72 61 6d |tcode{Mi|niAEFram|
|00002ed0| 65 7d 7d 0a 5c 73 74 6d | 6f 64 69 6e 64 65 78 7b |e}}.\stm|odindex{|
|00002ee0| 4d 69 6e 69 41 45 46 72 | 61 6d 65 7d 0a 0a 54 68 |MiniAEFr|ame}..Th|
|00002ef0| 65 20 6d 6f 64 75 6c 65 | 20 5c 76 61 72 7b 4d 69 |e module| \var{Mi|
|00002f00| 6e 69 41 45 46 72 61 6d | 65 7d 20 70 72 6f 76 69 |niAEFram|e} provi|
|00002f10| 64 65 73 20 61 20 66 72 | 61 6d 65 77 6f 72 6b 20 |des a fr|amework |
|00002f20| 66 6f 72 20 61 6e 20 61 | 70 70 6c 69 63 61 74 69 |for an a|pplicati|
|00002f30| 6f 6e 0a 74 68 61 74 20 | 63 61 6e 20 66 75 6e 63 |on.that |can func|
|00002f40| 74 69 6f 6e 20 61 73 20 | 61 6e 20 4f 53 41 20 73 |tion as |an OSA s|
|00002f50| 65 72 76 65 72 2c 20 69 | 2e 65 2e 20 72 65 63 65 |erver, i|.e. rece|
|00002f60| 69 76 65 20 61 6e 64 20 | 70 72 6f 63 65 73 73 0a |ive and |process.|
|00002f70| 41 70 70 6c 65 45 76 65 | 6e 74 73 2e 20 49 74 20 |AppleEve|nts. It |
|00002f80| 63 61 6e 20 62 65 20 75 | 73 65 64 20 69 6e 20 63 |can be u|sed in c|
|00002f90| 6f 6e 6a 75 6e 63 74 69 | 6f 6e 20 77 69 74 68 20 |onjuncti|on with |
|00002fa0| 5c 76 61 72 7b 46 72 61 | 6d 65 57 6f 72 6b 7d 20 |\var{Fra|meWork} |
|00002fb0| 6f 72 0a 73 74 61 6e 64 | 61 6c 6f 6e 65 2e 0a 0a |or.stand|alone...|
|00002fc0| 54 68 69 73 20 6d 6f 64 | 75 6c 65 20 69 73 20 74 |This mod|ule is t|
|00002fd0| 65 6d 70 6f 72 61 72 79 | 2c 20 69 74 20 77 69 6c |emporary|, it wil|
|00002fe0| 6c 20 65 76 65 6e 74 75 | 61 6c 6c 79 20 62 65 20 |l eventu|ally be |
|00002ff0| 72 65 70 6c 61 63 65 64 | 20 62 79 20 61 20 6d 6f |replaced| by a mo|
|00003000| 64 75 6c 65 0a 74 68 61 | 74 20 68 61 6e 64 6c 65 |dule.tha|t handle|
|00003010| 73 20 61 72 67 75 6d 65 | 6e 74 20 6e 61 6d 65 73 |s argume|nt names|
|00003020| 20 62 65 74 74 65 72 20 | 61 6e 64 20 70 6f 73 73 | better |and poss|
|00003030| 69 62 6c 79 20 61 75 74 | 6f 6d 61 74 65 73 20 6d |ibly aut|omates m|
|00003040| 61 6b 69 6e 67 20 79 6f | 75 72 0a 61 70 70 6c 69 |aking yo|ur.appli|
|00003050| 63 61 74 69 6f 6e 20 73 | 63 72 69 70 74 61 62 6c |cation s|criptabl|
|00003060| 65 2e 0a 0a 54 68 65 20 | 5c 76 61 72 7b 4d 69 6e |e...The |\var{Min|
|00003070| 69 41 45 46 72 61 6d 65 | 7d 20 6d 6f 64 75 6c 65 |iAEFrame|} module|
|00003080| 20 64 65 66 69 6e 65 73 | 20 74 68 65 20 66 6f 6c | defines| the fol|
|00003090| 6c 6f 77 69 6e 67 20 63 | 6c 61 73 73 65 73 3a 0a |lowing c|lasses:.|
|000030a0| 0a 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|000030b0| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|000030c0| 6e 20 6d 6f 64 75 6c 65 | 20 4d 69 6e 69 41 45 46 |n module| MiniAEF|
|000030d0| 72 61 6d 65 29 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |rame)}..|\begin{f|
|000030e0| 75 6e 63 64 65 73 63 7d | 7b 41 45 53 65 72 76 65 |uncdesc}|{AEServe|
|000030f0| 72 7d 7b 7d 0a 41 20 63 | 6c 61 73 73 20 74 68 61 |r}{}.A c|lass tha|
|00003100| 74 20 68 61 6e 64 6c 65 | 73 20 41 70 70 6c 65 45 |t handle|s AppleE|
|00003110| 76 65 6e 74 20 64 69 73 | 70 61 74 63 68 2e 20 59 |vent dis|patch. Y|
|00003120| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|00003130| 73 68 6f 75 6c 64 0a 73 | 75 62 63 6c 61 73 73 20 |should.s|ubclass |
|00003140| 74 68 69 73 20 63 6c 61 | 73 73 20 74 6f 67 65 74 |this cla|ss toget|
|00003150| 68 65 72 20 77 69 74 68 | 20 65 69 74 68 65 72 0a |her with| either.|
|00003160| 5c 63 6f 64 65 7b 4d 69 | 6e 69 41 45 46 72 61 6d |\code{Mi|niAEFram|
|00003170| 65 2e 4d 69 6e 69 41 70 | 70 6c 69 63 61 74 69 6f |e.MiniAp|plicatio|
|00003180| 6e 7d 20 6f 72 0a 5c 63 | 6f 64 65 7b 46 72 61 6d |n} or.\c|ode{Fram|
|00003190| 65 57 6f 72 6b 2e 41 70 | 70 6c 69 63 61 74 69 6f |eWork.Ap|plicatio|
|000031a0| 6e 7d 2e 20 59 6f 75 72 | 20 5c 63 6f 64 65 7b 5f |n}. Your| \code{_|
|000031b0| 5f 69 6e 69 74 5f 5f 7d | 20 6d 65 74 68 6f 64 20 |_init__}| method |
|000031c0| 73 68 6f 75 6c 64 20 63 | 61 6c 6c 0a 74 68 65 20 |should c|all.the |
|000031d0| 5c 63 6f 64 65 7b 5f 5f | 69 6e 69 74 5f 5f 7d 20 |\code{__|init__} |
|000031e0| 6d 65 74 68 6f 64 20 66 | 6f 72 20 62 6f 74 68 20 |method f|or both |
|000031f0| 63 6c 61 73 73 65 73 2e | 0a 5c 65 6e 64 7b 66 75 |classes.|.\end{fu|
|00003200| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00003210| 66 75 6e 63 64 65 73 63 | 7d 7b 4d 69 6e 69 41 70 |funcdesc|}{MiniAp|
|00003220| 70 6c 69 63 61 74 69 6f | 6e 7d 7b 7d 0a 41 20 63 |plicatio|n}{}.A c|
|00003230| 6c 61 73 73 20 74 68 61 | 74 20 69 73 20 6d 6f 72 |lass tha|t is mor|
|00003240| 65 20 6f 72 20 6c 65 73 | 73 20 63 6f 6d 70 61 74 |e or les|s compat|
|00003250| 69 62 6c 65 20 77 69 74 | 68 0a 5c 63 6f 64 65 7b |ible wit|h.\code{|
|00003260| 46 72 61 6d 65 57 6f 72 | 6b 2e 41 70 70 6c 69 63 |FrameWor|k.Applic|
|00003270| 61 74 69 6f 6e 7d 20 62 | 75 74 20 77 69 74 68 20 |ation} b|ut with |
|00003280| 6c 65 73 73 20 66 75 6e | 63 74 69 6f 6e 61 6c 69 |less fun|ctionali|
|00003290| 74 79 2e 20 49 74 73 0a | 65 76 65 6e 74 6c 6f 6f |ty. Its.|eventloo|
|000032a0| 70 20 73 75 70 70 6f 72 | 74 73 20 74 68 65 20 61 |p suppor|ts the a|
|000032b0| 70 70 6c 65 20 6d 65 6e | 75 2c 20 63 6f 6d 6d 61 |pple men|u, comma|
|000032c0| 6e 64 2d 64 6f 74 20 61 | 6e 64 20 41 70 70 6c 65 |nd-dot a|nd Apple|
|000032d0| 45 76 65 6e 74 73 2c 20 | 6f 74 68 65 72 0a 65 76 |Events, |other.ev|
|000032e0| 65 6e 74 73 20 61 72 65 | 20 70 61 73 73 65 64 20 |ents are| passed |
|000032f0| 6f 6e 20 74 6f 20 74 68 | 65 20 50 79 74 68 6f 6e |on to th|e Python|
|00003300| 20 69 6e 74 65 72 70 72 | 65 74 65 72 20 61 6e 64 | interpr|eter and|
|00003310| 2f 6f 72 20 53 69 6f 75 | 78 2e 0a 55 73 65 66 75 |/or Siou|x..Usefu|
|00003320| 6c 20 69 66 20 79 6f 75 | 72 20 61 70 70 6c 69 63 |l if you|r applic|
|00003330| 61 74 69 6f 6e 20 77 61 | 6e 74 73 20 74 6f 20 75 |ation wa|nts to u|
|00003340| 73 65 20 5c 63 6f 64 65 | 7b 41 45 53 65 72 76 65 |se \code|{AEServe|
|00003350| 72 7d 20 62 75 74 20 64 | 6f 65 73 20 6e 6f 74 0a |r} but d|oes not.|
|00003360| 70 72 6f 76 69 64 65 20 | 69 74 73 20 6f 77 6e 20 |provide |its own |
|00003370| 77 69 6e 64 6f 77 73 2c | 20 65 74 63 2e 0a 5c 65 |windows,| etc..\e|
|00003380| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 73 |nd{funcd|esc}..\s|
|00003390| 75 62 73 65 63 74 69 6f | 6e 7b 41 45 53 65 72 76 |ubsectio|n{AEServ|
|000033a0| 65 72 20 4f 62 6a 65 63 | 74 73 7d 0a 0a 5c 72 65 |er Objec|ts}..\re|
|000033b0| 6e 65 77 63 6f 6d 6d 61 | 6e 64 7b 5c 69 6e 64 65 |newcomma|nd{\inde|
|000033c0| 78 73 75 62 69 74 65 6d | 7d 7b 28 41 45 53 65 72 |xsubitem|}{(AESer|
|000033d0| 76 65 72 20 6d 65 74 68 | 6f 64 29 7d 0a 0a 5c 62 |ver meth|od)}..\b|
|000033e0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 69 |egin{fun|cdesc}{i|
|000033f0| 6e 73 74 61 6c 6c 61 65 | 68 61 6e 64 6c 65 72 7d |nstallae|handler}|
|00003400| 7b 63 6c 61 73 73 65 5c | 2c 20 74 79 70 65 5c 2c |{classe\|, type\,|
|00003410| 20 63 61 6c 6c 62 61 63 | 6b 7d 0a 49 6e 73 74 61 | callbac|k}.Insta|
|00003420| 6c 6c 73 20 61 6e 20 41 | 70 70 6c 65 45 76 65 6e |lls an A|ppleEven|
|00003430| 74 20 68 61 6e 64 6c 65 | 72 2e 20 5c 63 6f 64 65 |t handle|r. \code|
|00003440| 7b 43 6c 61 73 73 65 7d | 20 61 6e 64 20 5c 63 6f |{Classe}| and \co|
|00003450| 64 65 7b 74 79 70 65 7d | 20 61 72 65 20 74 68 65 |de{type}| are the|
|00003460| 0a 66 6f 75 72 2d 63 68 | 61 72 20 4f 53 41 20 43 |.four-ch|ar OSA C|
|00003470| 6c 61 73 73 20 61 6e 64 | 20 54 79 70 65 20 64 65 |lass and| Type de|
|00003480| 73 69 67 6e 61 74 6f 72 | 73 2c 20 5c 63 6f 64 65 |signator|s, \code|
|00003490| 7b 27 2a 2a 2a 2a 27 7d | 20 77 69 6c 64 63 61 72 |{'****'}| wildcar|
|000034a0| 64 73 20 61 72 65 0a 61 | 6c 6c 6f 77 65 64 2e 20 |ds are.a|llowed. |
|000034b0| 57 68 65 6e 20 61 20 6d | 61 74 63 68 69 6e 67 20 |When a m|atching |
|000034c0| 41 70 70 6c 65 45 76 65 | 6e 74 20 69 73 20 72 65 |AppleEve|nt is re|
|000034d0| 63 65 69 76 65 64 20 74 | 68 65 20 70 61 72 61 6d |ceived t|he param|
|000034e0| 65 74 65 72 73 20 61 72 | 65 0a 64 65 63 6f 64 65 |eters ar|e.decode|
|000034f0| 64 20 61 6e 64 20 79 6f | 75 72 20 63 61 6c 6c 62 |d and yo|ur callb|
|00003500| 61 63 6b 20 69 73 20 69 | 6e 76 6f 6b 65 64 2e 0a |ack is i|nvoked..|
|00003510| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00003520| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00003530| 7b 63 61 6c 6c 62 61 63 | 6b 7d 7b 5f 6f 62 6a 65 |{callbac|k}{_obje|
|00003540| 63 74 5c 2c 20 2a 2a 6b | 77 61 72 67 73 7d 0a 59 |ct\, **k|wargs}.Y|
|00003550| 6f 75 72 20 63 61 6c 6c | 62 61 63 6b 20 69 73 20 |our call|back is |
|00003560| 63 61 6c 6c 65 64 20 77 | 69 74 68 20 74 68 65 20 |called w|ith the |
|00003570| 4f 53 41 20 44 69 72 65 | 63 74 20 4f 62 6a 65 63 |OSA Dire|ct Objec|
|00003580| 74 20 61 73 20 66 69 72 | 73 74 20 70 6f 73 69 74 |t as fir|st posit|
|00003590| 69 6f 6e 61 6c 0a 70 61 | 72 61 6d 65 74 65 72 2e |ional.pa|rameter.|
|000035a0| 20 54 68 65 20 6f 74 68 | 65 72 20 70 61 72 61 6d | The oth|er param|
|000035b0| 65 74 65 72 73 20 61 72 | 65 20 70 61 73 73 65 64 |eters ar|e passed|
|000035c0| 20 61 73 20 6b 65 79 77 | 6f 72 64 20 61 72 67 75 | as keyw|ord argu|
|000035d0| 6d 65 6e 74 73 2c 20 77 | 69 74 68 0a 74 68 65 20 |ments, w|ith.the |
|000035e0| 34 2d 63 68 61 72 20 64 | 65 73 69 67 6e 61 74 6f |4-char d|esignato|
|000035f0| 72 20 61 73 20 6e 61 6d | 65 2e 20 54 68 72 65 65 |r as nam|e. Three|
|00003600| 20 65 78 74 72 61 20 6b | 65 79 77 6f 72 64 20 70 | extra k|eyword p|
|00003610| 61 72 61 6d 65 74 65 72 | 73 20 61 72 65 0a 70 61 |arameter|s are.pa|
|00003620| 73 73 65 64 3a 20 5c 63 | 6f 64 65 7b 5f 63 6c 61 |ssed: \c|ode{_cla|
|00003630| 73 73 7d 20 61 6e 64 20 | 5c 63 6f 64 65 7b 5f 74 |ss} and |\code{_t|
|00003640| 79 70 65 7d 20 61 72 65 | 20 74 68 65 20 43 6c 61 |ype} are| the Cla|
|00003650| 73 73 20 61 6e 64 20 54 | 79 70 65 0a 64 65 73 69 |ss and T|ype.desi|
|00003660| 67 6e 61 74 6f 72 73 20 | 61 6e 64 20 5c 63 6f 64 |gnators |and \cod|
|00003670| 65 7b 5f 61 74 74 72 69 | 62 75 74 65 73 7d 20 69 |e{_attri|butes} i|
|00003680| 73 20 61 20 64 69 63 74 | 69 6f 6e 61 72 79 20 77 |s a dict|ionary w|
|00003690| 69 74 68 20 74 68 65 20 | 41 70 70 6c 65 45 76 65 |ith the |AppleEve|
|000036a0| 6e 74 0a 61 74 74 72 69 | 62 75 74 65 73 2e 0a 0a |nt.attri|butes...|
|000036b0| 54 68 65 20 72 65 74 75 | 72 6e 20 76 61 6c 75 65 |The retu|rn value|
|000036c0| 20 6f 66 20 79 6f 75 72 | 20 6d 65 74 68 6f 64 20 | of your| method |
|000036d0| 69 73 20 70 61 63 6b 65 | 64 20 77 69 74 68 0a 5c |is packe|d with.\|
|000036e0| 63 6f 64 65 7b 61 65 74 | 6f 6f 6c 73 2e 70 61 63 |code{aet|ools.pac|
|000036f0| 6b 65 76 65 6e 74 7d 20 | 61 6e 64 20 73 65 6e 74 |kevent} |and sent|
|00003700| 20 61 73 20 72 65 70 6c | 79 2e 0a 5c 65 6e 64 7b | as repl|y..\end{|
|00003710| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 4e 6f 74 65 20 |funcdesc|}..Note |
|00003720| 74 68 61 74 20 74 68 65 | 72 65 20 61 72 65 20 73 |that the|re are s|
|00003730| 6f 6d 65 20 73 65 72 69 | 6f 75 73 20 70 72 6f 62 |ome seri|ous prob|
|00003740| 6c 65 6d 73 20 77 69 74 | 68 20 74 68 65 20 63 75 |lems wit|h the cu|
|00003750| 72 72 65 6e 74 0a 64 65 | 73 69 67 6e 2e 20 41 70 |rrent.de|sign. Ap|
|00003760| 70 6c 65 45 76 65 6e 74 | 73 20 77 68 69 63 68 20 |pleEvent|s which |
|00003770| 68 61 76 65 20 6e 6f 6e | 2d 69 64 65 6e 74 69 66 |have non|-identif|
|00003780| 69 65 72 20 34 2d 63 68 | 61 72 20 64 65 73 69 67 |ier 4-ch|ar desig|
|00003790| 6e 61 74 6f 72 73 20 66 | 6f 72 0a 61 72 67 75 6d |nators f|or.argum|
|000037a0| 65 6e 74 73 20 61 72 65 | 20 6e 6f 74 20 69 6d 70 |ents are| not imp|
|000037b0| 6c 65 6d 65 6e 74 61 62 | 6c 65 2c 20 61 6e 64 20 |lementab|le, and |
|000037c0| 69 74 20 69 73 20 6e 6f | 74 20 70 6f 73 73 69 62 |it is no|t possib|
|000037d0| 6c 65 20 74 6f 20 72 65 | 74 75 72 6e 20 61 6e 0a |le to re|turn an.|
|000037e0| 65 72 72 6f 72 20 74 6f | 20 74 68 65 20 6f 72 69 |error to| the ori|
|000037f0| 67 69 6e 61 74 6f 72 2e | 20 54 68 69 73 20 77 69 |ginator.| This wi|
|00003800| 6c 6c 20 62 65 20 61 64 | 64 72 65 73 73 65 64 20 |ll be ad|dressed |
|00003810| 69 6e 20 61 20 66 75 74 | 75 72 65 20 72 65 6c 65 |in a fut|ure rele|
|00003820| 61 73 65 2e 0a          |                         |ase..   |        |
+--------+-------------------------+-------------------------+--------+--------+