/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / docs / mui_autodocs-2.3.lha / MUI_Autodocs / Source / mui_popasl.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 50 6f 70 61 73 6c 2e |\section|{Popasl.|
|00000010| 6d 75 69 7d 0a 0a 41 73 | 20 61 20 73 75 62 63 6c |mui}..As| a subcl|
|00000020| 61 73 73 20 6f 66 20 70 | 6f 70 73 74 72 69 6e 67 |ass of p|opstring|
|00000030| 20 63 6c 61 73 73 2c 20 | 70 6f 70 61 73 6c 20 63 | class, |popasl c|
|00000040| 61 6e 20 62 65 20 75 73 | 65 64 20 74 6f 20 70 6f |an be us|ed to po|
|00000050| 70 20 75 70 0a 61 6e 79 | 20 6b 69 6e 64 73 20 6f |p up.any| kinds o|
|00000060| 66 20 73 74 61 6e 64 61 | 72 64 20 73 79 73 74 65 |f standa|rd syste|
|00000070| 6d 20 61 73 6c 20 72 65 | 71 75 65 73 74 65 72 73 |m asl re|questers|
|00000080| 2e 20 41 20 73 65 70 65 | 72 61 74 65 20 74 61 73 |. A sepe|rate tas|
|00000090| 6b 20 69 73 0a 73 70 61 | 77 6e 65 64 20 74 6f 20 |k is.spa|wned to |
|000000a0| 68 61 6e 64 6c 65 20 74 | 68 65 73 65 20 72 65 71 |handle t|hese req|
|000000b0| 75 65 73 74 65 72 73 2c | 20 74 68 65 20 61 70 70 |uesters,| the app|
|000000c0| 6c 69 63 61 74 69 6f 6e | 20 63 6f 6e 74 69 6e 75 |lication| continu|
|000000d0| 65 73 20 74 6f 0a 72 75 | 6e 2e 0a 0a 55 73 69 6e |es to.ru|n...Usin|
|000000e0| 67 20 61 6e 20 61 73 6c | 20 70 6f 70 75 70 20 63 |g an asl| popup c|
|000000f0| 6c 61 73 73 2c 20 79 6f | 75 20 64 6f 6e 27 74 20 |lass, yo|u don't |
|00000100| 6e 65 65 64 20 74 6f 20 | 77 6f 72 72 79 20 61 62 |need to |worry ab|
|00000110| 6f 75 74 20 68 61 6e 64 | 6c 69 6e 67 0a 61 73 6c |out hand|ling.asl|
|00000120| 20 72 65 71 75 65 73 74 | 65 72 73 2e 20 4d 55 49 | request|ers. MUI|
|00000130| 20 77 69 6c 6c 20 61 75 | 74 6f 6d 61 74 69 63 61 | will au|tomatica|
|00000140| 6c 6c 79 20 6f 70 65 6e | 20 6f 6e 65 20 77 68 65 |lly open| one whe|
|00000150| 6e 20 74 68 65 20 70 6f | 70 75 70 0a 62 75 74 74 |n the po|pup.butt|
|00000160| 6f 6e 20 69 73 20 70 72 | 65 73 73 65 64 20 61 6e |on is pr|essed an|
|00000170| 64 20 75 70 64 61 74 65 | 20 74 68 65 20 63 6f 72 |d update| the cor|
|00000180| 72 65 73 70 6f 6e 64 69 | 6e 67 20 73 74 72 69 6e |respondi|ng strin|
|00000190| 67 20 67 61 64 67 65 74 | 0a 77 68 65 6e 20 74 68 |g gadget|.when th|
|000001a0| 65 20 75 73 65 72 20 74 | 65 72 6d 69 6e 61 74 65 |e user t|erminate|
|000001b0| 73 20 74 68 65 20 72 65 | 71 75 65 73 74 65 72 2e |s the re|quester.|
|000001c0| 20 46 72 6f 6d 20 74 68 | 65 20 70 72 6f 67 72 61 | From th|e progra|
|000001d0| 6d 6d 65 72 73 0a 70 6f | 69 6e 74 20 6f 66 20 76 |mmers.po|int of v|
|000001e0| 69 65 77 2c 20 61 6c 6c | 20 79 6f 75 20 68 61 76 |iew, all| you hav|
|000001f0| 65 20 74 6f 20 64 6f 20 | 69 73 20 74 6f 20 68 61 |e to do |is to ha|
|00000200| 6e 64 6c 65 20 74 68 65 | 20 73 74 72 69 6e 67 0a |ndle the| string.|
|00000210| 67 61 64 67 65 74 73 20 | 63 6f 6e 74 65 6e 74 73 |gadgets |contents|
|00000220| 2e 0a 0a 49 4d 50 4f 52 | 54 41 4e 54 3a 20 41 74 |...IMPOR|TANT: At|
|00000230| 20 6f 62 6a 65 63 74 20 | 63 72 65 61 74 69 6f 6e | object |creation|
|00000240| 20 74 69 6d 65 2c 20 79 | 6f 75 20 63 61 6e 20 75 | time, y|ou can u|
|00000250| 73 65 20 61 6c 6c 20 41 | 53 4c 20 6c 69 62 72 61 |se all A|SL libra|
|00000260| 72 79 0a 74 61 67 73 20 | 61 73 20 77 65 6c 6c 2e |ry.tags |as well.|
|00000270| 20 54 68 65 79 20 77 69 | 6c 6c 20 62 65 20 70 61 | They wi|ll be pa|
|00000280| 73 73 65 64 20 74 6f 20 | 74 68 65 20 41 6c 6c 6f |ssed to |the Allo|
|00000290| 63 41 73 6c 52 65 71 75 | 65 73 74 28 29 20 63 61 |cAslRequ|est() ca|
|000002a0| 6c 6c 0a 77 69 74 68 6f | 75 74 20 66 75 72 74 68 |ll.witho|ut furth|
|000002b0| 65 72 20 69 6e 74 65 72 | 70 72 65 74 61 74 69 6f |er inter|pretatio|
|000002c0| 6e 2e 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 5b |n...\sub|section[|
|000002d0| 4d 55 49 41 5c 5f 50 6f | 70 61 73 6c 5c 5f 41 63 |MUIA\_Po|pasl\_Ac|
|000002e0| 74 69 76 65 5d 7b 4d 55 | 49 41 5c 5f 50 6f 70 61 |tive]{MU|IA\_Popa|
|000002f0| 73 6c 5c 5f 41 63 74 69 | 76 65 20 2d 2d 20 28 56 |sl\_Acti|ve -- (V|
|00000300| 37 29 20 5b 2e 2e 47 5d | 2c 20 42 4f 4f 4c 7d 0a |7) [..G]|, BOOL}.|
|00000310| 0a 5c 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 2a |.\subsub|section*|
|00000320| 7b 46 55 4e 43 54 49 4f | 4e 7d 0a 50 6f 70 61 73 |{FUNCTIO|N}.Popas|
|00000330| 6c 20 63 72 65 61 74 65 | 73 20 61 73 79 6e 63 68 |l create|s asynch|
|00000340| 72 6f 6e 6f 75 73 20 70 | 6f 70 75 70 73 2e 20 52 |ronous p|opups. R|
|00000350| 65 71 75 65 73 74 65 72 | 73 20 61 72 65 20 6f 70 |equester|s are op|
|00000360| 65 6e 65 64 20 69 6e 20 | 61 0a 73 65 70 65 72 61 |ened in |a.sepera|
|00000370| 74 65 6c 79 20 73 70 61 | 77 6e 65 64 20 74 61 73 |tely spa|wned tas|
|00000380| 6b 20 61 6e 64 20 64 6f | 6e 27 74 20 64 69 73 74 |k and do|n't dist|
|00000390| 75 72 62 20 74 68 65 20 | 72 65 73 74 20 6f 66 20 |urb the |rest of |
|000003a0| 74 68 65 0a 61 70 70 6c | 69 63 61 74 69 6f 6e 2e |the.appl|ication.|
|000003b0| 20 59 6f 75 20 63 61 6e | 20 61 73 6b 20 66 6f 72 | You can| ask for|
|000003c0| 20 74 68 65 20 73 74 61 | 74 65 20 6f 66 20 61 20 | the sta|te of a |
|000003d0| 72 65 71 75 65 73 74 65 | 72 20 62 79 0a 71 75 65 |requeste|r by.que|
|000003e0| 72 79 69 6e 67 20 74 68 | 65 20 4d 55 49 41 5c 5f |rying th|e MUIA\_|
|000003f0| 50 6f 70 61 73 6c 5c 5f | 41 63 74 69 76 65 20 61 |Popasl\_|Active a|
|00000400| 74 74 72 69 62 75 74 65 | 2e 20 49 74 20 77 69 6c |ttribute|. It wil|
|00000410| 6c 20 72 65 74 75 72 6e | 0a 54 52 55 45 20 77 68 |l return|.TRUE wh|
|00000420| 65 6e 20 74 68 65 20 72 | 65 71 75 65 73 74 65 72 |en the r|equester|
|00000430| 20 69 73 20 63 75 72 72 | 65 6e 74 6c 79 20 6f 70 | is curr|ently op|
|00000440| 65 6e 2c 20 46 41 4c 53 | 45 20 6f 74 68 65 72 77 |en, FALS|E otherw|
|00000450| 69 73 65 2e 0a 0a 43 6f | 6d 6d 6f 6e 20 75 73 65 |ise...Co|mmon use|
|00000460| 20 66 6f 72 20 74 68 69 | 73 20 61 74 74 72 69 62 | for thi|s attrib|
|00000470| 75 74 65 20 69 73 20 74 | 6f 20 70 72 65 76 65 6e |ute is t|o preven|
|00000480| 74 20 61 6e 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |t an app|lication|
|00000490| 0a 66 72 6f 6d 20 62 65 | 69 6e 67 20 74 65 72 6d |.from be|ing term|
|000004a0| 69 6e 61 74 65 64 20 77 | 68 69 6c 65 20 61 20 72 |inated w|hile a r|
|000004b0| 65 71 75 65 73 74 65 72 | 20 69 73 20 6f 70 65 6e |equester| is open|
|000004c0| 2e 20 49 66 20 79 6f 75 | 0a 74 72 79 20 74 6f 20 |. If you|.try to |
|000004d0| 64 69 73 70 6f 73 65 20 | 74 68 65 20 70 6f 70 61 |dispose |the popa|
|000004e0| 73 6c 20 6f 62 6a 65 63 | 74 20 77 69 74 68 20 61 |sl objec|t with a|
|000004f0| 20 63 75 72 72 65 6e 74 | 6c 79 20 6f 70 65 6e 0a | current|ly open.|
|00000500| 72 65 71 75 65 73 74 65 | 72 2c 20 4d 55 49 20 77 |requeste|r, MUI w|
|00000510| 69 6c 6c 20 66 72 65 65 | 7a 65 20 79 6f 75 72 20 |ill free|ze your |
|00000520| 74 61 73 6b 20 61 73 20 | 6c 6f 6e 67 20 61 73 20 |task as |long as |
|00000530| 74 68 65 20 72 65 71 75 | 65 73 74 65 72 0a 73 74 |the requ|ester.st|
|00000540| 61 79 73 20 74 68 65 72 | 65 2e 0a 0a 5c 73 75 62 |ays ther|e...\sub|
|00000550| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 45 58 41 4d |subsecti|on*{EXAM|
|00000560| 50 4c 45 7d 0a 5c 73 6d | 61 6c 6c 0a 5c 62 65 67 |PLE}.\sm|all.\beg|
|00000570| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 63 61 73 |in{verba|tim}.cas|
|00000580| 65 20 4d 55 49 56 5f 41 | 70 70 6c 69 63 61 74 69 |e MUIV_A|pplicati|
|00000590| 6f 6e 5f 52 65 74 75 72 | 6e 49 44 5f 51 75 69 74 |on_Retur|nID_Quit|
|000005a0| 3a 0a 7b 0a 20 20 20 4c | 4f 4e 47 20 61 63 74 69 |:.{.   L|ONG acti|
|000005b0| 76 65 3b 0a 0a 20 20 20 | 67 65 74 28 70 6f 70 31 |ve;..   |get(pop1|
|000005c0| 2c 4d 55 49 41 5f 50 6f | 70 61 73 6c 5f 41 63 74 |,MUIA_Po|pasl_Act|
|000005d0| 69 76 65 2c 26 61 63 74 | 69 76 65 29 3b 0a 20 20 |ive,&act|ive);.  |
|000005e0| 20 69 66 20 28 21 61 63 | 74 69 76 65 29 20 67 65 | if (!ac|tive) ge|
|000005f0| 74 28 70 6f 70 32 2c 4d | 55 49 41 5f 50 6f 70 61 |t(pop2,M|UIA_Popa|
|00000600| 73 6c 5f 41 63 74 69 76 | 65 2c 26 61 63 74 69 76 |sl_Activ|e,&activ|
|00000610| 65 29 3b 0a 20 20 20 69 | 66 20 28 21 61 63 74 69 |e);.   i|f (!acti|
|00000620| 76 65 29 20 67 65 74 28 | 70 6f 70 33 2c 4d 55 49 |ve) get(|pop3,MUI|
|00000630| 41 5f 50 6f 70 61 73 6c | 5f 41 63 74 69 76 65 2c |A_Popasl|_Active,|
|00000640| 26 61 63 74 69 76 65 29 | 3b 0a 20 20 20 69 66 20 |&active)|;.   if |
|00000650| 28 21 61 63 74 69 76 65 | 29 20 67 65 74 28 70 6f |(!active|) get(po|
|00000660| 70 34 2c 4d 55 49 41 5f | 50 6f 70 61 73 6c 5f 41 |p4,MUIA_|Popasl_A|
|00000670| 63 74 69 76 65 2c 26 61 | 63 74 69 76 65 29 3b 0a |ctive,&a|ctive);.|
|00000680| 0a 20 20 20 69 66 20 28 | 61 63 74 69 76 65 29 0a |.   if (|active).|
|00000690| 20 20 20 20 20 20 4d 55 | 49 5f 52 65 71 75 65 73 |      MU|I_Reques|
|000006a0| 74 28 61 70 70 2c 77 69 | 6e 64 6f 77 2c 30 2c 4e |t(app,wi|ndow,0,N|
|000006b0| 55 4c 4c 2c 22 4f 4b 22 | 2c 0a 20 20 20 20 20 20 |ULL,"OK"|,.      |
|000006c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 22 43 61 6e |        |    "Can|
|000006d0| 6e 6f 74 20 71 75 69 74 | 20 6e 6f 77 2c 20 73 74 |not quit| now, st|
|000006e0| 69 6c 6c 20 73 6f 6d 65 | 20 61 73 6c 20 70 6f 70 |ill some| asl pop|
|000006f0| 75 70 73 20 6f 70 65 6e | 65 64 2e 22 29 3b 0a 20 |ups open|ed.");. |
|00000700| 20 20 65 6c 73 65 0a 20 | 20 20 20 20 20 72 75 6e |  else. |     run|
|00000710| 6e 69 6e 67 20 3d 20 46 | 41 4c 53 45 3b 0a 7d 0a |ning = F|ALSE;.}.|
|00000720| 62 72 65 61 6b 3b 0a 0a | 5c 65 6e 64 7b 76 65 72 |break;..|\end{ver|
|00000730| 62 61 74 69 6d 7d 0a 5c | 6e 6f 72 6d 61 6c 73 69 |batim}.\|normalsi|
|00000740| 7a 65 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |ze.\subs|ubsectio|
|00000750| 6e 2a 7b 53 45 45 20 41 | 4c 53 4f 7d 0a 4d 55 49 |n*{SEE A|LSO}.MUI|
|00000760| 41 5c 5f 50 6f 70 61 73 | 6c 5c 5f 53 74 61 72 74 |A\_Popas|l\_Start|
|00000770| 48 6f 6f 6b 2c 20 4d 55 | 49 41 5c 5f 50 6f 70 61 |Hook, MU|IA\_Popa|
|00000780| 73 6c 5c 5f 53 74 6f 70 | 48 6f 6f 6b 2c 20 4d 55 |sl\_Stop|Hook, MU|
|00000790| 49 41 5c 5f 50 6f 70 61 | 73 6c 5c 5f 54 79 70 65 |IA\_Popa|sl\_Type|
|000007a0| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 5b 4d 55 |..\subse|ction[MU|
|000007b0| 49 41 5c 5f 50 6f 70 61 | 73 6c 5c 5f 53 74 61 72 |IA\_Popa|sl\_Star|
|000007c0| 74 48 6f 6f 6b 5d 7b 4d | 55 49 41 5c 5f 50 6f 70 |tHook]{M|UIA\_Pop|
|000007d0| 61 73 6c 5c 5f 53 74 61 | 72 74 48 6f 6f 6b 20 2d |asl\_Sta|rtHook -|
|000007e0| 2d 20 28 56 37 29 20 5b | 49 53 47 5d 2c 20 73 74 |- (V7) [|ISG], st|
|000007f0| 72 75 63 74 20 48 6f 6f | 6b 20 24 5c 61 73 74 24 |ruct Hoo|k $\ast$|
|00000800| 7d 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |}..\subs|ubsectio|
|00000810| 6e 2a 7b 46 55 4e 43 54 | 49 4f 4e 7d 0a 42 65 66 |n*{FUNCT|ION}.Bef|
|00000820| 6f 72 65 20 70 6f 70 61 | 73 6c 20 63 6c 61 73 73 |ore popa|sl class|
|00000830| 20 6f 70 65 6e 73 20 74 | 68 65 20 61 73 6c 20 72 | opens t|he asl r|
|00000840| 65 71 75 65 73 74 65 72 | 2c 20 69 74 20 68 61 73 |equester|, it has|
|00000850| 20 74 6f 0a 67 65 74 20 | 73 6f 6d 65 20 6b 69 6e | to.get |some kin|
|00000860| 64 20 6f 66 20 70 61 72 | 61 6d 65 74 65 72 73 20 |d of par|ameters |
|00000870| 64 65 73 63 72 69 62 69 | 6e 67 20 69 74 73 20 69 |describi|ng its i|
|00000880| 6e 69 74 69 61 6c 20 63 | 6f 6e 74 65 6e 74 73 2e |nitial c|ontents.|
|00000890| 0a 41 20 66 69 6c 65 20 | 70 6f 70 75 70 20 77 6f |.A file |popup wo|
|000008a0| 75 6c 64 20 65 2e 67 2e | 20 6e 65 65 64 20 74 6f |uld e.g.| need to|
|000008b0| 20 73 70 6c 69 74 20 74 | 68 65 20 73 74 72 69 6e | split t|he strin|
|000008c0| 67 20 67 61 64 67 65 74 | 73 0a 63 6f 6e 74 65 6e |g gadget|s.conten|
|000008d0| 74 73 20 69 6e 74 6f 20 | 70 61 74 68 20 61 6e 64 |ts into |path and|
|000008e0| 20 66 69 6c 65 20 6e 61 | 6d 65 20 70 61 72 74 20 | file na|me part |
|000008f0| 61 6e 64 20 70 61 73 73 | 20 74 68 65 73 65 0a 61 |and pass| these.a|
|00000900| 73 20 41 53 4c 46 52 5c | 5f 49 6e 69 74 69 74 61 |s ASLFR\|_Initita|
|00000910| 6c 46 69 6c 65 20 61 6e | 64 20 41 53 4c 46 52 5c |lFile an|d ASLFR\|
|00000920| 5f 49 6e 69 74 69 61 6c | 44 72 61 77 65 72 20 74 |_Initial|Drawer t|
|00000930| 6f 20 74 68 65 0a 72 65 | 71 75 65 73 74 65 72 2e |o the.re|quester.|
|00000940| 0a 0a 54 68 65 20 4d 55 | 49 41 5c 5f 50 6f 70 61 |..The MU|IA\_Popa|
|00000950| 73 6c 5c 5f 53 74 61 72 | 74 48 6f 6f 6b 20 74 61 |sl\_Star|tHook ta|
|00000960| 67 20 64 65 73 63 72 69 | 62 65 73 20 61 20 68 6f |g descri|bes a ho|
|00000970| 6f 6b 20 66 75 6e 63 74 | 69 6f 6e 0a 74 68 61 74 |ok funct|ion.that|
|00000980| 20 77 69 6c 6c 20 62 65 | 20 63 61 6c 6c 65 64 20 | will be| called |
|00000990| 69 6d 6d 65 64 69 61 74 | 65 6c 79 20 62 65 66 6f |immediat|ely befo|
|000009a0| 72 65 20 74 68 65 20 72 | 65 71 75 65 73 74 65 72 |re the r|equester|
|000009b0| 20 69 73 0a 6f 70 65 6e | 65 64 2e 20 49 74 20 77 | is.open|ed. It w|
|000009c0| 69 6c 6c 20 72 65 63 65 | 69 76 65 20 61 20 70 6f |ill rece|ive a po|
|000009d0| 69 6e 74 65 72 20 74 6f | 20 69 74 73 65 6c 66 20 |inter to| itself |
|000009e0| 69 6e 20 41 30 2c 0a 61 | 20 70 6f 69 6e 74 65 72 |in A0,.a| pointer|
|000009f0| 20 74 6f 20 74 68 65 20 | 70 6f 70 61 73 6c 20 6f | to the |popasl o|
|00000a00| 62 6a 65 63 74 20 69 6e | 20 41 32 20 61 6e 64 20 |bject in| A2 and |
|00000a10| 61 20 70 6f 69 6e 74 65 | 72 20 74 6f 0a 61 20 74 |a pointe|r to.a t|
|00000a20| 61 67 6c 69 73 74 20 69 | 6e 20 41 31 2e 20 54 68 |aglist i|n A1. Th|
|00000a30| 69 73 20 74 61 67 6c 69 | 73 74 20 61 6c 72 65 61 |is tagli|st alrea|
|00000a40| 64 79 20 63 6f 6e 74 61 | 69 6e 73 20 73 6f 6d 65 |dy conta|ins some|
|00000a50| 0a 74 61 67 73 3a 0a 0a | 5c 62 65 67 69 6e 7b 63 |.tags:..|\begin{c|
|00000a60| 65 6e 74 65 72 7d 20 5c | 62 65 67 69 6e 7b 74 61 |enter} \|begin{ta|
|00000a70| 62 75 6c 61 72 7d 7b 6c | 63 6c 7d 0a 41 53 4c 46 |bular}{l|cl}.ASLF|
|00000a80| 52 2f 46 4f 2f 2e 2e 2e | 5c 5f 53 63 72 65 65 6e |R/FO/...|\_Screen|
|00000a90| 20 20 20 20 20 20 20 20 | 20 20 26 3a 26 20 70 61 |        |  &:& pa|
|00000aa0| 72 65 6e 74 20 73 63 72 | 65 65 6e 5c 5c 0a 41 53 |rent scr|een\\.AS|
|00000ab0| 4c 46 52 2f 46 4f 2f 2e | 2e 2e 5c 5f 50 72 69 76 |LFR/FO/.|..\_Priv|
|00000ac0| 61 74 65 49 44 43 4d 50 | 20 20 20 20 26 3a 26 20 |ateIDCMP|    &:& |
|00000ad0| 54 52 55 45 5c 5c 0a 41 | 53 4c 46 52 2f 46 4f 2f |TRUE\\.A|SLFR/FO/|
|00000ae0| 2e 2e 2e 5c 5f 49 6e 69 | 74 69 74 61 6c 4c 65 66 |...\_Ini|titalLef|
|00000af0| 74 45 64 67 65 26 3a 26 | 20 6c 65 66 74 20 65 64 |tEdge&:&| left ed|
|00000b00| 67 65 20 6f 66 20 70 6f | 70 61 73 6c 20 6f 62 6a |ge of po|pasl obj|
|00000b10| 65 63 74 5c 5c 0a 41 53 | 4c 46 52 2f 46 4f 2f 2e |ect\\.AS|LFR/FO/.|
|00000b20| 2e 2e 5c 5f 49 6e 69 74 | 69 74 61 6c 54 6f 70 45 |..\_Init|italTopE|
|00000b30| 64 67 65 20 26 3a 26 20 | 62 6f 74 74 6f 6d 20 65 |dge &:& |bottom e|
|00000b40| 64 67 65 20 6f 66 20 70 | 6f 70 61 73 6c 20 6f 62 |dge of p|opasl ob|
|00000b50| 6a 65 63 74 5c 5c 0a 41 | 53 4c 46 52 2f 46 4f 2f |ject\\.A|SLFR/FO/|
|00000b60| 2e 2e 2e 5c 5f 49 6e 69 | 74 69 74 61 6c 57 69 64 |...\_Ini|titalWid|
|00000b70| 74 68 20 20 20 26 3a 26 | 20 77 69 64 74 68 20 6f |th   &:&| width o|
|00000b80| 66 20 70 6f 70 61 73 6c | 20 6f 62 6a 65 63 74 2c |f popasl| object,|
|00000b90| 20 6f 6e 6c 79 20 70 72 | 65 73 65 6e 74 20 77 68 | only pr|esent wh|
|00000ba0| 65 6e 5c 5c 0a 26 20 26 | 20 74 68 65 20 70 6f 70 |en\\.& &| the pop|
|00000bb0| 75 70 20 69 73 20 63 61 | 6c 6c 65 64 20 66 6f 72 |up is ca|lled for|
|00000bc0| 20 74 68 65 20 66 69 72 | 73 74 20 74 69 6d 65 2e | the fir|st time.|
|00000bd0| 5c 5c 0a 5c 65 6e 64 7b | 74 61 62 75 6c 61 72 7d |\\.\end{|tabular}|
|00000be0| 20 5c 65 6e 64 7b 63 65 | 6e 74 65 72 7d 0a 0a 59 | \end{ce|nter}..Y|
|00000bf0| 6f 75 20 6d 61 79 20 61 | 64 64 20 6f 74 68 65 72 |ou may a|dd other|
|00000c00| 20 74 61 67 73 20 74 6f | 20 74 68 65 20 6c 69 73 | tags to| the lis|
|00000c10| 74 2c 20 62 75 74 20 62 | 65 77 61 72 65 20 74 68 |t, but b|eware th|
|00000c20| 61 74 20 74 68 65 0a 6d | 61 78 69 6d 75 6d 20 61 |at the.m|aximum a|
|00000c30| 6c 6c 6f 77 65 64 20 6e | 75 6d 62 65 72 20 6f 66 |llowed n|umber of|
|00000c40| 20 74 61 67 73 20 69 73 | 20 31 35 2e 20 49 66 20 | tags is| 15. If |
|00000c50| 79 6f 75 20 6e 65 65 64 | 20 6d 6f 72 65 2c 0a 75 |you need| more,.u|
|00000c60| 73 65 20 74 68 65 20 54 | 41 47 5c 5f 4d 4f 52 45 |se the T|AG\_MORE|
|00000c70| 20 74 61 67 2e 0a 0a 53 | 69 6e 63 65 20 74 68 65 | tag...S|ince the|
|00000c80| 20 61 73 6c 20 72 65 71 | 75 65 73 74 65 72 20 77 | asl req|uester w|
|00000c90| 69 6c 6c 20 72 75 6e 20 | 69 6e 20 61 20 73 65 70 |ill run |in a sep|
|00000ca0| 65 72 61 74 65 20 74 61 | 73 6b 2c 20 79 6f 75 20 |erate ta|sk, you |
|00000cb0| 73 68 6f 75 6c 64 0a 6e | 6f 74 20 63 68 61 6e 67 |should.n|ot chang|
|00000cc0| 65 20 74 68 65 20 73 74 | 61 74 65 20 6f 66 20 74 |e the st|ate of t|
|00000cd0| 68 65 20 41 53 4c 46 52 | 5c 5f 50 72 69 76 61 74 |he ASLFR|\_Privat|
|00000ce0| 65 49 44 43 4d 50 20 74 | 61 67 21 0a 0a 49 66 20 |eIDCMP t|ag!..If |
|00000cf0| 79 6f 75 72 20 68 6f 6f | 6b 20 72 65 74 75 72 6e |your hoo|k return|
|00000d00| 73 20 54 52 55 45 2c 20 | 70 6f 70 61 73 6c 20 63 |s TRUE, |popasl c|
|00000d10| 6c 61 73 73 20 6f 70 65 | 6e 73 20 74 68 65 20 72 |lass ope|ns the r|
|00000d20| 65 71 75 65 73 74 65 72 | 0a 77 69 74 68 20 74 68 |equester|.with th|
|00000d30| 65 20 67 69 76 65 6e 20 | 74 61 67 6c 69 73 74 2e |e given |taglist.|
|00000d40| 20 41 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 | A retur|n value |
|00000d50| 6f 66 20 46 41 4c 53 45 | 20 73 68 6f 75 6c 64 20 |of FALSE| should |
|00000d60| 62 65 0a 75 73 65 64 20 | 77 68 65 6e 20 73 6f 6d |be.used |when som|
|00000d70| 65 74 68 69 6e 67 20 77 | 65 6e 74 20 77 72 6f 6e |ething w|ent wron|
|00000d80| 67 2c 20 6e 6f 20 72 65 | 71 75 65 73 74 65 72 20 |g, no re|quester |
|00000d90| 77 69 6c 6c 20 62 65 20 | 6f 70 65 6e 65 64 0a 69 |will be |opened.i|
|00000da0| 6e 20 74 68 69 73 20 63 | 61 73 65 2e 0a 0a 46 6f |n this c|ase...Fo|
|00000db0| 72 20 66 69 6c 65 20 61 | 6e 64 20 66 6f 6e 74 20 |r file a|nd font |
|00000dc0| 72 65 71 75 65 73 74 65 | 72 2c 20 70 6f 70 61 73 |requeste|r, popas|
|00000dd0| 6c 20 63 6c 61 73 73 20 | 77 69 6c 6c 20 66 61 6c |l class |will fal|
|00000de0| 6c 20 62 61 63 6b 20 74 | 6f 20 61 0a 64 65 66 61 |l back t|o a.defa|
|00000df0| 75 6c 74 20 74 61 67 20 | 68 61 6e 64 6c 69 6e 67 |ult tag |handling|
|00000e00| 20 77 68 65 6e 20 6e 6f | 20 73 74 61 72 74 20 68 | when no| start h|
|00000e10| 6f 6f 6b 20 69 73 20 73 | 70 65 63 69 66 69 65 64 |ook is s|pecified|
|00000e20| 2e 20 41 20 66 69 6c 65 | 0a 6e 61 6d 65 20 69 73 |. A file|.name is|
|00000e30| 20 61 75 74 6f 6d 61 74 | 69 63 61 6c 6c 79 20 73 | automat|ically s|
|00000e40| 70 6c 69 74 20 69 6e 74 | 6f 20 70 61 74 68 20 61 |plit int|o path a|
|00000e50| 6e 64 20 66 69 6c 65 20 | 70 61 72 74 20 61 6e 64 |nd file |part and|
|00000e60| 20 70 61 73 73 65 64 0a | 74 6f 20 74 68 65 20 72 | passed.|to the r|
|00000e70| 65 71 75 65 73 74 65 72 | 20 61 20 41 53 4c 46 52 |equester| a ASLFR|
|00000e80| 5c 5f 49 6e 69 74 69 61 | 6c 46 69 6c 65 20 61 6e |\_Initia|lFile an|
|00000e90| 64 20 41 53 4c 46 52 5c | 5f 49 6e 69 74 69 61 6c |d ASLFR\|_Initial|
|00000ea0| 44 72 61 77 65 72 2e 0a | 41 20 66 6f 6e 74 20 72 |Drawer..|A font r|
|00000eb0| 65 71 75 65 73 74 65 72 | 20 73 70 6c 69 74 73 20 |equester| splits |
|00000ec0| 61 20 73 74 72 69 6e 67 | 20 6c 69 6b 65 20 27 27 |a string| like ''|
|00000ed0| 74 6f 70 61 7a 2f 38 27 | 27 20 69 6e 74 6f 0a 66 |topaz/8'|' into.f|
|00000ee0| 6f 6e 74 20 6e 61 6d 65 | 20 61 6e 64 20 73 69 7a |ont name| and siz|
|00000ef0| 65 20 66 6f 72 20 41 53 | 4c 46 4f 5c 5f 49 6e 69 |e for AS|LFO\_Ini|
|00000f00| 74 69 61 6c 4e 61 6d 65 | 20 61 6e 64 20 41 53 4c |tialName| and ASL|
|00000f10| 46 4f 5c 5f 49 6e 69 74 | 69 61 6c 53 69 7a 65 2e |FO\_Init|ialSize.|
|00000f20| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00000f30| 2a 7b 53 45 45 20 41 4c | 53 4f 7d 0a 4d 55 49 41 |*{SEE AL|SO}.MUIA|
|00000f40| 5c 5f 50 6f 70 61 73 6c | 5c 5f 53 74 6f 70 48 6f |\_Popasl|\_StopHo|
|00000f50| 6f 6b 2c 20 4d 55 49 41 | 5c 5f 50 6f 70 61 73 6c |ok, MUIA|\_Popasl|
|00000f60| 5c 5f 54 79 70 65 0a 0a | 5c 73 75 62 73 65 63 74 |\_Type..|\subsect|
|00000f70| 69 6f 6e 5b 4d 55 49 41 | 5c 5f 50 6f 70 61 73 6c |ion[MUIA|\_Popasl|
|00000f80| 5c 5f 53 74 6f 70 48 6f | 6f 6b 5d 7b 4d 55 49 41 |\_StopHo|ok]{MUIA|
|00000f90| 5c 5f 50 6f 70 61 73 6c | 5c 5f 53 74 6f 70 48 6f |\_Popasl|\_StopHo|
|00000fa0| 6f 6b 20 2d 2d 20 28 56 | 37 29 20 5b 49 53 47 5d |ok -- (V|7) [ISG]|
|00000fb0| 2c 20 73 74 72 75 63 74 | 20 48 6f 6f 6b 20 24 5c |, struct| Hook $\|
|00000fc0| 61 73 74 24 7d 0a 0a 5c | 73 75 62 73 75 62 73 65 |ast$}..\|subsubse|
|00000fd0| 63 74 69 6f 6e 2a 7b 46 | 55 4e 43 54 49 4f 4e 7d |ction*{F|UNCTION}|
|00000fe0| 0a 57 68 65 6e 20 74 68 | 65 20 72 65 71 75 65 73 |.When th|e reques|
|00000ff0| 74 65 72 20 74 65 72 6d | 69 6e 61 74 65 73 2c 20 |ter term|inates, |
|00001000| 4d 55 49 41 5c 5f 50 6f | 70 61 73 6c 5c 5f 53 74 |MUIA\_Po|pasl\_St|
|00001010| 6f 70 48 6f 6f 6b 20 77 | 69 6c 6c 20 62 65 0a 63 |opHook w|ill be.c|
|00001020| 61 6c 6c 65 64 20 77 69 | 74 68 20 61 20 70 6f 69 |alled wi|th a poi|
|00001030| 6e 74 65 72 20 74 6f 20 | 69 74 73 65 6c 66 20 69 |nter to |itself i|
|00001040| 6e 20 41 30 2c 20 61 20 | 70 6f 69 6e 74 65 72 20 |n A0, a |pointer |
|00001050| 74 6f 20 74 68 65 0a 70 | 6f 70 61 73 6c 20 6f 62 |to the.p|opasl ob|
|00001060| 6a 65 63 74 20 69 6e 20 | 41 32 20 61 6e 64 20 61 |ject in |A2 and a|
|00001070| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 74 68 65 20 | pointer| to the |
|00001080| 61 73 6c 20 72 65 71 75 | 65 73 74 65 72 0a 73 74 |asl requ|ester.st|
|00001090| 72 75 63 74 75 72 65 20 | 69 6e 20 41 31 2e 20 54 |ructure |in A1. T|
|000010a0| 68 65 20 68 6f 6f 6b 20 | 63 61 6e 20 74 68 65 6e |he hook |can then|
|000010b0| 20 70 61 72 73 65 20 74 | 68 65 20 72 65 71 75 65 | parse t|he reque|
|000010c0| 73 74 65 72 0a 73 74 72 | 75 63 74 75 72 65 20 61 |ster.str|ucture a|
|000010d0| 6e 64 20 73 65 74 20 74 | 68 65 20 73 74 72 69 6e |nd set t|he strin|
|000010e0| 67 20 67 61 64 67 65 74 | 73 20 63 6f 6e 74 65 6e |g gadget|s conten|
|000010f0| 74 73 20 72 65 73 70 65 | 63 74 69 76 65 6c 79 2e |ts respe|ctively.|
|00001100| 0a 0a 46 6f 72 20 66 69 | 6c 65 20 61 6e 64 20 66 |..For fi|le and f|
|00001110| 6f 6e 74 20 72 65 71 75 | 65 73 74 65 72 73 2c 20 |ont requ|esters, |
|00001120| 61 20 64 65 66 61 75 6c | 74 20 68 61 6e 64 6c 69 |a defaul|t handli|
|00001130| 6e 67 20 69 73 20 70 72 | 6f 76 69 64 65 64 2e 0a |ng is pr|ovided..|
|00001140| 0a 5c 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 2a |.\subsub|section*|
|00001150| 7b 53 45 45 20 41 4c 53 | 4f 7d 0a 4d 55 49 41 5c |{SEE ALS|O}.MUIA\|
|00001160| 5f 50 6f 70 61 73 6c 5c | 5f 53 74 61 72 74 48 6f |_Popasl\|_StartHo|
|00001170| 6f 6b 2c 20 4d 55 49 41 | 5c 5f 50 6f 70 61 73 6c |ok, MUIA|\_Popasl|
|00001180| 5c 5f 54 79 70 65 0a 0a | 5c 73 75 62 73 65 63 74 |\_Type..|\subsect|
|00001190| 69 6f 6e 5b 4d 55 49 41 | 5c 5f 50 6f 70 61 73 6c |ion[MUIA|\_Popasl|
|000011a0| 5c 5f 54 79 70 65 5d 7b | 4d 55 49 41 5c 5f 50 6f |\_Type]{|MUIA\_Po|
|000011b0| 70 61 73 6c 5c 5f 54 79 | 70 65 20 2d 2d 20 28 56 |pasl\_Ty|pe -- (V|
|000011c0| 37 29 20 5b 49 2e 47 5d | 2c 20 55 4c 4f 4e 47 7d |7) [I.G]|, ULONG}|
|000011d0| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|000011e0| 2a 7b 46 55 4e 43 54 49 | 4f 4e 7d 0a 54 68 69 73 |*{FUNCTI|ON}.This|
|000011f0| 20 74 61 67 20 61 6c 6c | 6f 77 73 20 74 6f 20 73 | tag all|ows to s|
|00001200| 65 74 20 74 68 65 20 74 | 79 70 65 20 6f 66 20 61 |et the t|ype of a|
|00001210| 73 6c 20 72 65 71 75 65 | 73 74 65 72 2e 20 50 61 |sl reque|ster. Pa|
|00001220| 73 73 0a 74 68 65 20 73 | 61 6d 65 20 76 61 6c 75 |ss.the s|ame valu|
|00001230| 65 20 79 6f 75 20 77 6f | 75 6c 64 20 75 73 65 20 |e you wo|uld use |
|00001240| 66 6f 72 20 41 6c 6c 6f | 63 41 73 6c 52 65 71 75 |for Allo|cAslRequ|
|00001250| 65 73 74 28 29 2c 20 65 | 2e 67 2e 0a 41 53 4c 5c |est(), e|.g..ASL\|
|00001260| 5f 46 69 6c 65 52 65 71 | 75 65 73 74 2c 20 41 53 |_FileReq|uest, AS|
|00001270| 4c 5c 5f 46 6f 6e 74 52 | 65 71 75 65 73 74 20 6f |L\_FontR|equest o|
|00001280| 72 20 41 53 4c 5c 5f 53 | 63 72 65 65 6e 4d 6f 64 |r ASL\_S|creenMod|
|00001290| 65 52 65 71 75 65 73 74 | 2e 0a 0a 46 6f 72 20 41 |eRequest|...For A|
|000012a0| 53 4c 5c 5f 46 69 6c 65 | 52 65 71 75 65 73 74 20 |SL\_File|Request |
|000012b0| 61 6e 64 20 41 53 4c 5c | 5f 46 6f 6e 74 52 65 71 |and ASL\|_FontReq|
|000012c0| 75 65 73 74 2c 20 70 6f | 70 61 73 6c 20 63 6c 61 |uest, po|pasl cla|
|000012d0| 73 73 20 6f 66 66 65 72 | 73 20 61 0a 61 20 73 74 |ss offer|s a.a st|
|000012e0| 61 6e 64 61 72 64 20 73 | 74 61 72 74 2f 73 74 6f |andard s|tart/sto|
|000012f0| 70 20 68 61 6e 64 6c 69 | 6e 67 2e 20 57 68 65 6e |p handli|ng. When|
|00001300| 20 61 20 66 69 6c 65 20 | 72 65 71 75 65 73 74 65 | a file |requeste|
|00001310| 72 20 69 73 20 6f 70 65 | 6e 65 64 2c 0a 4d 55 49 |r is ope|ned,.MUI|
|00001320| 20 73 70 6c 69 74 73 20 | 74 68 65 20 73 74 72 69 | splits |the stri|
|00001330| 6e 67 20 67 61 64 67 65 | 74 73 20 63 6f 6e 74 65 |ng gadge|ts conte|
|00001340| 6e 74 73 20 69 6e 74 6f | 20 61 20 70 61 74 68 20 |nts into| a path |
|00001350| 61 6e 64 20 61 20 66 69 | 6c 65 0a 6e 61 6d 65 20 |and a fi|le.name |
|00001360| 61 6e 64 20 75 73 65 73 | 20 74 68 65 73 65 20 61 |and uses| these a|
|00001370| 73 20 69 6e 69 74 69 61 | 6c 20 70 61 72 65 6d 65 |s initia|l pareme|
|00001380| 74 65 72 73 20 66 6f 72 | 20 74 68 65 20 72 65 71 |ters for| the req|
|00001390| 75 65 73 74 65 72 2e 0a | 46 6f 6e 74 20 70 6f 70 |uester..|Font pop|
|000013a0| 75 70 73 20 74 72 61 6e | 73 6c 61 74 65 20 61 20 |ups tran|slate a |
|000013b0| 66 6f 6e 74 20 69 6e 74 | 6f 20 61 20 6e 61 6d 65 |font int|o a name|
|000013c0| 2f 73 69 7a 65 20 70 61 | 69 72 2c 20 65 2e 67 2e |/size pa|ir, e.g.|
|000013d0| 0a 27 27 74 6f 70 61 7a | 2f 38 27 27 2e 20 59 6f |.''topaz|/8''. Yo|
|000013e0| 75 20 63 61 6e 20 6f 76 | 65 72 72 69 64 65 20 74 |u can ov|erride t|
|000013f0| 68 65 73 65 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |hese tra|nslation|
|00001400| 73 20 62 79 20 73 70 65 | 63 69 66 79 69 6e 67 0a |s by spe|cifying.|
|00001410| 61 20 4d 55 49 41 5c 5f | 50 6f 70 61 73 6c 5c 5f |a MUIA\_|Popasl\_|
|00001420| 53 74 61 72 74 48 6f 6f | 6b 20 61 6e 64 20 61 20 |StartHoo|k and a |
|00001430| 4d 55 49 41 5c 5f 50 6f | 70 61 73 6c 5c 5f 53 74 |MUIA\_Po|pasl\_St|
|00001440| 6f 70 48 6f 6f 6b 2e 0a | 0a 46 6f 72 20 41 53 4c |opHook..|.For ASL|
|00001450| 5c 5f 53 63 72 65 65 6e | 4d 6f 64 65 52 65 71 75 |\_Screen|ModeRequ|
|00001460| 65 73 74 2c 20 6e 6f 20 | 73 74 61 6e 64 61 72 64 |est, no |standard|
|00001470| 20 68 61 6e 64 6c 69 6e | 67 20 69 73 20 61 76 61 | handlin|g is ava|
|00001480| 69 6c 61 62 6c 65 2e 0a | 55 73 69 6e 67 20 73 75 |ilable..|Using su|
|00001490| 63 68 20 61 20 70 6f 70 | 75 70 20 77 69 74 68 6f |ch a pop|up witho|
|000014a0| 75 74 20 53 74 61 72 74 | 20 61 6e 64 20 53 74 6f |ut Start| and Sto|
|000014b0| 70 20 68 6f 6f 6b 73 20 | 77 6f 6e 27 74 20 6d 61 |p hooks |won't ma|
|000014c0| 6b 65 0a 6d 75 63 68 20 | 73 65 6e 73 65 2e 0a 0a |ke.much |sense...|
|000014d0| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|000014e0| 53 45 45 20 41 4c 53 4f | 7d 0a 4d 55 49 41 5c 5f |SEE ALSO|}.MUIA\_|
|000014f0| 50 6f 70 61 73 6c 5c 5f | 53 74 61 72 74 48 6f 6f |Popasl\_|StartHoo|
|00001500| 6b 2c 20 4d 55 49 41 5c | 5f 50 6f 70 61 73 6c 5c |k, MUIA\|_Popasl\|
|00001510| 5f 53 74 6f 70 48 6f 6f | 6b 0a 0a 0a 0a          |_StopHoo|k....   |
+--------+-------------------------+-------------------------+--------+--------+