home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| C source, ISO-8859 text
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 6d 75 69 6d 61 73 74 |\section|{muimast|
|00000010| 65 72 2e 6c 69 62 72 61 | 72 79 7d 0a 0a 5c 73 75 |er.libra|ry}..\su|
|00000020| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 50 55 52 |bsubsect|ion*{PUR|
|00000030| 50 4f 53 45 7d 0a 6d 75 | 69 6d 61 73 74 65 72 2e |POSE}.mu|imaster.|
|00000040| 6c 69 62 72 61 72 79 20 | 63 6f 6e 74 61 69 6e 73 |library |contains|
|00000050| 20 66 75 6e 63 74 69 6f | 6e 73 20 66 6f 72 20 63 | functio|ns for c|
|00000060| 72 65 61 74 69 6e 67 20 | 61 6e 64 20 64 69 70 6f |reating |and dipo|
|00000070| 73 69 6e 67 0a 6f 62 6a | 65 63 74 73 2c 20 66 6f |sing.obj|ects, fo|
|00000080| 72 20 72 65 71 75 65 73 | 74 65 72 20 68 61 6e 64 |r reques|ter hand|
|00000090| 6c 69 6e 67 20 61 6e 64 | 20 66 6f 72 20 63 6f 6e |ling and| for con|
|000000a0| 74 72 6f 6c 6c 69 6e 67 | 20 63 75 73 74 6f 6d 0a |trolling| custom.|
|000000b0| 63 6c 61 73 73 65 73 2e | 20 41 64 64 69 74 69 6f |classes.| Additio|
|000000c0| 6e 61 6c 6c 79 2c 20 73 | 65 76 65 72 61 6c 20 6f |nally, s|everal o|
|000000d0| 66 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 4d |f the st|andard M|
|000000e0| 55 49 20 63 6c 61 73 73 | 65 73 20 61 72 65 0a 62 |UI class|es are.b|
|000000f0| 75 69 6c 74 20 69 6e 74 | 6f 20 6d 75 69 6d 61 73 |uilt int|o muimas|
|00000100| 74 65 72 2e 6c 69 62 72 | 61 72 79 2e 20 46 6f 72 |ter.libr|ary. For|
|00000110| 20 79 6f 75 20 61 73 20 | 61 20 70 72 6f 67 72 61 | you as |a progra|
|00000120| 6d 6d 65 72 2c 20 74 68 | 65 72 65 0a 69 73 20 6e |mmer, th|ere.is n|
|00000130| 6f 20 64 69 66 66 65 72 | 65 6e 63 65 20 62 65 74 |o differ|ence bet|
|00000140| 77 65 65 6e 20 75 73 69 | 6e 67 20 61 20 62 75 69 |ween usi|ng a bui|
|00000150| 6c 74 69 6e 20 63 6c 61 | 73 73 20 6f 72 20 61 6e |ltin cla|ss or an|
|00000160| 20 65 78 74 65 72 6e 61 | 6c 0a 63 6c 61 73 73 20 | externa|l.class |
|00000170| 63 6f 6d 69 6e 67 20 61 | 73 20 27 27 73 79 73 3a |coming a|s ''sys:|
|00000180| 63 6c 61 73 73 65 73 2f | 3c 66 6f 6f 62 61 72 3e |classes/|<foobar>|
|00000190| 2e 6d 75 69 27 27 2e 20 | 54 68 65 20 4d 55 49 20 |.mui''. |The MUI |
|000001a0| 6f 62 6a 65 63 74 0a 67 | 65 6e 65 72 61 74 69 6f |object.g|eneratio|
|000001b0| 6e 20 63 61 6c 6c 20 74 | 61 6b 65 73 20 63 61 72 |n call t|akes car|
|000001c0| 65 20 6f 66 20 74 68 69 | 73 20 73 69 74 75 61 74 |e of thi|s situat|
|000001d0| 69 6f 6e 20 61 6e 64 20 | 6c 6f 61 64 73 0a 65 78 |ion and |loads.ex|
|000001e0| 74 65 72 6e 61 6c 20 63 | 6c 61 73 73 65 73 20 61 |ternal c|lasses a|
|000001f0| 75 74 6f 6d 61 74 69 63 | 61 6c 6c 79 20 77 68 65 |utomatic|ally whe|
|00000200| 6e 20 74 68 65 79 20 61 | 72 65 20 6e 65 65 64 65 |n they a|re neede|
|00000210| 64 2e 0a 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |d....\su|bsection|
|00000220| 5b 4d 55 49 5c 5f 41 6c | 6c 6f 63 41 73 6c 52 65 |[MUI\_Al|locAslRe|
|00000230| 71 75 65 73 74 5d 7b 4d | 55 49 5c 5f 41 6c 6c 6f |quest]{M|UI\_Allo|
|00000240| 63 41 73 6c 52 65 71 75 | 65 73 74 7d 0a 0a 5c 73 |cAslRequ|est}..\s|
|00000250| 75 62 73 75 62 73 65 63 | 74 69 6f 6e 2a 7b 46 55 |ubsubsec|tion*{FU|
|00000260| 4e 43 54 49 4f 4e 7d 0a | 50 72 6f 76 69 64 65 20 |NCTION}.|Provide |
|00000270| 61 6e 20 69 6e 74 65 72 | 66 61 63 65 20 74 6f 20 |an inter|face to |
|00000280| 61 73 6c 2e 6c 69 62 72 | 61 72 79 2e 20 55 73 69 |asl.libr|ary. Usi|
|00000290| 6e 67 20 74 68 69 73 20 | 65 6e 73 75 72 65 73 0a |ng this |ensures.|
|000002a0| 79 6f 75 72 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |your app|lication|
|000002b0| 20 77 69 6c 6c 20 62 65 | 6e 65 66 69 74 20 66 72 | will be|nefit fr|
|000002c0| 6f 6d 20 66 75 74 75 72 | 65 20 65 78 70 61 6e 73 |om futur|e expans|
|000002d0| 69 6f 6e 73 0a 74 6f 20 | 4d 55 49 27 73 20 77 69 |ions.to |MUI's wi|
|000002e0| 6e 64 6f 77 20 61 6e 64 | 20 69 63 6f 6e 69 66 69 |ndow and| iconifi|
|000002f0| 63 61 74 69 6f 6e 20 68 | 61 6e 64 6c 69 6e 67 2e |cation h|andling.|
|00000300| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00000310| 2a 7b 53 45 45 20 41 4c | 53 4f 7d 0a 61 73 6c 2e |*{SEE AL|SO}.asl.|
|00000320| 6c 69 62 72 61 72 79 2f | 41 6c 6c 6f 63 41 73 6c |library/|AllocAsl|
|00000330| 52 65 71 75 65 73 74 0a | 0a 0a 5c 73 75 62 73 65 |Request.|..\subse|
|00000340| 63 74 69 6f 6e 5b 4d 55 | 49 5c 5f 41 73 6c 52 65 |ction[MU|I\_AslRe|
|00000350| 71 75 65 73 74 5d 7b 4d | 55 49 5c 5f 41 73 6c 52 |quest]{M|UI\_AslR|
|00000360| 65 71 75 65 73 74 7d 0a | 0a 5c 73 75 62 73 75 62 |equest}.|.\subsub|
|00000370| 73 65 63 74 69 6f 6e 2a | 7b 46 55 4e 43 54 49 4f |section*|{FUNCTIO|
|00000380| 4e 7d 0a 50 72 6f 76 69 | 64 65 20 61 6e 20 69 6e |N}.Provi|de an in|
|00000390| 74 65 72 66 61 63 65 20 | 74 6f 20 61 73 6c 2e 6c |terface |to asl.l|
|000003a0| 69 62 72 61 72 79 2e 20 | 55 73 69 6e 67 20 74 68 |ibrary. |Using th|
|000003b0| 69 73 20 65 6e 73 75 72 | 65 73 0a 79 6f 75 72 20 |is ensur|es.your |
|000003c0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 77 69 6c 6c |applicat|ion will|
|000003d0| 20 62 65 6e 65 66 69 74 | 20 66 72 6f 6d 20 66 75 | benefit| from fu|
|000003e0| 74 75 72 65 20 65 78 70 | 61 6e 73 69 6f 6e 73 0a |ture exp|ansions.|
|000003f0| 74 6f 20 4d 55 49 27 73 | 20 77 69 6e 64 6f 77 20 |to MUI's| window |
|00000400| 61 6e 64 20 69 63 6f 6e | 69 66 69 63 61 74 69 6f |and icon|ificatio|
|00000410| 6e 20 68 61 6e 64 6c 69 | 6e 67 2e 0a 0a 5c 73 75 |n handli|ng...\su|
|00000420| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 53 45 45 |bsubsect|ion*{SEE|
|00000430| 20 41 4c 53 4f 7d 0a 61 | 73 6c 2e 6c 69 62 72 61 | ALSO}.a|sl.libra|
|00000440| 72 79 2f 41 73 6c 52 65 | 71 75 65 73 74 0a 0a 0a |ry/AslRe|quest...|
|00000450| 5c 73 75 62 73 65 63 74 | 69 6f 6e 5b 4d 55 49 5c |\subsect|ion[MUI\|
|00000460| 5f 43 72 65 61 74 65 43 | 75 73 74 6f 6d 43 6c 61 |_CreateC|ustomCla|
|00000470| 73 73 5d 7b 4d 55 49 5c | 5f 43 72 65 61 74 65 43 |ss]{MUI\|_CreateC|
|00000480| 75 73 74 6f 6d 43 6c 61 | 73 73 20 2d 2d 20 63 72 |ustomCla|ss -- cr|
|00000490| 65 61 74 65 20 61 20 70 | 75 62 6c 69 63 2f 70 72 |eate a p|ublic/pr|
|000004a0| 69 76 61 74 65 20 63 75 | 73 74 6f 6d 20 63 6c 61 |ivate cu|stom cla|
|000004b0| 73 73 2e 7d 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |ss.}..\s|ubsubsec|
|000004c0| 74 69 6f 6e 2a 7b 53 59 | 4e 4f 50 53 49 53 7d 0a |tion*{SY|NOPSIS}.|
|000004d0| 5c 62 65 67 69 6e 7b 74 | 61 62 62 69 6e 67 7d 0a |\begin{t|abbing}.|
|000004e0| 4d 55 49 5c 5f 43 72 65 | 61 74 65 43 75 73 74 6f |MUI\_Cre|ateCusto|
|000004f0| 6d 43 6c 61 73 73 20 28 | 5c 3d 62 61 73 65 2c 20 |mClass (|\=base, |
|00000500| 5c 3d 73 75 70 65 72 6e | 61 6d 65 2c 20 5c 3d 73 |\=supern|ame, \=s|
|00000510| 75 70 65 72 6d 63 63 2c | 20 5c 3d 64 61 74 61 73 |upermcc,| \=datas|
|00000520| 69 7a 65 2c 20 5c 3d 64 | 69 73 70 66 75 6e 63 29 |ize, \=d|ispfunc)|
|00000530| 5c 5c 0a 5c 3e 41 30 20 | 20 20 20 5c 3e 41 31 20 |\\.\>A0 | \>A1 |
|00000540| 20 20 20 20 20 20 20 5c | 3e 41 32 20 20 20 20 20 | \|>A2 |
|00000550| 20 20 20 5c 3e 44 30 20 | 20 20 20 20 20 20 20 5c | \>D0 | \|
|00000560| 3e 41 33 0a 5c 65 6e 64 | 7b 74 61 62 62 69 6e 67 |>A3.\end|{tabbing|
|00000570| 7d 0a 0a 73 74 72 75 63 | 74 20 4d 55 49 5c 5f 43 |}..struc|t MUI\_C|
|00000580| 75 73 74 6f 6d 43 6c 61 | 73 73 20 24 5c 61 73 74 |ustomCla|ss $\ast|
|00000590| 24 20 4d 55 49 5c 5f 43 | 72 65 61 74 65 43 75 73 |$ MUI\_C|reateCus|
|000005a0| 74 6f 6d 43 6c 61 73 73 | 28 0a 73 74 72 75 63 74 |tomClass|(.struct|
|000005b0| 20 4c 69 62 72 61 72 79 | 20 24 5c 61 73 74 24 2c | Library| $\ast$,|
|000005c0| 20 63 68 61 72 20 24 5c | 61 73 74 24 2c 20 69 6e | char $\|ast$, in|
|000005d0| 74 2c 20 41 50 54 52 20 | 29 3b 0a 0a a0 20 20 5c |t, APTR |);... \|
|000005e0| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 46 |subsubse|ction*{F|
|000005f0| 55 4e 43 54 49 4f 4e 7d | 0a 54 68 69 73 20 66 75 |UNCTION}|.This fu|
|00000600| 6e 63 74 69 6f 6e 20 63 | 72 65 61 74 65 73 20 61 |nction c|reates a|
|00000610| 20 70 75 62 6c 69 63 20 | 6f 72 20 70 72 69 76 61 | public |or priva|
|00000620| 74 65 20 4d 55 49 20 63 | 75 73 74 6f 6d 20 63 6c |te MUI c|ustom cl|
|00000630| 61 73 73 2e 0a 50 75 62 | 6c 69 63 20 63 75 73 74 |ass..Pub|lic cust|
|00000640| 6f 6d 20 63 6c 61 73 73 | 65 73 20 61 72 65 20 73 |om class|es are s|
|00000650| 68 61 72 65 64 20 6c 69 | 62 72 61 72 69 65 73 20 |hared li|braries |
|00000660| 61 6e 64 20 63 61 6e 20 | 62 65 20 66 6f 75 6e 64 |and can |be found|
|00000670| 0a 69 6e 20 27 27 6c 69 | 62 73 3a 6d 75 69 2f 3c |.in ''li|bs:mui/<|
|00000680| 66 6f 6f 62 61 72 3e 2e | 6d 63 63 27 27 2e 20 50 |foobar>.|mcc''. P|
|00000690| 72 69 76 61 74 65 20 63 | 6c 61 73 73 65 73 20 73 |rivate c|lasses s|
|000006a0| 69 6d 70 6c 79 20 63 6f | 6e 73 69 73 74 0a 6f 66 |imply co|nsist.of|
|000006b0| 20 61 20 64 69 73 70 61 | 74 63 68 65 72 20 61 6e | a dispa|tcher an|
|000006c0| 64 20 61 72 65 20 62 75 | 69 6c 74 20 69 6e 74 6f |d are bu|ilt into|
|000006d0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 2e 0a 0a | applica|tions...|
|000006e0| 4d 55 49 5c 5f 43 72 65 | 61 74 65 43 75 73 74 6f |MUI\_Cre|ateCusto|
|000006f0| 6d 43 6c 61 73 73 28 29 | 20 72 65 74 75 72 6e 73 |mClass()| returns|
|00000700| 20 61 20 70 6f 69 6e 74 | 65 72 20 74 6f 20 61 20 | a point|er to a |
|00000710| 73 74 72 75 63 74 0a 4d | 55 49 5c 5f 43 75 73 74 |struct.M|UI\_Cust|
|00000720| 6f 6d 43 6c 61 73 73 20 | 77 68 69 63 68 20 69 6e |omClass |which in|
|00000730| 20 74 75 72 6e 20 63 6f | 6e 74 61 69 6e 73 20 61 | turn co|ntains a|
|00000740| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 61 0a 73 74 | pointer| to a.st|
|00000750| 72 75 63 74 20 49 43 6c | 61 73 73 2e 20 46 6f 72 |ruct ICl|ass. For|
|00000760| 20 70 72 69 76 61 74 65 | 20 63 6c 61 73 73 65 73 | private| classes|
|00000770| 2c 20 74 68 69 73 20 73 | 74 72 75 63 74 20 49 43 |, this s|truct IC|
|00000780| 6c 61 73 73 0a 70 6f 69 | 6e 74 65 72 20 6e 65 65 |lass.poi|nter nee|
|00000790| 64 73 20 74 6f 20 62 65 | 20 66 65 64 20 74 6f 20 |ds to be| fed to |
|000007a0| 61 20 69 6e 74 75 69 74 | 69 6f 6e 2e 6c 69 62 72 |a intuit|ion.libr|
|000007b0| 61 72 79 2f 4e 65 77 4f | 62 6a 65 63 74 28 29 0a |ary/NewO|bject().|
|000007c0| 63 61 6c 6c 20 74 6f 20 | 63 72 65 61 74 65 20 6e |call to |create n|
|000007d0| 65 77 20 6f 62 6a 65 63 | 74 73 2e 0a 0a 4d 55 49 |ew objec|ts...MUI|
|000007e0| 20 63 72 65 61 74 65 73 | 20 74 68 65 20 64 69 73 | creates| the dis|
|000007f0| 70 61 74 63 68 65 72 20 | 68 6f 6f 6b 20 66 6f 72 |patcher |hook for|
|00000800| 20 79 6f 75 2c 20 79 6f | 75 20 6d 61 79 20 7b 5c | you, yo|u may {\|
|00000810| 62 66 20 6e 6f 74 7d 0a | 75 73 65 20 74 68 65 20 |bf not}.|use the |
|00000820| 49 43 6c 61 73 73 2d 3e | 63 6c 5c 5f 44 69 73 70 |IClass->|cl\_Disp|
|00000830| 61 74 63 68 65 72 2e 68 | 5c 5f 44 61 74 61 20 66 |atcher.h|\_Data f|
|00000840| 69 65 6c 64 21 20 49 66 | 20 79 6f 75 20 6e 65 65 |ield! If| you nee|
|00000850| 64 0a 63 75 73 74 6f 6d | 20 64 61 74 61 20 66 6f |d.custom| data fo|
|00000860| 72 20 79 6f 75 72 20 64 | 69 73 70 61 74 63 68 65 |r your d|ispatche|
|00000870| 72 2c 20 75 73 65 20 74 | 68 65 20 63 6c 5c 5f 55 |r, use t|he cl\_U|
|00000880| 73 65 72 44 61 74 61 0a | 6f 66 20 74 68 65 20 49 |serData.|of the I|
|00000890| 43 6c 61 73 73 20 73 74 | 72 75 63 74 75 72 65 20 |Class st|ructure |
|000008a0| 6f 72 20 74 68 65 20 6d | 63 63 5c 5f 55 73 65 72 |or the m|cc\_User|
|000008b0| 44 61 74 61 20 6f 66 20 | 74 68 65 0a 4d 55 49 5c |Data of |the.MUI\|
|000008c0| 5f 43 75 73 74 6f 6d 43 | 6c 61 73 73 20 73 74 72 |_CustomC|lass str|
|000008d0| 75 63 74 75 72 65 2e 0a | 0a 46 6f 72 20 70 75 62 |ucture..|.For pub|
|000008e0| 6c 69 63 20 63 6c 61 73 | 73 65 73 2c 20 4d 55 49 |lic clas|ses, MUI|
|000008f0| 20 6d 61 6b 65 73 20 73 | 75 72 65 20 74 68 61 74 | makes s|ure that|
|00000900| 20 61 36 20 63 6f 6e 74 | 61 69 6e 73 0a 61 20 70 | a6 cont|ains.a p|
|00000910| 6f 69 6e 74 65 72 20 74 | 6f 20 79 6f 75 72 20 6c |ointer t|o your l|
|00000920| 69 62 72 61 72 79 20 62 | 61 73 65 20 77 68 65 6e |ibrary b|ase when|
|00000930| 20 79 6f 75 72 20 64 69 | 73 70 61 74 63 68 65 72 | your di|spatcher|
|00000940| 0a 69 73 20 63 61 6c 6c | 65 64 2e 20 46 6f 72 20 |.is call|ed. For |
|00000950| 70 72 69 76 61 74 65 20 | 63 6c 61 73 73 65 73 2c |private |classes,|
|00000960| 20 79 6f 75 20 77 69 6c | 6c 20 6e 65 65 64 20 74 | you wil|l need t|
|00000970| 6f 20 6b 65 65 70 0a 74 | 72 61 63 6b 20 6f 66 20 |o keep.t|rack of |
|00000980| 41 34 20 6f 66 20 73 69 | 6d 69 6c 69 61 72 20 74 |A4 of si|miliar t|
|00000990| 68 69 6e 67 73 20 79 6f | 75 72 20 63 6f 6d 70 69 |hings yo|ur compi|
|000009a0| 6c 65 72 20 6d 61 79 0a | 6e 65 65 64 20 79 6f 75 |ler may.|need you|
|000009b0| 72 73 65 6c 66 2e 0a 0a | 5c 73 75 62 73 75 62 73 |rself...|\subsubs|
|000009c0| 65 63 74 69 6f 6e 2a 7b | 49 4e 50 55 54 53 7d 0a |ection*{|INPUTS}.|
|000009d0| 5c 62 65 67 69 6e 7b 64 | 65 73 63 72 69 70 74 69 |\begin{d|escripti|
|000009e0| 6f 6e 7d 0a 5c 69 74 65 | 6d 5b 62 61 73 65 5d 20 |on}.\ite|m[base] |
|000009f0| 3d 20 20 20 20 20 20 69 | 66 20 79 6f 75 20 63 72 |= i|f you cr|
|00000a00| 65 61 74 65 20 61 20 70 | 75 62 6c 69 63 20 63 6c |eate a p|ublic cl|
|00000a10| 61 73 73 2c 20 79 6f 75 | 20 68 61 76 65 20 74 6f |ass, you| have to|
|00000a20| 20 63 61 6c 6c 0a 4d 55 | 49 5c 5f 43 72 65 61 74 | call.MU|I\_Creat|
|00000a30| 65 43 75 73 74 6f 6d 43 | 6c 61 73 73 28 29 20 66 |eCustomC|lass() f|
|00000a40| 72 6f 6d 20 79 6f 75 72 | 20 6c 69 62 72 61 72 69 |rom your| librari|
|00000a50| 65 73 0a 69 6e 69 74 20 | 66 75 6e 63 74 69 6f 6e |es.init |function|
|00000a60| 2e 20 49 6e 20 74 68 69 | 73 20 63 61 73 65 2c 20 |. In thi|s case, |
|00000a70| 70 6c 61 63 65 20 79 6f | 75 72 20 6c 69 62 72 61 |place yo|ur libra|
|00000a80| 72 79 0a 62 61 73 65 20 | 70 6f 69 6e 74 65 72 20 |ry.base |pointer |
|00000a90| 68 65 72 65 2e 20 46 6f | 72 20 70 72 69 76 61 74 |here. Fo|r privat|
|00000aa0| 65 20 63 6c 61 73 73 65 | 73 2c 20 79 6f 75 20 6d |e classe|s, you m|
|00000ab0| 75 73 74 0a 73 75 70 70 | 6c 79 20 4e 55 4c 4c 2e |ust.supp|ly NULL.|
|00000ac0| 0a 0a 5c 69 74 65 6d 5b | 73 75 70 65 72 6e 61 6d |..\item[|supernam|
|00000ad0| 65 5d 20 3d 20 73 75 70 | 65 72 20 63 6c 61 73 73 |e] = sup|er class|
|00000ae0| 20 6f 66 20 79 6f 75 72 | 20 63 6c 61 73 73 2e 20 | of your| class. |
|00000af0| 54 68 69 73 20 63 61 6e | 20 65 69 74 68 65 72 0a |This can| either.|
|00000b00| 62 65 20 61 20 62 75 69 | 6c 74 69 6e 20 4d 55 49 |be a bui|ltin MUI|
|00000b10| 20 63 6c 61 73 73 20 28 | 27 27 78 79 7a 2e 6d 75 | class (|''xyz.mu|
|00000b20| 69 27 27 29 20 6f 72 20 | 61 20 65 78 74 65 72 6e |i'') or |a extern|
|00000b30| 61 6c 0a 63 75 73 74 6f | 6d 20 63 6c 61 73 73 20 |al.custo|m class |
|00000b40| 28 27 27 78 79 7a 2e 6d | 63 63 27 27 29 2e 0a 0a |(''xyz.m|cc'')...|
|00000b50| 5c 69 74 65 6d 5b 73 75 | 70 65 72 6d 63 63 5d 20 |\item[su|permcc] |
|00000b60| 3d 20 20 69 66 20 28 61 | 6e 64 20 6f 6e 6c 79 20 |= if (a|nd only |
|00000b70| 69 66 29 20 74 68 65 20 | 73 75 70 65 72 20 63 6c |if) the |super cl|
|00000b80| 61 73 73 20 69 73 20 61 | 20 70 72 69 76 61 74 65 |ass is a| private|
|00000b90| 0a 63 75 73 74 6f 6d 20 | 63 6c 61 73 73 20 61 6e |.custom |class an|
|00000ba0| 64 20 68 65 6e 63 65 20 | 68 61 73 20 6e 6f 20 6e |d hence |has no n|
|00000bb0| 61 6d 65 2c 20 79 6f 75 | 20 61 72 65 20 61 6c 6c |ame, you| are all|
|00000bc0| 6f 77 65 64 0a 74 6f 20 | 70 61 73 73 20 61 20 4e |owed.to |pass a N|
|00000bd0| 55 4c 4c 20 73 75 70 65 | 72 6e 61 6d 65 20 61 6e |ULL supe|rname an|
|00000be0| 64 20 61 20 70 6f 69 6e | 74 65 72 20 74 6f 20 74 |d a poin|ter to t|
|00000bf0| 68 65 0a 4d 55 49 5c 5f | 43 75 73 74 6f 6d 43 6c |he.MUI\_|CustomCl|
|00000c00| 61 73 73 20 73 74 72 75 | 63 74 75 72 65 20 6f 66 |ass stru|cture of|
|00000c10| 20 74 68 65 20 73 75 70 | 65 72 20 63 6c 61 73 73 | the sup|er class|
|00000c20| 20 68 65 72 65 2e 0a 0a | 5c 69 74 65 6d 5b 64 61 | here...|\item[da|
|00000c30| 74 61 73 69 7a 65 5d 20 | 3d 20 20 73 69 7a 65 20 |tasize] |= size |
|00000c40| 6f 66 20 79 6f 75 72 20 | 63 6c 61 73 73 65 73 20 |of your |classes |
|00000c50| 64 61 74 61 20 73 74 72 | 75 63 74 75 72 65 2e 0a |data str|ucture..|
|00000c60| 0a 5c 69 74 65 6d 5b 64 | 69 73 70 66 75 6e 63 5d |.\item[d|ispfunc]|
|00000c70| 20 3d 20 20 79 6f 75 72 | 20 63 6c 61 73 73 65 73 | = your| classes|
|00000c80| 20 64 69 73 70 61 74 63 | 68 65 72 20 66 75 6e 63 | dispatc|her func|
|00000c90| 74 69 6f 6e 20 28 6e 6f | 20 68 6f 6f 6b 21 29 2e |tion (no| hook!).|
|00000ca0| 0a 54 68 65 20 64 69 73 | 70 61 74 63 68 65 72 20 |.The dis|patcher |
|00000cb0| 77 69 6c 6c 20 62 65 20 | 63 61 6c 6c 65 64 20 77 |will be |called w|
|00000cc0| 69 74 68 20 61 20 73 74 | 72 75 63 74 20 49 43 6c |ith a st|ruct ICl|
|00000cd0| 61 73 73 0a 69 6e 20 61 | 30 2c 20 77 69 74 68 20 |ass.in a|0, with |
|00000ce0| 79 6f 75 72 20 6f 62 6a | 65 63 74 20 69 6e 20 61 |your obj|ect in a|
|00000cf0| 32 20 61 6e 64 20 74 68 | 65 20 6d 65 73 73 61 67 |2 and th|e messag|
|00000d00| 65 20 69 6e 20 61 31 2e | 0a 5c 65 6e 64 7b 64 65 |e in a1.|.\end{de|
|00000d10| 73 63 72 69 70 74 69 6f | 6e 7d 0a 0a 5c 73 75 62 |scriptio|n}..\sub|
|00000d20| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 52 45 53 55 |subsecti|on*{RESU|
|00000d30| 4c 54 7d 0a 41 20 70 6f | 69 6e 74 65 72 20 74 6f |LT}.A po|inter to|
|00000d40| 20 61 20 73 74 72 75 63 | 74 20 4d 55 49 5c 5f 43 | a struc|t MUI\_C|
|00000d50| 75 73 74 6f 6d 43 6c 61 | 73 73 20 6f 72 20 4e 55 |ustomCla|ss or NU|
|00000d60| 4c 4c 20 74 6f 20 69 6e | 64 69 63 61 74 65 0a 61 |LL to in|dicate.a|
|00000d70| 6e 20 65 72 72 6f 72 2e | 0a 0a 5c 73 75 62 73 75 |n error.|..\subsu|
|00000d80| 62 73 65 63 74 69 6f 6e | 2a 7b 53 45 45 20 41 4c |bsection|*{SEE AL|
|00000d90| 53 4f 7d 0a 4d 55 49 5c | 5f 44 65 6c 65 74 65 43 |SO}.MUI\|_DeleteC|
|00000da0| 75 73 74 6f 6d 43 6c 61 | 73 73 28 29 0a 0a 0a 5c |ustomCla|ss()...\|
|00000db0| 73 75 62 73 65 63 74 69 | 6f 6e 5b 4d 55 49 5c 5f |subsecti|on[MUI\_|
|00000dc0| 44 65 6c 65 74 65 43 75 | 73 74 6f 6d 43 6c 61 73 |DeleteCu|stomClas|
|00000dd0| 73 5d 7b 4d 55 49 5c 5f | 44 65 6c 65 74 65 43 75 |s]{MUI\_|DeleteCu|
|00000de0| 73 74 6f 6d 43 6c 61 73 | 73 20 2d 2d 20 64 65 6c |stomClas|s -- del|
|00000df0| 65 74 65 20 61 20 70 75 | 62 6c 69 63 2f 70 72 69 |ete a pu|blic/pri|
|00000e00| 76 61 74 65 20 63 75 73 | 74 6f 6d 20 63 6c 61 73 |vate cus|tom clas|
|00000e10| 73 2e 7d 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |s.}..\su|bsubsect|
|00000e20| 69 6f 6e 2a 7b 53 59 4e | 4f 50 53 49 53 7d 0a 5c |ion*{SYN|OPSIS}.\|
|00000e30| 62 65 67 69 6e 7b 74 61 | 62 62 69 6e 67 7d 0a 4d |begin{ta|bbing}.M|
|00000e40| 55 49 5c 5f 44 65 6c 65 | 74 65 43 75 73 74 6f 6d |UI\_Dele|teCustom|
|00000e50| 43 6c 61 73 73 20 28 20 | 5c 3d 6d 63 63 20 29 5c |Class ( |\=mcc )\|
|00000e60| 5c 0a 5c 3e 41 30 0a 5c | 65 6e 64 7b 74 61 62 62 |\.\>A0.\|end{tabb|
|00000e70| 69 6e 67 7d 0a 0a 42 4f | 4f 4c 20 4d 55 49 5c 5f |ing}..BO|OL MUI\_|
|00000e80| 44 65 6c 65 74 65 43 75 | 73 74 6f 6d 43 6c 61 73 |DeleteCu|stomClas|
|00000e90| 73 28 73 74 72 75 63 74 | 20 4d 55 49 5c 5f 43 75 |s(struct| MUI\_Cu|
|00000ea0| 73 74 6f 6d 43 6c 61 73 | 73 20 24 5c 61 73 74 24 |stomClas|s $\ast$|
|00000eb0| 29 3b 0a 0a a0 20 20 5c | 73 75 62 73 75 62 73 65 |);... \|subsubse|
|00000ec0| 63 74 69 6f 6e 2a 7b 46 | 55 4e 43 54 49 4f 4e 7d |ction*{F|UNCTION}|
|00000ed0| 0a 44 65 6c 65 74 65 20 | 61 20 70 75 62 6c 69 63 |.Delete |a public|
|00000ee0| 20 6f 72 20 70 72 69 76 | 61 74 65 20 63 75 73 74 | or priv|ate cust|
|00000ef0| 6f 6d 20 63 6c 61 73 73 | 2e 20 4e 6f 74 65 20 74 |om class|. Note t|
|00000f00| 68 61 74 20 79 6f 75 0a | 6d 75 73 74 20 6e 6f 74 |hat you.|must not|
|00000f10| 20 64 65 6c 65 74 65 20 | 63 6c 61 73 73 65 73 20 | delete |classes |
|00000f20| 77 69 74 68 20 6f 75 74 | 73 74 61 6e 64 69 6e 67 |with out|standing|
|00000f30| 20 6f 62 6a 65 63 74 73 | 20 6f 72 20 73 75 62 0a | objects| or sub.|
|00000f40| 63 6c 61 73 73 65 73 2e | 0a 0a 5c 73 75 62 73 75 |classes.|..\subsu|
|00000f50| 62 73 65 63 74 69 6f 6e | 2a 7b 49 4e 50 55 54 53 |bsection|*{INPUTS|
|00000f60| 7d 0a 5c 62 65 67 69 6e | 7b 64 65 73 63 72 69 70 |}.\begin|{descrip|
|00000f70| 74 69 6f 6e 7d 0a 5c 69 | 74 65 6d 5b 6d 63 63 5d |tion}.\i|tem[mcc]|
|00000f80| 20 3d 20 70 6f 69 6e 74 | 65 72 20 6f 62 74 61 69 | = point|er obtai|
|00000f90| 6e 65 64 20 66 72 6f 6d | 20 4d 55 49 5c 5f 43 72 |ned from| MUI\_Cr|
|00000fa0| 65 61 74 65 43 75 73 74 | 6f 6d 43 6c 61 73 73 28 |eateCust|omClass(|
|00000fb0| 29 2e 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 70 74 |)..\end{|descript|
|00000fc0| 69 6f 6e 7d 0a 20 20 20 | 0a 5c 73 75 62 73 75 62 |ion}. |.\subsub|
|00000fd0| 73 65 63 74 69 6f 6e 2a | 7b 52 45 53 55 4c 54 7d |section*|{RESULT}|
|00000fe0| 0a 54 52 55 45 20 69 66 | 20 61 6c 6c 20 77 65 6e |.TRUE if| all wen|
|00000ff0| 74 20 77 65 6c 6c 2c 20 | 46 41 4c 53 45 20 69 66 |t well, |FALSE if|
|00001000| 20 73 6f 6d 65 20 6f 62 | 6a 65 63 74 73 20 6f 72 | some ob|jects or|
|00001010| 0a 73 75 62 20 63 6c 61 | 73 73 65 73 20 77 65 72 |.sub cla|sses wer|
|00001020| 65 20 73 74 69 6c 6c 20 | 68 61 6e 67 69 6e 67 20 |e still |hanging |
|00001030| 61 72 6f 75 6e 64 2e 20 | 4e 6f 74 68 69 6e 67 0a |around. |Nothing.|
|00001040| 77 69 6c 6c 20 62 65 20 | 66 72 65 65 64 20 69 6e |will be |freed in|
|00001050| 20 74 68 69 73 20 63 61 | 73 65 2e 0a 0a 5c 73 75 | this ca|se...\su|
|00001060| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 53 45 45 |bsubsect|ion*{SEE|
|00001070| 20 41 4c 53 4f 7d 0a 4d | 55 49 5c 5f 43 72 65 61 | ALSO}.M|UI\_Crea|
|00001080| 74 65 43 75 73 74 6f 6d | 43 6c 61 73 73 28 29 0a |teCustom|Class().|
|00001090| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 5b 4d 55 |..\subse|ction[MU|
|000010a0| 49 5c 5f 44 69 73 70 6f | 73 65 4f 62 6a 65 63 74 |I\_Dispo|seObject|
|000010b0| 5d 7b 4d 55 49 5c 5f 44 | 69 73 70 6f 73 65 4f 62 |]{MUI\_D|isposeOb|
|000010c0| 6a 65 63 74 20 2d 2d 20 | 44 65 6c 65 74 65 20 61 |ject -- |Delete a|
|000010d0| 20 4d 55 49 20 6f 62 6a | 65 63 74 2e 7d 0a 0a 5c | MUI obj|ect.}..\|
|000010e0| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 53 |subsubse|ction*{S|
|000010f0| 59 4e 4f 50 53 49 53 7d | 0a 5c 62 65 67 69 6e 7b |YNOPSIS}|.\begin{|
|00001100| 74 61 62 62 69 6e 67 7d | 0a 4d 55 49 5c 5f 44 69 |tabbing}|.MUI\_Di|
|00001110| 73 70 6f 73 65 4f 62 6a | 65 63 74 28 20 5c 3d 6f |sposeObj|ect( \=o|
|00001120| 62 6a 65 63 74 20 29 5c | 5c 0a 5c 3e 41 30 0a 5c |bject )\|\.\>A0.\|
|00001130| 65 6e 64 7b 74 61 62 62 | 69 6e 67 7d 0a 20 20 20 |end{tabb|ing}. |
|00001140| 0a 56 4f 49 44 a0 4d 55 | 49 5c 5f 44 69 73 70 6f |.VOID.MU|I\_Dispo|
|00001150| 73 65 4f 62 6a 65 63 74 | 28 20 41 50 54 52 20 29 |seObject|( APTR )|
|00001160| 3b 0a 0a a0 20 20 5c 73 | 75 62 73 75 62 73 65 63 |;... \s|ubsubsec|
|00001170| 74 69 6f 6e 2a 7b 46 55 | 4e 43 54 49 4f 4e 7d 0a |tion*{FU|NCTION}.|
|00001180| 44 65 6c 65 74 65 73 20 | 61 20 4d 55 49 20 6f 62 |Deletes |a MUI ob|
|00001190| 6a 65 63 74 20 61 6e 64 | 20 61 6c 6c 20 6f 66 20 |ject and| all of |
|000011a0| 69 74 27 73 20 61 75 78 | 69 6c 69 61 72 79 20 64 |it's aux|iliary d|
|000011b0| 61 74 61 2e 0a 54 68 65 | 73 65 20 6f 62 6a 65 63 |ata..The|se objec|
|000011c0| 74 73 20 61 72 65 20 61 | 6c 6c 20 63 72 65 61 74 |ts are a|ll creat|
|000011d0| 65 64 20 62 79 20 4d 55 | 49 5c 5f 4e 65 77 4f 62 |ed by MU|I\_NewOb|
|000011e0| 6a 65 63 74 28 29 2e 20 | 4f 62 6a 65 63 74 73 0a |ject(). |Objects.|
|000011f0| 6f 66 20 63 65 72 74 61 | 69 6e 20 63 6c 61 73 73 |of certa|in class|
|00001200| 65 73 20 27 27 6f 77 6e | 27 27 20 6f 74 68 65 72 |es ''own|'' other|
|00001210| 20 6f 62 6a 65 63 74 73 | 2c 20 77 68 69 63 68 20 | objects|, which |
|00001220| 77 69 6c 6c 20 61 6c 73 | 6f 0a 62 65 20 64 65 6c |will als|o.be del|
|00001230| 65 74 65 64 20 77 68 65 | 6e 20 74 68 65 20 6f 62 |eted whe|n the ob|
|00001240| 6a 65 63 74 20 69 73 20 | 70 61 73 73 65 64 20 74 |ject is |passed t|
|00001250| 6f 20 4d 55 49 5c 5f 44 | 69 73 70 6f 73 65 4f 62 |o MUI\_D|isposeOb|
|00001260| 6a 65 63 74 28 29 2e 0a | 52 65 61 64 20 74 68 65 |ject()..|Read the|
|00001270| 20 70 65 72 2d 63 6c 61 | 73 73 20 64 6f 63 75 6d | per-cla|ss docum|
|00001280| 65 6e 74 61 74 69 6f 6e | 20 63 61 72 65 66 75 6c |entation| careful|
|00001290| 6c 79 20 74 6f 20 62 65 | 20 61 77 61 72 65 0a 6f |ly to be| aware.o|
|000012a0| 66 20 74 68 65 73 65 20 | 69 6e 73 74 61 6e 63 65 |f these |instance|
|000012b0| 73 2e 0a 0a 5c 73 75 62 | 73 75 62 73 65 63 74 69 |s...\sub|subsecti|
|000012c0| 6f 6e 2a 7b 49 4e 50 55 | 54 53 7d 0a 5c 62 65 67 |on*{INPU|TS}.\beg|
|000012d0| 69 6e 7b 64 65 73 63 72 | 69 70 74 69 6f 6e 7d 0a |in{descr|iption}.|
|000012e0| 5c 69 74 65 6d 5b 6f 62 | 6a 65 63 74 5d 20 3d 20 |\item[ob|ject] = |
|000012f0| 61 62 73 74 72 61 63 74 | 20 70 6f 69 6e 74 65 72 |abstract| pointer|
|00001300| 20 74 6f 20 61 20 4d 55 | 49 20 6f 62 6a 65 63 74 | to a MU|I object|
|00001310| 20 72 65 74 75 72 6e 65 | 64 20 62 79 0a 4d 55 49 | returne|d by.MUI|
|00001320| 5c 5f 4e 65 77 4f 62 6a | 65 63 74 28 29 2e 20 54 |\_NewObj|ect(). T|
|00001330| 68 65 20 70 6f 69 6e 74 | 65 72 20 6d 61 79 20 62 |he point|er may b|
|00001340| 65 20 4e 55 4c 4c 2c 20 | 69 6e 20 77 68 69 63 68 |e NULL, |in which|
|00001350| 20 63 61 73 65 0a 74 68 | 69 73 20 66 75 6e 63 74 | case.th|is funct|
|00001360| 69 6f 6e 20 68 61 73 20 | 6e 6f 20 65 66 66 65 63 |ion has |no effec|
|00001370| 74 2e 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 70 74 |t..\end{|descript|
|00001380| 69 6f 6e 7d 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |ion}..\s|ubsubsec|
|00001390| 74 69 6f 6e 2a 7b 52 45 | 53 55 4c 54 7d 0a 4e 6f |tion*{RE|SULT}.No|
|000013a0| 6e 65 2e 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |ne...\su|bsubsect|
|000013b0| 69 6f 6e 2a 7b 53 45 45 | 20 41 4c 53 4f 7d 0a 4d |ion*{SEE| ALSO}.M|
|000013c0| 55 49 5c 5f 4e 65 77 4f | 62 6a 65 63 74 28 29 2c |UI\_NewO|bject(),|
|000013d0| 20 53 65 74 41 74 74 72 | 73 28 29 2c 20 47 65 74 | SetAttr|s(), Get|
|000013e0| 41 74 74 72 28 29 2e 0a | 0a 0a 5c 73 75 62 73 65 |Attr()..|..\subse|
|000013f0| 63 74 69 6f 6e 5b 4d 55 | 49 5c 5f 45 72 72 6f 72 |ction[MU|I\_Error|
|00001400| 5d 7b 4d 55 49 5c 5f 45 | 72 72 6f 72 20 2d 2d 20 |]{MUI\_E|rror -- |
|00001410| 52 65 74 75 72 6e 20 65 | 78 74 72 61 20 69 6e 66 |Return e|xtra inf|
|00001420| 6f 72 6d 61 74 69 6f 6e | 20 66 72 6f 6d 20 74 68 |ormation| from th|
|00001430| 65 20 4d 55 49 20 73 79 | 73 74 65 6d 2e 7d 0a 0a |e MUI sy|stem.}..|
|00001440| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|00001450| 53 59 4e 4f 50 53 49 53 | 7d 0a 4c 4f 4e 47 20 4d |SYNOPSIS|}.LONG M|
|00001460| 55 49 5c 5f 45 72 72 6f | 72 28 56 4f 49 44 29 3b |UI\_Erro|r(VOID);|
|00001470| 0a 0a a0 20 20 5c 73 75 | 62 73 75 62 73 65 63 74 |... \su|bsubsect|
|00001480| 69 6f 6e 2a 7b 46 55 4e | 43 54 49 4f 4e 7d 0a 53 |ion*{FUN|CTION}.S|
|00001490| 6f 6d 65 20 4d 55 49 20 | 66 75 6e 63 74 69 6f 6e |ome MUI |function|
|000014a0| 73 20 77 69 6c 6c 20 73 | 65 74 20 61 6e 20 65 72 |s will s|et an er|
|000014b0| 72 6f 72 20 69 66 20 74 | 68 65 79 20 66 61 69 6c |ror if t|hey fail|
|000014c0| 20 66 6f 72 0a 73 6f 6d | 65 20 72 65 61 73 6f 6e | for.som|e reason|
|000014d0| 2e 20 54 68 65 20 65 72 | 72 6f 72 20 66 75 6e 63 |. The er|ror func|
|000014e0| 74 69 6f 6e 73 20 69 73 | 20 74 61 73 6b 20 73 65 |tions is| task se|
|000014f0| 6e 73 69 74 69 76 65 2c | 0a 6f 6e 6c 79 20 74 68 |nsitive,|.only th|
|00001500| 65 20 74 61 73 6b 20 74 | 68 61 74 20 63 61 75 73 |e task t|hat caus|
|00001510| 65 64 20 74 68 65 20 65 | 72 72 6f 72 20 77 69 6c |ed the e|rror wil|
|00001520| 6c 20 72 65 63 65 69 76 | 65 20 69 74 0a 66 72 6f |l receiv|e it.fro|
|00001530| 6d 20 74 68 69 73 20 66 | 75 6e 63 74 69 6f 6e 2e |m this f|unction.|
|00001540| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00001550| 2a 7b 52 45 53 55 4c 54 | 7d 0a 43 75 72 72 65 6e |*{RESULT|}.Curren|
|00001560| 74 6c 79 2c 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |tly, the| followi|
|00001570| 6e 67 20 65 72 72 6f 72 | 20 76 61 6c 75 65 73 20 |ng error| values |
|00001580| 61 72 65 20 64 65 66 69 | 6e 65 64 3a 0a 0a 5c 62 |are defi|ned:..\b|
|00001590| 65 67 69 6e 7b 63 65 6e | 74 65 72 7d 20 5c 62 65 |egin{cen|ter} \be|
|000015a0| 67 69 6e 7b 74 61 62 75 | 6c 61 72 7d 7b 6c 63 6c |gin{tabu|lar}{lcl|
|000015b0| 7d 0a 4d 55 49 45 5c 5f | 4f 4b 20 20 20 20 20 20 |}.MUIE\_|OK |
|000015c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 26 2d 26 20 | | &-& |
|000015d0| 6e 6f 20 65 72 72 6f 72 | 2c 20 65 76 65 72 79 74 |no error|, everyt|
|000015e0| 68 69 6e 67 20 61 6c 6c | 72 69 67 68 74 2e 5c 5c |hing all|right.\\|
|000015f0| 0a 4d 55 49 45 5c 5f 4f | 75 74 4f 66 4d 65 6d 6f |.MUIE\_O|utOfMemo|
|00001600| 72 79 20 20 20 20 20 20 | 20 20 20 26 2d 26 20 77 |ry | &-& w|
|00001610| 65 6e 74 20 6f 75 74 20 | 6f 66 20 6d 65 6d 6f 72 |ent out |of memor|
|00001620| 79 2e 5c 5c 0a 4d 55 49 | 45 5c 5f 4f 75 74 4f 66 |y.\\.MUI|E\_OutOf|
|00001630| 47 66 78 4d 65 6d 6f 72 | 79 20 20 20 20 20 20 26 |GfxMemor|y &|
|00001640| 2d 26 20 77 65 6e 74 20 | 6f 75 74 20 6f 66 20 67 |-& went |out of g|
|00001650| 72 61 70 68 69 63 73 20 | 6d 65 6d 6f 72 79 2e 5c |raphics |memory.\|
|00001660| 5c 0a 4d 55 49 45 5c 5f | 49 6e 76 61 6c 69 64 57 |\.MUIE\_|InvalidW|
|00001670| 69 6e 64 6f 77 4f 62 6a | 65 63 74 20 26 2d 26 20 |indowObj|ect &-& |
|00001680| 4e 55 4c 4c 20 77 69 6e | 64 6f 77 20 73 70 65 63 |NULL win|dow spec|
|00001690| 69 66 69 65 64 2e 5c 5c | 0a 4d 55 49 45 5c 5f 4d |ified.\\|.MUIE\_M|
|000016a0| 69 73 73 69 6e 67 4c 69 | 62 72 61 72 79 20 20 20 |issingLi|brary |
|000016b0| 20 20 20 26 2d 26 20 63 | 61 6e 27 74 20 6f 70 65 | &-& c|an't ope|
|000016c0| 6e 20 61 20 6e 65 65 64 | 65 64 20 6c 69 62 72 61 |n a need|ed libra|
|000016d0| 72 79 2e 5c 5c 0a 4d 55 | 49 45 5c 5f 4e 6f 41 52 |ry.\\.MU|IE\_NoAR|
|000016e0| 65 78 78 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |exx | |
|000016f0| 26 2d 26 20 75 6e 61 62 | 6c 65 20 74 6f 20 63 72 |&-& unab|le to cr|
|00001700| 65 61 74 65 20 61 72 65 | 78 78 20 70 6f 72 74 2e |eate are|xx port.|
|00001710| 5c 5c 0a 4d 55 49 45 5c | 5f 53 69 6e 67 6c 65 54 |\\.MUIE\|_SingleT|
|00001720| 61 73 6b 20 20 20 20 20 | 20 20 20 20 20 26 2d 26 |ask | &-&|
|00001730| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 69 73 20 | applica|tion is |
|00001740| 61 6c 72 65 61 64 79 20 | 72 75 6e 6e 69 6e 67 2e |already |running.|
|00001750| 5c 5c 0a 5c 65 6e 64 7b | 74 61 62 75 6c 61 72 7d |\\.\end{|tabular}|
|00001760| 20 5c 65 6e 64 7b 63 65 | 6e 74 65 72 7d 0a 20 20 | \end{ce|nter}. |
|00001770| 20 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e | .\subsu|bsection|
|00001780| 2a 7b 53 45 45 20 41 4c | 53 4f 7d 0a 4d 55 49 5c |*{SEE AL|SO}.MUI\|
|00001790| 5f 53 65 74 45 72 72 6f | 72 28 29 0a 0a 0a 5c 73 |_SetErro|r()...\s|
|000017a0| 75 62 73 65 63 74 69 6f | 6e 5b 4d 55 49 5c 5f 46 |ubsectio|n[MUI\_F|
|000017b0| 72 65 65 41 73 6c 52 65 | 71 75 65 73 74 5d 7b 4d |reeAslRe|quest]{M|
|000017c0| 55 49 5c 5f 46 72 65 65 | 41 73 6c 52 65 71 75 65 |UI\_Free|AslReque|
|000017d0| 73 74 7d 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |st}..\su|bsubsect|
|000017e0| 69 6f 6e 2a 7b 46 55 4e | 43 54 49 4f 4e 7d 0a 50 |ion*{FUN|CTION}.P|
|000017f0| 72 6f 76 69 64 65 20 61 | 6e 20 69 6e 74 65 72 66 |rovide a|n interf|
|00001800| 61 63 65 20 74 6f 20 61 | 73 6c 2e 6c 69 62 72 61 |ace to a|sl.libra|
|00001810| 72 79 2e 20 55 73 69 6e | 67 20 74 68 69 73 20 65 |ry. Usin|g this e|
|00001820| 6e 73 75 72 65 73 0a 79 | 6f 75 72 20 61 70 70 6c |nsures.y|our appl|
|00001830| 69 63 61 74 69 6f 6e 20 | 77 69 6c 6c 20 62 65 6e |ication |will ben|
|00001840| 65 66 69 74 20 66 72 6f | 6d 20 66 75 74 75 72 65 |efit fro|m future|
|00001850| 20 65 78 70 61 6e 73 69 | 6f 6e 73 0a 74 6f 20 4d | expansi|ons.to M|
|00001860| 55 49 27 73 20 77 69 6e | 64 6f 77 20 61 6e 64 20 |UI's win|dow and |
|00001870| 69 63 6f 6e 69 66 69 63 | 61 74 69 6f 6e 20 68 61 |iconific|ation ha|
|00001880| 6e 64 6c 69 6e 67 2e 0a | 0a 5c 73 75 62 73 75 62 |ndling..|.\subsub|
|00001890| 73 65 63 74 69 6f 6e 2a | 7b 53 45 45 20 41 4c 53 |section*|{SEE ALS|
|000018a0| 4f 7d 0a 61 73 6c 2e 6c | 69 62 72 61 72 79 2f 46 |O}.asl.l|ibrary/F|
|000018b0| 72 65 65 41 73 6c 52 65 | 71 75 65 73 74 0a 0a 0a |reeAslRe|quest...|
|000018c0| 5c 73 75 62 73 65 63 74 | 69 6f 6e 5b 4d 55 49 5c |\subsect|ion[MUI\|
|000018d0| 5f 46 72 65 65 43 6c 61 | 73 73 5d 7b 4d 55 49 5c |_FreeCla|ss]{MUI\|
|000018e0| 5f 46 72 65 65 43 6c 61 | 73 73 20 2d 2d 20 46 72 |_FreeCla|ss -- Fr|
|000018f0| 65 65 20 63 6c 61 73 73 | 2e 7d 0a 0a 5c 73 75 62 |ee class|.}..\sub|
|00001900| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 53 59 4e 4f |subsecti|on*{SYNO|
|00001910| 50 53 49 53 7d 0a 5c 62 | 65 67 69 6e 7b 74 61 62 |PSIS}.\b|egin{tab|
|00001920| 62 69 6e 67 7d 0a 4d 55 | 49 5c 5f 46 72 65 65 43 |bing}.MU|I\_FreeC|
|00001930| 6c 61 73 73 28 20 5c 3d | 63 6c 61 73 73 70 74 72 |lass( \=|classptr|
|00001940| 20 29 5c 5c 0a 5c 3e 41 | 30 0a 5c 65 6e 64 7b 74 | )\\.\>A|0.\end{t|
|00001950| 61 62 62 69 6e 67 7d 0a | 20 20 20 0a 56 4f 49 44 |abbing}.| .VOID|
|00001960| 20 4d 55 49 5c 5f 46 72 | 65 65 43 6c 61 73 73 28 | MUI\_Fr|eeClass(|
|00001970| 73 74 72 75 63 74 20 49 | 43 6c 61 73 73 20 24 5c |struct I|Class $\|
|00001980| 61 73 74 24 63 6c 61 73 | 73 70 74 72 29 3b 0a 0a |ast$clas|sptr);..|
|00001990| a0 20 20 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |. \subs|ubsectio|
|000019a0| 6e 2a 7b 46 55 4e 43 54 | 49 4f 4e 7d 0a 54 68 69 |n*{FUNCT|ION}.Thi|
|000019b0| 73 20 66 75 6e 63 74 69 | 6f 6e 20 69 73 20 6f 62 |s functi|on is ob|
|000019c0| 73 6f 6c 65 74 65 20 73 | 69 6e 63 65 20 4d 55 49 |solete s|ince MUI|
|000019d0| 20 56 38 2e 0a 55 73 65 | 20 4d 55 49 5c 5f 44 65 | V8..Use| MUI\_De|
|000019e0| 6c 65 74 65 43 75 73 74 | 6f 6d 43 6c 61 73 73 28 |leteCust|omClass(|
|000019f0| 29 20 69 6e 73 74 65 61 | 64 2e 0a 0a 5c 73 75 62 |) instea|d...\sub|
|00001a00| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 53 45 45 20 |subsecti|on*{SEE |
|00001a10| 41 4c 53 4f 7d 0a 4d 55 | 49 5c 5f 43 72 65 61 74 |ALSO}.MU|I\_Creat|
|00001a20| 65 43 75 73 74 6f 6d 43 | 6c 61 73 73 28 29 2c 20 |eCustomC|lass(), |
|00001a30| 4d 55 49 5c 5f 44 65 6c | 65 74 65 43 75 73 74 6f |MUI\_Del|eteCusto|
|00001a40| 6d 43 6c 61 73 73 28 29 | 0a 0a 0a 5c 73 75 62 73 |mClass()|...\subs|
|00001a50| 65 63 74 69 6f 6e 5b 4d | 55 49 5c 5f 47 65 74 43 |ection[M|UI\_GetC|
|00001a60| 6c 61 73 73 5d 7b 4d 55 | 49 5c 5f 47 65 74 43 6c |lass]{MU|I\_GetCl|
|00001a70| 61 73 73 20 2d 2d 20 47 | 65 74 20 61 20 70 6f 69 |ass -- G|et a poi|
|00001a80| 6e 74 65 72 20 74 6f 20 | 61 20 4d 55 49 20 63 6c |nter to |a MUI cl|
|00001a90| 61 73 73 2e 7d 0a 0a 5c | 73 75 62 73 75 62 73 65 |ass.}..\|subsubse|
|00001aa0| 63 74 69 6f 6e 2a 7b 53 | 59 4e 4f 50 53 49 53 7d |ction*{S|YNOPSIS}|
|00001ab0| 0a 5c 62 65 67 69 6e 7b | 74 61 62 62 69 6e 67 7d |.\begin{|tabbing}|
|00001ac0| 0a 63 6c 61 73 73 20 3d | 20 4d 55 49 5c 5f 47 65 |.class =| MUI\_Ge|
|00001ad0| 74 43 6c 61 73 73 28 20 | 5c 3d 63 6c 61 73 73 69 |tClass( |\=classi|
|00001ae0| 64 20 29 5c 5c 0a 44 30 | 20 20 20 20 20 20 20 20 |d )\\.D0| |
|00001af0| 20 20 20 20 20 20 20 20 | 20 20 20 20 5c 3e 41 30 | | \>A0|
|00001b00| 0a 5c 65 6e 64 7b 74 61 | 62 62 69 6e 67 7d 0a 0a |.\end{ta|bbing}..|
|00001b10| 73 74 72 75 63 74 20 49 | 43 6c 61 73 73 20 24 5c |struct I|Class $\|
|00001b20| 61 73 74 24 20 4d 55 49 | 5c 5f 47 65 74 43 6c 61 |ast$ MUI|\_GetCla|
|00001b30| 73 73 28 63 68 61 72 20 | 24 5c 61 73 74 24 63 6c |ss(char |$\ast$cl|
|00001b40| 61 73 73 69 64 29 3b 0a | 0a a0 20 20 5c 73 75 62 |assid);.|.. \sub|
|00001b50| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 46 55 4e 43 |subsecti|on*{FUNC|
|00001b60| 54 49 4f 4e 7d 0a 54 68 | 69 73 20 66 75 6e 63 74 |TION}.Th|is funct|
|00001b70| 69 6f 6e 20 69 73 20 6f | 62 73 6f 6c 65 74 65 20 |ion is o|bsolete |
|00001b80| 73 69 6e 63 65 20 4d 55 | 49 20 56 38 2e 0a 55 73 |since MU|I V8..Us|
|00001b90| 65 20 4d 55 49 5c 5f 43 | 72 65 61 74 65 43 75 73 |e MUI\_C|reateCus|
|00001ba0| 74 6f 6d 43 6c 61 73 73 | 20 69 6e 73 74 65 61 64 |tomClass| instead|
|00001bb0| 2e 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |...\subs|ubsectio|
|00001bc0| 6e 2a 7b 53 45 45 20 41 | 4c 53 4f 7d 0a 4d 55 49 |n*{SEE A|LSO}.MUI|
|00001bd0| 5c 5f 43 72 65 61 74 65 | 43 75 73 74 6f 6d 43 6c |\_Create|CustomCl|
|00001be0| 61 73 73 28 29 2c 20 4d | 55 49 5c 5f 44 65 6c 65 |ass(), M|UI\_Dele|
|00001bf0| 74 65 43 75 73 74 6f 6d | 43 6c 61 73 73 28 29 0a |teCustom|Class().|
|00001c00| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 5b 4d 55 |..\subse|ction[MU|
|00001c10| 49 5c 5f 4d 61 6b 65 4f | 62 6a 65 63 74 41 5d 7b |I\_MakeO|bjectA]{|
|00001c20| 4d 55 49 5c 5f 4d 61 6b | 65 4f 62 6a 65 63 74 41 |MUI\_Mak|eObjectA|
|00001c30| 20 2d 2d 20 63 72 65 61 | 74 65 20 61 6e 20 6f 62 | -- crea|te an ob|
|00001c40| 6a 65 63 74 20 66 72 6f | 6d 20 74 68 65 20 62 75 |ject fro|m the bu|
|00001c50| 69 6c 74 69 6e 20 6f 62 | 6a 65 63 74 20 63 6f 6c |iltin ob|ject col|
|00001c60| 6c 65 63 74 69 6f 6e 2e | 7d 0a 4d 55 49 5c 5f 4d |lection.|}.MUI\_M|
|00001c70| 61 6b 65 4f 62 6a 65 63 | 74 20 2d 2d 20 56 61 72 |akeObjec|t -- Var|
|00001c80| 61 72 67 73 20 73 74 75 | 62 20 66 6f 72 20 4d 55 |args stu|b for MU|
|00001c90| 49 5c 5f 4d 61 6b 65 4f | 62 6a 65 63 74 41 0a 0a |I\_MakeO|bjectA..|
|00001ca0| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|00001cb0| 53 59 4e 4f 50 53 49 53 | 7d 0a 5c 62 65 67 69 6e |SYNOPSIS|}.\begin|
|00001cc0| 7b 74 61 62 62 69 6e 67 | 7d 0a 6f 62 6a 65 63 74 |{tabbing|}.object|
|00001cd0| 20 3d 20 4d 55 49 5c 5f | 4d 61 6b 65 4f 62 6a 65 | = MUI\_|MakeObje|
|00001ce0| 63 74 41 28 20 5c 3d 6f | 62 6a 74 79 70 65 2c 20 |ctA( \=o|bjtype, |
|00001cf0| 5c 3d 70 61 72 61 6d 73 | 20 29 5c 5c 0a 44 30 20 |\=params| )\\.D0 |
|00001d00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001d10| 20 20 20 20 20 20 20 5c | 3e 44 30 20 20 20 20 20 | \|>D0 |
|00001d20| 20 20 5c 3e 41 30 0a 5c | 65 6e 64 7b 74 61 62 62 | \>A0.\|end{tabb|
|00001d30| 69 6e 67 7d 0a 0a 5c 6e | 6f 69 6e 64 65 6e 74 20 |ing}..\n|oindent |
|00001d40| 4f 62 6a 65 63 74 20 24 | 5c 61 73 74 24 20 4d 55 |Object $|\ast$ MU|
|00001d50| 49 5c 5f 4d 61 6b 65 4f | 62 6a 65 63 74 41 28 55 |I\_MakeO|bjectA(U|
|00001d60| 4c 4f 4e 47 20 74 79 70 | 65 2c 20 55 4c 4f 4e 47 |LONG typ|e, ULONG|
|00001d70| 20 24 5c 61 73 74 24 70 | 61 72 61 6d 73 29 3b 5c | $\ast$p|arams);\|
|00001d80| 5c 0a 4f 62 6a 65 63 74 | 20 24 5c 61 73 74 24 20 |\.Object| $\ast$ |
|00001d90| 4d 55 49 5c 5f 4d 61 6b | 65 4f 62 6a 65 63 74 28 |MUI\_Mak|eObject(|
|00001da0| 55 4c 4f 4e 47 20 74 79 | 70 65 2c 20 2e 2e 2e 29 |ULONG ty|pe, ...)|
|00001db0| 3b 0a 0a a0 20 20 5c 73 | 75 62 73 75 62 73 65 63 |;... \s|ubsubsec|
|00001dc0| 74 69 6f 6e 2a 7b 46 55 | 4e 43 54 49 4f 4e 7d 0a |tion*{FU|NCTION}.|
|00001dd0| 50 72 69 6f 72 20 74 6f | 20 6d 75 69 6d 61 73 74 |Prior to| muimast|
|00001de0| 65 72 2e 6c 69 62 72 61 | 72 79 20 56 38 2c 20 4d |er.libra|ry V8, M|
|00001df0| 55 49 20 77 61 73 20 64 | 69 73 74 72 69 62 75 74 |UI was d|istribut|
|00001e00| 65 64 20 77 69 74 68 20 | 73 65 76 65 72 61 6c 20 |ed with |several |
|00001e10| 6d 61 63 72 6f 73 0a 74 | 6f 20 68 65 6c 70 20 63 |macros.t|o help c|
|00001e20| 72 65 61 74 69 6e 67 20 | 6f 66 74 65 6e 20 75 73 |reating |often us|
|00001e30| 65 64 20 6f 62 6a 65 63 | 74 73 2e 20 54 68 69 73 |ed objec|ts. This|
|00001e40| 20 70 72 61 63 74 69 63 | 65 20 77 61 73 20 65 61 | practic|e was ea|
|00001e50| 73 79 2c 20 62 75 74 20 | 75 73 69 6e 67 0a 6c 6f |sy, but |using.lo|
|00001e60| 74 73 20 6f 66 20 74 68 | 65 73 65 20 6d 61 63 72 |ts of th|ese macr|
|00001e70| 6f 73 20 6f 66 74 65 6e | 20 72 65 73 75 6c 74 65 |os often| resulte|
|00001e80| 64 20 69 6e 20 62 69 67 | 20 70 72 6f 67 72 61 6d |d in big| program|
|00001e90| 73 2e 20 4e 6f 77 2c 20 | 6d 75 69 6d 61 73 74 65 |s. Now, |muimaste|
|00001ea0| 72 0a 6c 69 62 72 61 72 | 79 20 63 6f 6e 74 61 69 |r.librar|y contai|
|00001eb0| 6e 73 20 61 6e 20 6f 62 | 6a 65 63 74 20 6c 69 62 |ns an ob|ject lib|
|00001ec0| 72 61 72 79 20 77 69 74 | 68 20 73 65 76 65 72 61 |rary wit|h severa|
|00001ed0| 6c 20 6f 66 74 65 6e 20 | 75 73 65 64 20 6f 62 6a |l often |used obj|
|00001ee0| 65 63 74 73 0a 61 6c 72 | 65 61 64 79 20 62 75 69 |ects.alr|eady bui|
|00001ef0| 6c 74 20 69 6e 2e 0a 0a | 4d 55 49 5c 5f 4d 61 6b |lt in...|MUI\_Mak|
|00001f00| 65 4f 62 6a 65 63 74 28 | 29 20 74 61 6b 65 73 20 |eObject(|) takes |
|00001f10| 74 68 65 20 74 79 70 65 | 20 6f 66 20 74 68 65 20 |the type| of the |
|00001f20| 6f 62 6a 65 63 74 20 61 | 73 20 66 69 72 73 74 20 |object a|s first |
|00001f30| 70 61 72 61 6d 65 74 65 | 72 20 61 6e 64 0a 61 20 |paramete|r and.a |
|00001f40| 6c 69 73 74 20 6f 66 20 | 61 64 64 69 74 69 6f 6e |list of |addition|
|00001f50| 61 6c 20 28 74 79 70 65 | 20 73 70 65 63 69 66 69 |al (type| specifi|
|00001f60| 63 29 20 70 61 72 61 6d | 65 74 65 72 73 2e 20 4e |c) param|eters. N|
|00001f70| 6f 74 65 20 74 68 61 74 | 20 74 68 65 73 65 0a 61 |ote that| these.a|
|00001f80| 64 64 69 74 69 6f 6e 61 | 6c 20 76 61 6c 75 65 73 |dditiona|l values|
|00001f90| 20 61 72 65 20 7b 5c 62 | 66 20 6e 6f 74 7d 20 61 | are {\b|f not} a|
|00001fa0| 20 74 61 67 6c 69 73 74 | 21 0a 0a 53 65 65 20 74 | taglist|!..See t|
|00001fb0| 68 65 20 68 65 61 64 65 | 72 20 66 69 6c 65 20 6d |he heade|r file m|
|00001fc0| 75 69 2e 68 20 66 6f 72 | 20 64 6f 63 75 6d 65 6e |ui.h for| documen|
|00001fd0| 74 61 74 69 6f 6e 20 6f | 6e 20 6f 62 6a 65 63 74 |tation o|n object|
|00001fe0| 20 74 79 70 65 73 20 61 | 6e 64 20 74 68 65 0a 72 | types a|nd the.r|
|00001ff0| 65 71 75 69 72 65 64 20 | 70 61 72 61 6d 65 74 65 |equired |paramete|
|00002000| 72 73 2e 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |rs...\su|bsubsect|
|00002010| 69 6f 6e 2a 7b 53 45 45 | 20 41 4c 53 4f 7d 0a 4d |ion*{SEE| ALSO}.M|
|00002020| 55 49 5c 5f 43 72 65 61 | 74 65 43 75 73 74 6f 6d |UI\_Crea|teCustom|
|00002030| 43 6c 61 73 73 28 29 2c | 20 4d 55 49 5c 5f 44 65 |Class(),| MUI\_De|
|00002040| 6c 65 74 65 43 75 73 74 | 6f 6d 43 6c 61 73 73 28 |leteCust|omClass(|
|00002050| 29 0a 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 5b |)...\sub|section[|
|00002060| 4d 55 49 5c 5f 4e 65 77 | 4f 62 6a 65 63 74 41 5d |MUI\_New|ObjectA]|
|00002070| 7b 4d 55 49 5c 5f 4e 65 | 77 4f 62 6a 65 63 74 41 |{MUI\_Ne|wObjectA|
|00002080| 20 2d 2d 20 43 72 65 61 | 74 65 20 61 6e 20 6f 62 | -- Crea|te an ob|
|00002090| 6a 65 63 74 20 66 72 6f | 6d 20 61 20 63 6c 61 73 |ject fro|m a clas|
|000020a0| 73 2e 7d 0a 4d 55 49 5c | 5f 4e 65 77 4f 62 6a 65 |s.}.MUI\|_NewObje|
|000020b0| 63 74 20 2d 2d 20 56 61 | 72 61 72 67 73 20 73 74 |ct -- Va|rargs st|
|000020c0| 75 62 20 66 6f 72 20 4d | 55 49 5c 5f 4e 65 77 4f |ub for M|UI\_NewO|
|000020d0| 62 6a 65 63 74 41 28 29 | 2e 0a 0a 5c 73 75 62 73 |bjectA()|...\subs|
|000020e0| 75 62 73 65 63 74 69 6f | 6e 2a 7b 53 59 4e 4f 50 |ubsectio|n*{SYNOP|
|000020f0| 53 49 53 7d 0a 5c 62 65 | 67 69 6e 7b 74 61 62 62 |SIS}.\be|gin{tabb|
|00002100| 69 6e 67 7d 0a 6f 62 6a | 65 63 74 20 3d 20 4d 55 |ing}.obj|ect = MU|
|00002110| 49 5c 5f 4e 65 77 4f 62 | 6a 65 63 74 41 28 20 5c |I\_NewOb|jectA( \|
|00002120| 3d 63 6c 61 73 73 2c 20 | 5c 3d 74 61 67 73 20 29 |=class, |\=tags )|
|00002130| 5c 5c 0a 44 30 20 20 20 | 20 20 20 20 20 20 20 20 |\\.D0 | |
|00002140| 20 20 20 20 20 20 20 20 | 20 20 20 20 5c 3e 41 30 | | \>A0|
|00002150| 20 20 20 20 20 5c 3e 41 | 31 0a 5c 65 6e 64 7b 74 | \>A|1.\end{t|
|00002160| 61 62 62 69 6e 67 7d 0a | 0a 41 50 54 52 a0 4d 55 |abbing}.|.APTR.MU|
|00002170| 49 5c 5f 4e 65 77 4f 62 | 6a 65 63 74 41 28 20 63 |I\_NewOb|jectA( c|
|00002180| 68 61 72 20 24 5c 61 73 | 74 24 2c 20 73 74 72 75 |har $\as|t$, stru|
|00002190| 63 74 20 54 61 67 49 74 | 65 6d 20 24 5c 61 73 74 |ct TagIt|em $\ast|
|000021a0| 24 20 29 3b 0a 0a 6f 62 | 6a 65 63 74 20 3d 20 4d |$ );..ob|ject = M|
|000021b0| 55 49 5c 5f 4e 65 77 4f | 62 6a 65 63 74 28 20 63 |UI\_NewO|bject( c|
|000021c0| 6c 61 73 73 49 44 2c 20 | 54 61 67 31 2c 20 2e 2e |lassID, |Tag1, ..|
|000021d0| 2e 20 29 0a 0a 41 50 54 | 52 20 4d 55 49 5c 5f 4e |. )..APT|R MUI\_N|
|000021e0| 65 77 4f 62 6a 65 63 74 | 28 20 63 6c 61 73 73 49 |ewObject|( classI|
|000021f0| 44 2c 20 55 4c 4f 4e 47 | 2c 20 2e 2e 2e 20 29 3b |D, ULONG|, ... );|
|00002200| 0a 0a a0 20 20 5c 73 75 | 62 73 75 62 73 65 63 74 |... \su|bsubsect|
|00002210| 69 6f 6e 2a 7b 46 55 4e | 43 54 49 4f 4e 7d 0a 54 |ion*{FUN|CTION}.T|
|00002220| 68 69 73 20 69 73 20 74 | 68 65 20 67 65 6e 65 72 |his is t|he gener|
|00002230| 61 6c 20 6d 65 74 68 6f | 64 20 6f 66 20 63 72 65 |al metho|d of cre|
|00002240| 61 74 69 6e 67 20 6f 62 | 6a 65 63 74 73 20 66 72 |ating ob|jects fr|
|00002250| 6f 6d 20 4d 55 49 20 63 | 6c 61 73 73 65 73 2e 0a |om MUI c|lasses..|
|00002260| 59 6f 75 20 73 70 65 63 | 69 66 79 20 61 20 63 6c |You spec|ify a cl|
|00002270| 61 73 73 20 62 79 20 69 | 74 73 20 49 44 20 73 74 |ass by i|ts ID st|
|00002280| 72 69 6e 67 2e 20 49 66 | 20 74 68 65 20 63 6c 61 |ring. If| the cla|
|00002290| 73 73 20 69 73 20 6e 6f | 74 0a 61 6c 72 65 61 64 |ss is no|t.alread|
|000022a0| 79 20 69 6e 20 6d 65 6d | 6f 72 79 20 6f 72 20 62 |y in mem|ory or b|
|000022b0| 75 69 6c 74 20 69 6e 74 | 6f 20 6d 75 69 6d 61 73 |uilt int|o muimas|
|000022c0| 74 65 72 2e 6c 69 62 72 | 61 72 79 2c 20 69 74 20 |ter.libr|ary, it |
|000022d0| 77 69 6c 6c 20 62 65 0a | 6c 6f 61 64 65 64 20 75 |will be.|loaded u|
|000022e0| 73 69 6e 67 20 4f 70 65 | 6e 4c 69 62 72 61 72 79 |sing Ope|nLibrary|
|000022f0| 28 27 27 6d 75 69 2f 5c | 25 73 27 27 2c 30 29 2e |(''mui/\|%s'',0).|
|00002300| 0a 0a 59 6f 75 20 66 75 | 72 74 68 65 72 20 73 70 |..You fu|rther sp|
|00002310| 65 63 69 66 79 20 69 6e | 69 74 69 61 6c 20 27 27 |ecify in|itial ''|
|00002320| 63 72 65 61 74 65 2d 74 | 69 6d 65 27 27 20 61 74 |create-t|ime'' at|
|00002330| 74 72 69 62 75 74 65 73 | 20 66 6f 72 20 74 68 65 |tributes| for the|
|00002340| 0a 6f 62 6a 65 63 74 20 | 76 69 61 20 61 20 54 61 |.object |via a Ta|
|00002350| 67 49 74 65 6d 20 6c 69 | 73 74 2c 20 61 6e 64 20 |gItem li|st, and |
|00002360| 74 68 65 79 20 61 72 65 | 20 61 70 70 6c 69 65 64 |they are| applied|
|00002370| 20 74 6f 20 74 68 65 20 | 72 65 73 75 6c 74 69 6e | to the |resultin|
|00002380| 67 0a 67 65 6e 65 72 69 | 63 20 64 61 74 61 20 6f |g.generi|c data o|
|00002390| 62 6a 65 63 74 20 74 68 | 61 74 20 69 73 20 72 65 |bject th|at is re|
|000023a0| 74 75 72 6e 65 64 2e 20 | 54 68 65 20 61 74 74 72 |turned. |The attr|
|000023b0| 69 62 75 74 65 73 2c 20 | 74 68 65 69 72 20 6d 65 |ibutes, |their me|
|000023c0| 61 6e 69 6e 67 73 2c 0a | 61 74 74 72 69 62 75 74 |anings,.|attribut|
|000023d0| 65 73 20 61 70 70 6c 69 | 65 64 20 6f 6e 6c 79 20 |es appli|ed only |
|000023e0| 61 74 20 63 72 65 61 74 | 65 2d 74 69 6d 65 2c 20 |at creat|e-time, |
|000023f0| 61 6e 64 20 72 65 71 75 | 69 72 65 64 20 61 74 74 |and requ|ired att|
|00002400| 72 69 62 75 74 65 73 0a | 61 72 65 20 61 6c 6c 20 |ributes.|are all |
|00002410| 64 65 66 69 6e 65 64 20 | 61 6e 64 20 64 6f 63 75 |defined |and docu|
|00002420| 6d 65 6e 74 65 64 20 6f | 6e 20 61 20 63 6c 61 73 |mented o|n a clas|
|00002430| 73 2d 62 79 2d 63 6c 61 | 73 73 20 62 61 73 69 73 |s-by-cla|ss basis|
|00002440| 2e 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |...\subs|ubsectio|
|00002450| 6e 2a 7b 49 4e 50 55 54 | 53 7d 0a 5c 62 65 67 69 |n*{INPUT|S}.\begi|
|00002460| 6e 7b 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 0a 5c |n{descri|ption}.\|
|00002470| 69 74 65 6d 5b 63 6c 61 | 73 73 49 44 5d 20 3d 20 |item[cla|ssID] = |
|00002480| 74 68 65 20 6e 61 6d 65 | 2f 49 44 20 73 74 72 69 |the name|/ID stri|
|00002490| 6e 67 20 6f 66 20 61 20 | 4d 55 49 20 63 6c 61 73 |ng of a |MUI clas|
|000024a0| 73 2c 20 65 2e 67 2e 20 | 27 27 49 6d 61 67 65 2e |s, e.g. |''Image.|
|000024b0| 6d 75 69 27 27 2e 0a 43 | 6c 61 73 73 20 6e 61 6d |mui''..C|lass nam|
|000024c0| 65 73 20 61 72 65 20 63 | 61 73 65 20 73 65 6e 73 |es are c|ase sens|
|000024d0| 69 74 69 76 65 21 0a 0a | 5c 69 74 65 6d 5b 74 61 |itive!..|\item[ta|
|000024e0| 67 4c 69 73 74 5d 20 3d | 20 70 6f 69 6e 74 65 72 |gList] =| pointer|
|000024f0| 20 74 6f 20 61 72 72 61 | 79 20 6f 66 20 54 61 67 | to arra|y of Tag|
|00002500| 49 74 65 6d 73 20 63 6f | 6e 74 61 69 6e 69 6e 67 |Items co|ntaining|
|00002510| 20 61 74 74 72 69 62 75 | 74 65 2f 76 61 6c 75 65 | attribu|te/value|
|00002520| 0a 70 61 69 72 73 20 74 | 6f 20 62 65 20 61 70 70 |.pairs t|o be app|
|00002530| 6c 69 65 64 20 74 6f 20 | 74 68 65 20 6f 62 6a 65 |lied to |the obje|
|00002540| 63 74 20 62 65 69 6e 67 | 20 63 72 65 61 74 65 64 |ct being| created|
|00002550| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 70 74 69 |..\end{d|escripti|
|00002560| 6f 6e 7d 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |on}..\su|bsubsect|
|00002570| 69 6f 6e 2a 7b 52 45 53 | 55 4c 54 7d 0a 41 20 4d |ion*{RES|ULT}.A M|
|00002580| 55 49 20 6f 62 6a 65 63 | 74 2c 20 77 68 69 63 68 |UI objec|t, which|
|00002590| 20 6d 61 79 20 62 65 20 | 75 73 65 64 20 69 6e 20 | may be |used in |
|000025a0| 64 69 66 66 65 72 65 6e | 74 20 63 6f 6e 74 65 78 |differen|t contex|
|000025b0| 74 73 20 73 75 63 68 0a | 61 73 20 61 6e 20 61 70 |ts such.|as an ap|
|000025c0| 70 6c 69 63 61 74 69 6f | 6e 2c 20 77 69 6e 64 6f |plicatio|n, windo|
|000025d0| 77 20 6f 72 20 67 61 64 | 67 65 74 2c 20 61 6e 64 |w or gad|get, and|
|000025e0| 20 6d 61 79 20 62 65 20 | 6d 61 6e 69 70 75 6c 61 | may be |manipula|
|000025f0| 74 65 64 0a 62 79 20 67 | 65 6e 65 72 69 63 20 66 |ted.by g|eneric f|
|00002600| 75 6e 63 74 69 6f 6e 73 | 2e 20 59 6f 75 20 65 76 |unctions|. You ev|
|00002610| 65 6e 74 75 61 6c 6c 79 | 20 66 72 65 65 20 74 68 |entually| free th|
|00002620| 65 20 6f 62 6a 65 63 74 | 20 75 73 69 6e 67 0a 4d |e object| using.M|
|00002630| 55 49 5c 5f 44 69 73 70 | 6f 73 65 4f 62 6a 65 63 |UI\_Disp|oseObjec|
|00002640| 74 28 29 2e 0a 4e 55 4c | 4c 20 69 6e 64 69 63 61 |t()..NUL|L indica|
|00002650| 74 65 73 20 66 61 69 6c | 75 72 65 2c 20 6d 6f 72 |tes fail|ure, mor|
|00002660| 65 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 6f 6e |e inform|ation on|
|00002670| 20 74 68 65 20 65 72 72 | 6f 72 20 63 61 6e 20 62 | the err|or can b|
|00002680| 65 0a 6f 62 74 61 69 6e | 65 64 20 77 69 74 68 20 |e.obtain|ed with |
|00002690| 4d 55 49 5c 5f 45 72 72 | 6f 72 28 29 2e 0a 0a 5c |MUI\_Err|or()...\|
|000026a0| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 53 |subsubse|ction*{S|
|000026b0| 45 45 20 41 4c 53 4f 7d | 0a 4d 55 49 5c 5f 44 69 |EE ALSO}|.MUI\_Di|
|000026c0| 73 70 6f 73 65 4f 62 6a | 65 63 74 28 29 2c 20 4d |sposeObj|ect(), M|
|000026d0| 55 49 5c 5f 45 72 72 6f | 72 28 29 2c 20 53 65 74 |UI\_Erro|r(), Set|
|000026e0| 41 74 74 72 73 28 29 2c | 20 47 65 74 41 74 74 72 |Attrs(),| GetAttr|
|000026f0| 28 29 2e 0a 0a 0a 5c 73 | 75 62 73 65 63 74 69 6f |()....\s|ubsectio|
|00002700| 6e 5b 4d 55 49 5c 5f 52 | 65 64 72 61 77 5d 7b 4d |n[MUI\_R|edraw]{M|
|00002710| 55 49 5c 5f 52 65 64 72 | 61 77 20 2d 2d 20 52 65 |UI\_Redr|aw -- Re|
|00002720| 64 72 61 77 20 79 6f 75 | 72 73 65 6c 66 2e 7d 0a |draw you|rself.}.|
|00002730| 0a 5c 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 2a |.\subsub|section*|
|00002740| 7b 53 59 4e 4f 50 53 49 | 53 7d 0a 5c 62 65 67 69 |{SYNOPSI|S}.\begi|
|00002750| 6e 7b 74 61 62 62 69 6e | 67 7d 0a 4d 55 49 5c 5f |n{tabbin|g}.MUI\_|
|00002760| 52 65 64 72 61 77 28 20 | 5c 3d 6f 62 6a 2c 20 5c |Redraw( |\=obj, \|
|00002770| 3d 66 6c 61 67 20 29 5c | 5c 0a 5c 3e 41 30 20 20 |=flag )\|\.\>A0 |
|00002780| 20 5c 3e 44 30 0a 5c 65 | 6e 64 7b 74 61 62 62 69 | \>D0.\e|nd{tabbi|
|00002790| 6e 67 7d 0a 0a 56 4f 49 | 44 20 4d 55 49 5c 5f 52 |ng}..VOI|D MUI\_R|
|000027a0| 65 64 72 61 77 28 20 4f | 62 6a 65 63 74 20 24 5c |edraw( O|bject $\|
|000027b0| 61 73 74 24 6f 62 6a 2c | 20 55 4c 4f 4e 47 20 66 |ast$obj,| ULONG f|
|000027c0| 6c 61 67 20 29 3b 0a 0a | 5c 73 75 62 73 75 62 73 |lag );..|\subsubs|
|000027d0| 65 63 74 69 6f 6e 2a 7b | 46 55 4e 43 54 49 4f 4e |ection*{|FUNCTION|
|000027e0| 7d 0a 57 69 74 68 20 4d | 55 49 5c 5f 52 65 64 72 |}.With M|UI\_Redr|
|000027f0| 61 77 28 29 2c 20 61 6e | 20 6f 62 6a 65 63 74 20 |aw(), an| object |
|00002800| 74 65 6c 6c 73 20 69 74 | 73 65 6c 66 20 74 6f 20 |tells it|self to |
|00002810| 72 65 66 72 65 73 68 2c | 20 65 2e 67 2e 20 77 68 |refresh,| e.g. wh|
|00002820| 65 6e 0a 73 6f 6d 65 20 | 69 6e 74 65 72 6e 61 6c |en.some |internal|
|00002830| 20 61 74 74 72 69 62 75 | 74 65 73 20 77 65 72 65 | attribu|tes were|
|00002840| 20 63 68 61 6e 67 65 64 | 2e 20 43 61 6c 6c 69 6e | changed|. Callin|
|00002850| 67 20 4d 55 49 5c 5f 52 | 65 64 72 61 77 28 29 20 |g MUI\_R|edraw() |
|00002860| 69 73 0a 6f 6e 6c 79 20 | 6c 65 67 61 6c 20 77 69 |is.only |legal wi|
|00002870| 74 68 69 6e 20 61 20 63 | 75 73 74 6f 6d 20 63 6c |thin a c|ustom cl|
|00002880| 61 73 73 20 64 69 73 70 | 61 74 63 68 65 72 2c 20 |ass disp|atcher, |
|00002890| 75 73 69 6e 67 20 74 68 | 69 73 20 66 75 6e 63 74 |using th|is funct|
|000028a0| 69 6f 6e 0a 77 69 74 68 | 69 6e 20 61 6e 20 61 70 |ion.with|in an ap|
|000028b0| 70 6c 69 63 61 74 69 6f | 6e 73 20 6d 61 69 6e 20 |plicatio|ns main |
|000028c0| 70 61 72 74 20 69 73 20 | 69 6e 76 61 6c 69 64 21 |part is |invalid!|
|000028d0| 0a 0a 4d 6f 73 74 20 6f | 62 6a 65 63 74 73 20 67 |..Most o|bjects g|
|000028e0| 72 61 70 68 69 63 61 6c | 20 72 65 70 72 65 73 65 |raphical| represe|
|000028f0| 6e 74 61 74 69 6f 6e 20 | 69 6e 20 61 20 77 69 6e |ntation |in a win|
|00002900| 64 6f 77 20 64 65 70 65 | 6e 64 73 20 6f 6e 20 73 |dow depe|nds on s|
|00002910| 6f 6d 65 0a 61 74 74 72 | 69 62 75 74 65 73 2e 20 |ome.attr|ibutes. |
|00002920| 41 20 66 75 65 6c 20 67 | 61 75 67 65 20 66 6f 72 |A fuel g|auge for|
|00002930| 20 65 78 61 6d 70 6c 65 | 20 77 6f 75 6c 64 20 64 | example| would d|
|00002940| 65 70 65 6e 64 20 6f 6e | 20 69 74 73 0a 4d 55 49 |epend on| its.MUI|
|00002950| 41 5c 5f 47 61 75 67 65 | 5c 5f 43 75 72 72 65 6e |A\_Gauge|\_Curren|
|00002960| 74 20 61 74 74 72 69 62 | 75 74 65 2c 20 61 6e 20 |t attrib|ute, an |
|00002970| 61 6e 69 6d 61 74 69 6f | 6e 20 6f 62 6a 65 63 74 |animatio|n object|
|00002980| 20 77 6f 75 6c 64 0a 64 | 65 70 65 6e 64 20 6f 6e | would.d|epend on|
|00002990| 20 4d 55 49 41 5c 5f 41 | 6e 69 6d 61 74 69 6f 6e | MUIA\_A|nimation|
|000029a0| 5c 5f 43 75 72 72 65 6e | 74 46 72 61 6d 65 2e 0a |\_Curren|tFrame..|
|000029b0| 0a 57 68 65 6e 65 76 65 | 72 20 73 6f 6d 65 6f 6e |.Wheneve|r someon|
|000029c0| 65 20 63 68 61 6e 67 65 | 73 20 73 75 63 68 20 61 |e change|s such a|
|000029d0| 6e 20 61 74 74 72 69 62 | 75 74 65 20 77 69 74 68 |n attrib|ute with|
|000029e0| 20 61 20 53 65 74 41 74 | 74 72 73 28 29 20 63 61 | a SetAt|trs() ca|
|000029f0| 6c 6c 2c 0a 74 68 65 20 | 63 6f 72 72 65 73 70 6f |ll,.the |correspo|
|00002a00| 6e 64 69 6e 67 20 6f 62 | 6a 65 63 74 20 72 65 63 |nding ob|ject rec|
|00002a10| 65 69 76 65 73 20 61 6e | 20 4f 4d 5c 5f 53 45 54 |eives an| OM\_SET|
|00002a20| 20 6d 65 74 68 6f 64 20 | 77 69 74 68 20 74 68 65 | method |with the|
|00002a30| 20 6e 65 77 0a 76 61 6c | 75 65 2e 20 55 73 75 61 | new.val|ue. Usua|
|00002a40| 6c 6c 79 2c 20 69 74 20 | 63 6f 75 6c 64 20 6a 75 |lly, it |could ju|
|00002a50| 73 74 20 72 65 6e 64 65 | 72 20 69 74 73 65 6c 66 |st rende|r itself|
|00002a60| 20 77 69 74 68 20 73 6f | 6d 65 0a 67 72 61 70 68 | with so|me.graph|
|00002a70| 69 63 73 2e 6c 69 62 72 | 61 72 79 20 63 61 6c 6c |ics.libr|ary call|
|00002a80| 73 2e 20 48 6f 77 65 76 | 65 72 2c 20 69 66 20 74 |s. Howev|er, if t|
|00002a90| 68 65 20 6f 62 6a 65 63 | 74 20 69 73 20 70 6c 61 |he objec|t is pla|
|00002aa0| 63 65 64 0a 69 6e 20 61 | 20 76 69 72 74 75 61 6c |ced.in a| virtual|
|00002ab0| 20 67 72 6f 75 70 20 6f | 72 20 69 66 20 73 6f 6d | group o|r if som|
|00002ac0| 65 20 6f 74 68 65 72 20 | 63 6c 69 70 70 69 6e 67 |e other |clipping|
|00002ad0| 20 6f 72 20 63 6f 6f 72 | 64 69 6e 61 74 65 0a 74 | or coor|dinate.t|
|00002ae0| 72 61 6e 73 6c 61 74 69 | 6f 6e 20 69 73 20 72 65 |ranslati|on is re|
|00002af0| 71 75 69 72 65 64 2c 20 | 74 68 69 73 20 73 69 6d |quired, |this sim|
|00002b00| 70 6c 65 20 72 65 6e 64 | 65 72 69 6e 67 20 77 69 |ple rend|ering wi|
|00002b10| 6c 6c 20 6c 65 61 64 0a | 69 6e 74 6f 20 70 72 6f |ll lead.|into pro|
|00002b20| 62 6c 65 6d 73 2e 0a 0a | 54 68 61 74 27 73 20 77 |blems...|That's w|
|00002b30| 68 79 20 4d 55 49 20 6f | 66 66 65 72 73 20 74 68 |hy MUI o|ffers th|
|00002b40| 65 20 4d 55 49 5c 5f 52 | 65 64 72 61 77 28 29 20 |e MUI\_R|edraw() |
|00002b50| 66 75 6e 63 74 69 6f 6e | 20 63 61 6c 6c 2e 20 49 |function| call. I|
|00002b60| 6e 73 74 65 61 64 0a 6f | 66 20 64 72 61 77 69 6e |nstead.o|f drawin|
|00002b70| 67 20 64 69 72 65 63 74 | 6c 79 20 64 75 72 69 6e |g direct|ly durin|
|00002b80| 67 20 4f 4d 5c 5f 53 45 | 54 2c 20 79 6f 75 20 73 |g OM\_SE|T, you s|
|00002b90| 68 6f 75 6c 64 20 73 69 | 6d 70 6c 79 20 63 61 6c |hould si|mply cal|
|00002ba0| 6c 0a 4d 55 49 5c 5f 52 | 65 64 72 61 77 28 29 2e |l.MUI\_R|edraw().|
|00002bb0| 20 4d 55 49 20 63 61 6c | 63 75 6c 61 74 65 73 20 | MUI cal|culates |
|00002bc0| 61 6c 6c 20 6e 65 63 65 | 73 73 61 72 79 20 63 6f |all nece|ssary co|
|00002bd0| 6f 72 64 69 6e 61 74 65 | 73 0a 61 6e 64 20 63 6c |ordinate|s.and cl|
|00002be0| 69 70 20 72 65 67 69 6f | 6e 73 20 28 69 6e 20 63 |ip regio|ns (in c|
|00002bf0| 61 73 65 20 6f 66 20 76 | 69 72 74 75 61 6c 20 67 |ase of v|irtual g|
|00002c00| 72 6f 75 70 73 29 20 61 | 6e 64 20 74 68 65 6e 20 |roups) a|nd then |
|00002c10| 73 65 6e 64 73 0a 61 20 | 4d 55 49 4d 5c 5f 44 72 |sends.a |MUIM\_Dr|
|00002c20| 61 77 20 6d 65 74 68 6f | 64 20 74 6f 20 79 6f 75 |aw metho|d to you|
|00002c30| 72 20 6f 62 6a 65 63 74 | 2e 0a 0a 54 6f 20 65 6d |r object|...To em|
|00002c40| 70 68 61 73 69 7a 65 20 | 74 68 69 73 20 70 6f 69 |phasize |this poi|
|00002c50| 6e 74 20 61 67 61 69 6e | 3a 20 54 68 65 20 6f 6e |nt again|: The on|
|00002c60| 6c 79 20 74 69 6d 65 20 | 79 6f 75 72 20 6f 62 6a |ly time |your obj|
|00002c70| 65 63 74 20 69 73 0a 61 | 6c 6c 6f 77 65 64 20 74 |ect is.a|llowed t|
|00002c80| 6f 20 72 65 6e 64 65 72 | 20 73 6f 6d 65 74 68 69 |o render| somethi|
|00002c90| 6e 67 20 69 73 20 77 68 | 65 6e 20 79 6f 75 20 72 |ng is wh|en you r|
|00002ca0| 65 63 65 69 76 65 20 61 | 20 4d 55 49 4d 5c 5f 44 |eceive a| MUIM\_D|
|00002cb0| 72 61 77 0a 6d 65 74 68 | 6f 64 2e 20 44 72 61 77 |raw.meth|od. Draw|
|00002cc0| 69 6e 67 20 64 75 72 69 | 6e 67 20 6f 74 68 65 72 |ing duri|ng other|
|00002cd0| 20 6d 65 74 68 6f 64 73 | 20 69 73 20 69 6c 6c 65 | methods| is ille|
|00002ce0| 67 61 6c 2e 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |gal...\s|ubsubsec|
|00002cf0| 74 69 6f 6e 2a 7b 4e 4f | 54 45 7d 0a 41 73 20 6c |tion*{NO|TE}.As l|
|00002d00| 6f 6e 67 20 61 73 20 6e | 6f 20 73 70 65 63 69 61 |ong as n|o specia|
|00002d10| 6c 20 63 61 73 65 73 20 | 28 65 2e 67 2e 20 76 69 |l cases |(e.g. vi|
|00002d20| 72 74 75 61 6c 20 67 72 | 6f 75 70 73 29 20 61 72 |rtual gr|oups) ar|
|00002d30| 65 0a 70 72 65 73 65 6e | 74 2c 20 4d 55 49 5c 5f |e.presen|t, MUI\_|
|00002d40| 52 65 64 72 61 77 20 69 | 73 20 76 65 72 79 20 71 |Redraw i|s very q|
|00002d50| 75 69 63 6b 20 61 6e 64 | 20 63 61 6c 6c 73 20 79 |uick and| calls y|
|00002d60| 6f 75 72 20 4d 55 49 4d | 5c 5f 44 72 61 77 0a 6d |our MUIM|\_Draw.m|
|00002d70| 65 74 68 6f 64 20 69 6d | 6d 65 64 69 61 74 65 6c |ethod im|mediatel|
|00002d80| 79 2e 20 4e 6f 20 63 6f | 6f 72 64 69 6e 61 74 65 |y. No co|ordinate|
|00002d90| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 73 20 6f 72 | transla|tions or|
|00002da0| 20 63 6c 69 70 0a 72 65 | 67 69 6f 6e 73 20 6e 65 | clip.re|gions ne|
|00002db0| 65 64 20 74 6f 20 62 65 | 20 63 61 6c 63 75 6c 61 |ed to be| calcula|
|00002dc0| 74 65 64 2e 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |ted...\s|ubsubsec|
|00002dd0| 74 69 6f 6e 2a 7b 49 4e | 50 55 54 53 7d 0a 5c 62 |tion*{IN|PUTS}.\b|
|00002de0| 65 67 69 6e 7b 64 65 73 | 63 72 69 70 74 69 6f 6e |egin{des|cription|
|00002df0| 7d 0a 5c 69 74 65 6d 5b | 6f 62 6a 5d 20 20 2d 20 |}.\item[|obj] - |
|00002e00| 70 6f 69 6e 74 65 72 20 | 74 6f 20 79 6f 75 72 73 |pointer |to yours|
|00002e10| 65 6c 66 2e 0a 5c 69 74 | 65 6d 5b 66 6c 61 67 5d |elf..\it|em[flag]|
|00002e20| 20 2d 20 4d 41 44 46 5c | 5f 44 52 41 57 4f 42 4a | - MADF\|_DRAWOBJ|
|00002e30| 45 43 54 20 6f 72 20 4d | 41 44 46 5c 5f 44 52 41 |ECT or M|ADF\_DRA|
|00002e40| 57 55 50 44 41 54 45 2e | 0a 54 68 65 20 66 6c 61 |WUPDATE.|.The fla|
|00002e50| 67 20 67 69 76 65 6e 20 | 68 65 72 65 20 61 66 66 |g given |here aff|
|00002e60| 65 63 74 73 20 74 68 65 | 20 6f 62 6a 65 63 74 73 |ects the| objects|
|00002e70| 20 66 6c 61 67 73 20 77 | 68 65 6e 0a 4d 55 49 20 | flags w|hen.MUI |
|00002e80| 63 61 6c 6c 73 20 74 68 | 65 20 4d 55 49 4d 5c 5f |calls th|e MUIM\_|
|00002e90| 44 72 61 77 20 6d 65 74 | 68 6f 64 2e 20 54 68 65 |Draw met|hod. The|
|00002ea0| 72 65 20 61 72 65 20 73 | 65 76 65 72 61 6c 0a 63 |re are s|everal.c|
|00002eb0| 61 76 65 61 74 73 20 77 | 68 65 6e 20 69 6d 70 6c |aveats w|hen impl|
|00002ec0| 65 6d 65 6e 74 69 6e 67 | 20 4d 55 49 4d 5c 5f 44 |ementing| MUIM\_D|
|00002ed0| 52 41 57 2c 20 73 65 65 | 20 74 68 65 0a 64 65 76 |RAW, see| the.dev|
|00002ee0| 65 6c 6f 70 65 72 20 64 | 6f 63 75 6d 65 6e 74 61 |eloper d|ocumenta|
|00002ef0| 74 69 6f 6e 20 66 6f 72 | 20 64 65 74 61 69 6c 73 |tion for| details|
|00002f00| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 70 74 69 |..\end{d|escripti|
|00002f10| 6f 6e 7d 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |on}..\su|bsubsect|
|00002f20| 69 6f 6e 2a 7b 45 58 41 | 4d 50 4c 45 7d 0a 5c 73 |ion*{EXA|MPLE}.\s|
|00002f30| 6d 61 6c 6c 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |mall.\be|gin{verb|
|00002f40| 61 74 69 6d 7d 0a 0a 2f | 2a 20 4e 6f 74 65 3a 20 |atim}../|* Note: |
|00002f50| 54 68 69 73 20 65 78 61 | 6d 70 6c 65 20 77 61 73 |This exa|mple was|
|00002f60| 20 62 72 6f 6b 65 6e 20 | 75 70 20 74 6f 20 76 65 | broken |up to ve|
|00002f70| 72 73 69 6f 6e 20 32 2e | 31 20 6f 66 20 6d 75 69 |rsion 2.|1 of mui|
|00002f80| 6d 61 73 74 65 72 2e 64 | 6f 63 20 2a 2f 0a 0a 4c |master.d|oc */..L|
|00002f90| 4f 4e 47 20 6d 53 65 74 | 28 73 74 72 75 63 74 20 |ONG mSet|(struct |
|00002fa0| 49 43 6c 61 73 73 20 2a | 63 6c 2c 4f 62 6a 65 63 |IClass *|cl,Objec|
|00002fb0| 74 20 2a 6f 62 6a 2c 73 | 72 75 63 74 20 6f 70 53 |t *obj,s|ruct opS|
|00002fc0| 65 74 20 2a 6d 73 67 29 | 0a 7b 0a 20 20 20 73 74 |et *msg)|.{. st|
|00002fd0| 72 75 63 74 20 44 61 74 | 61 20 2a 64 61 74 61 20 |ruct Dat|a *data |
|00002fe0| 3d 20 49 4e 53 54 5f 44 | 41 54 41 28 63 6c 2c 6f |= INST_D|ATA(cl,o|
|00002ff0| 62 6a 29 3b 0a 20 20 20 | 73 74 72 75 63 74 20 54 |bj);. |struct T|
|00003000| 61 67 49 74 65 6d 20 2a | 74 61 67 73 2c 2a 74 61 |agItem *|tags,*ta|
|00003010| 67 3b 0a 0a 20 20 20 66 | 6f 72 20 28 74 61 67 73 |g;.. f|or (tags|
|00003020| 3d 6d 73 67 2d 3e 6f 70 | 73 5f 41 74 74 72 4c 69 |=msg->op|s_AttrLi|
|00003030| 73 74 3b 74 61 67 3d 4e | 65 78 74 54 61 67 49 74 |st;tag=N|extTagIt|
|00003040| 65 6d 28 26 74 61 67 73 | 29 3b 29 0a 20 20 20 7b |em(&tags|);). {|
|00003050| 0a 20 20 20 20 20 20 73 | 77 69 74 63 68 20 28 74 |. s|witch (t|
|00003060| 61 67 2d 3e 74 69 5f 54 | 61 67 29 0a 20 20 20 20 |ag->ti_T|ag). |
|00003070| 20 20 7b 0a 20 20 20 20 | 20 20 20 20 20 63 61 73 | {. | cas|
|00003080| 65 20 4d 59 41 54 54 52 | 5f 50 45 4e 5f 31 3a 0a |e MYATTR|_PEN_1:.|
|00003090| 20 20 20 20 20 20 20 20 | 20 20 20 20 64 61 74 61 | | data|
|000030a0| 2d 3e 70 65 6e 31 20 3d | 20 74 61 67 2d 3e 74 69 |->pen1 =| tag->ti|
|000030b0| 5f 44 61 74 61 3b 20 20 | 20 20 20 20 20 2f 2a 20 |_Data; | /* |
|000030c0| 73 65 74 20 74 68 65 20 | 6e 65 77 20 76 61 6c 75 |set the |new valu|
|000030d0| 65 20 20 2a 2f 0a 20 20 | 20 20 20 20 20 20 20 20 |e */. | |
|000030e0| 20 20 64 61 74 61 2d 3e | 6d 61 72 6b 20 3d 20 31 | data->|mark = 1|
|000030f0| 3b 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |; | |
|00003100| 20 20 20 2f 2a 20 73 65 | 74 20 69 6e 74 65 72 6e | /* se|t intern|
|00003110| 61 6c 20 6d 61 72 6b 65 | 72 2a 2f 0a 20 20 20 20 |al marke|r*/. |
|00003120| 20 20 20 20 20 20 20 20 | 4d 55 49 5f 52 65 64 72 | |MUI_Redr|
|00003130| 61 77 28 6f 62 6a 2c 4d | 41 44 46 5f 44 52 41 57 |aw(obj,M|ADF_DRAW|
|00003140| 55 50 44 41 54 45 29 3b | 20 2f 2a 20 75 70 64 61 |UPDATE);| /* upda|
|00003150| 74 65 20 6f 75 72 73 65 | 6c 76 65 73 20 20 20 2a |te ourse|lves *|
|00003160| 2f 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 62 72 |/. | br|
|00003170| 65 61 6b 3b 0a 0a 20 20 | 20 20 20 20 20 20 20 63 |eak;.. | c|
|00003180| 61 73 65 20 4d 59 41 54 | 54 52 5f 50 45 4e 5f 31 |ase MYAT|TR_PEN_1|
|00003190| 3a 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 64 61 |:. | da|
|000031a0| 74 61 2d 3e 70 65 6e 32 | 20 3d 20 74 61 67 2d 3e |ta->pen2| = tag->|
|000031b0| 74 69 5f 44 61 74 61 3b | 20 20 20 20 20 20 20 2f |ti_Data;| /|
|000031c0| 2a 20 73 65 74 20 74 68 | 65 20 6e 65 77 20 76 61 |* set th|e new va|
|000031d0| 6c 75 65 20 20 2a 2f 0a | 20 20 20 20 20 20 20 20 |lue */.| |
|000031e0| 20 20 20 20 64 61 74 61 | 2d 3e 6d 61 72 6b 20 3d | data|->mark =|
|000031f0| 20 32 3b 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | 2; | |
|00003200| 20 20 20 20 20 2f 2a 20 | 73 65 74 20 69 6e 74 65 | /* |set inte|
|00003210| 72 6e 61 6c 20 6d 61 72 | 6b 65 72 2a 2f 0a 20 20 |rnal mar|ker*/. |
|00003220| 20 20 20 20 20 20 20 20 | 20 20 4d 55 49 5f 52 65 | | MUI_Re|
|00003230| 64 72 61 77 28 6f 62 6a | 2c 4d 41 44 46 5f 44 52 |draw(obj|,MADF_DR|
|00003240| 41 57 55 50 44 41 54 45 | 29 3b 20 2f 2a 20 75 70 |AWUPDATE|); /* up|
|00003250| 64 61 74 65 20 6f 75 72 | 73 65 6c 76 65 73 20 20 |date our|selves |
|00003260| 20 2a 2f 0a 20 20 20 20 | 20 20 20 20 20 20 20 20 | */. | |
|00003270| 62 72 65 61 6b 3b 0a 20 | 20 20 20 20 20 7d 0a 20 |break;. | }. |
|00003280| 20 20 7d 0a 0a 20 20 20 | 72 65 74 75 72 6e 28 44 | }.. |return(D|
|00003290| 6f 53 75 70 65 72 4d 65 | 74 68 6f 64 41 28 63 6c |oSuperMe|thodA(cl|
|000032a0| 2c 6f 62 6a 2c 6d 73 67 | 29 29 3b 0a 7d 0a 0a 4c |,obj,msg|));.}..L|
|000032b0| 4f 4e 47 20 6d 44 72 61 | 77 28 73 74 72 75 63 74 |ONG mDra|w(struct|
|000032c0| 20 49 43 6c 61 73 73 20 | 2a 63 6c 2c 4f 62 6a 65 | IClass |*cl,Obje|
|000032d0| 63 74 20 2a 6f 62 6a 2c | 73 74 72 75 63 74 20 4d |ct *obj,|struct M|
|000032e0| 55 49 50 5f 44 72 61 77 | 20 2a 6d 73 67 29 0a 7b |UIP_Draw| *msg).{|
|000032f0| 0a 20 20 20 73 74 72 75 | 63 74 20 44 61 74 61 20 |. stru|ct Data |
|00003300| 2a 64 61 74 61 20 3d 20 | 49 4e 53 54 5f 44 41 54 |*data = |INST_DAT|
|00003310| 41 28 63 6c 2c 6f 62 6a | 29 3b 0a 0a 20 20 20 2f |A(cl,obj|);.. /|
|00003320| 2f 20 2a 2a 20 4e 6f 74 | 65 3a 20 59 6f 75 20 2a |/ ** Not|e: You *|
|00003330| 6d 75 73 74 2a 20 63 61 | 6c 6c 20 74 68 65 20 73 |must* ca|ll the s|
|00003340| 75 70 65 72 20 6d 65 74 | 68 6f 64 20 70 72 69 6f |uper met|hod prio|
|00003350| 72 20 74 6f 20 64 6f 0a | 20 20 20 2f 2f 20 2a 2a |r to do.| // **|
|00003360| 20 61 6e 79 74 68 69 6e | 67 20 65 6c 73 65 2c 20 | anythin|g else, |
|00003370| 6f 74 68 65 72 77 69 73 | 65 20 6d 73 67 2d 3e 66 |otherwis|e msg->f|
|00003380| 6c 61 67 73 20 77 69 6c | 6c 20 6e 6f 74 20 62 65 |lags wil|l not be|
|00003390| 20 73 65 74 0a 20 20 20 | 2f 2f 20 2a 2a 20 70 72 | set. |// ** pr|
|000033a0| 6f 70 65 72 6c 79 20 21 | 21 21 0a 0a 20 20 20 44 |operly !|!!.. D|
|000033b0| 6f 53 75 70 65 72 4d 65 | 74 68 6f 64 41 28 63 6c |oSuperMe|thodA(cl|
|000033c0| 2c 6f 62 6a 2c 6d 73 67 | 29 3b 20 2f 2f 20 41 4c |,obj,msg|); // AL|
|000033d0| 57 41 59 53 20 52 45 51 | 55 49 52 45 44 21 0a 0a |WAYS REQ|UIRED!..|
|000033e0| 20 20 20 69 66 20 28 6d | 73 67 2d 3e 66 6c 61 67 | if (m|sg->flag|
|000033f0| 73 20 26 20 4d 41 44 46 | 5f 44 52 41 57 55 50 44 |s & MADF|_DRAWUPD|
|00003400| 41 54 45 29 0a 20 20 20 | 7b 0a 20 20 20 20 20 20 |ATE). |{. |
|00003410| 2f 2a 20 63 61 6c 6c 65 | 64 20 61 73 20 61 20 72 |/* calle|d as a r|
|00003420| 65 73 75 6c 74 20 6f 66 | 20 6f 75 72 20 4d 55 49 |esult of| our MUI|
|00003430| 5f 52 65 64 72 61 77 28 | 29 20 64 75 72 69 6e 67 |_Redraw(|) during|
|00003440| 0a 20 20 20 20 20 20 20 | 20 20 4d 55 49 4d 5f 53 |. | MUIM_S|
|00003450| 65 74 20 6d 65 74 68 6f | 64 2e 20 44 65 70 65 6e |et metho|d. Depen|
|00003460| 64 69 6e 67 20 6f 6e 20 | 6f 75 72 20 69 6e 74 65 |ding on |our inte|
|00003470| 72 6e 61 6c 0a 20 20 20 | 20 20 20 20 20 20 6d 61 |rnal. | ma|
|00003480| 72 6b 65 72 2c 20 77 65 | 20 72 65 6e 64 65 72 20 |rker, we| render |
|00003490| 64 69 66 66 65 72 65 6e | 74 20 74 68 69 6e 67 73 |differen|t things|
|000034a0| 2e 20 2a 2f 0a 0a 20 20 | 20 20 20 20 73 77 69 74 |. */.. | swit|
|000034b0| 63 68 20 28 64 61 74 61 | 2d 3e 6d 61 72 6b 29 0a |ch (data|->mark).|
|000034c0| 20 20 20 20 20 20 7b 0a | 20 20 20 20 20 20 20 20 | {.| |
|000034d0| 20 63 61 73 65 20 31 3a | 20 52 65 6e 64 65 72 43 | case 1:| RenderC|
|000034e0| 68 61 6e 67 65 73 46 72 | 6f 6d 50 65 6e 31 28 63 |hangesFr|omPen1(c|
|000034f0| 6c 2c 6f 62 6a 29 3b 20 | 62 72 65 61 6b 3b 0a 20 |l,obj); |break;. |
|00003500| 20 20 20 20 20 20 20 20 | 63 61 73 65 20 32 3a 20 | |case 2: |
|00003510| 52 65 6e 64 65 72 43 68 | 61 6e 67 65 73 46 72 6f |RenderCh|angesFro|
|00003520| 6d 50 65 6e 32 28 63 6c | 2c 6f 62 6a 29 3b 20 62 |mPen2(cl|,obj); b|
|00003530| 72 65 61 6b 3b 0a 20 20 | 20 20 20 20 7d 0a 20 20 |reak;. | }. |
|00003540| 20 7d 0a 20 20 20 65 6c | 73 65 20 69 66 20 28 6d | }. el|se if (m|
|00003550| 73 67 2d 3e 66 6c 61 67 | 73 20 26 20 4d 41 44 46 |sg->flag|s & MADF|
|00003560| 5f 44 52 41 57 4f 42 4a | 45 43 54 29 0a 20 20 20 |_DRAWOBJ|ECT). |
|00003570| 7b 0a 20 20 20 20 20 20 | 2f 2a 20 63 6f 6d 70 6c |{. |/* compl|
|00003580| 65 74 65 20 72 65 64 72 | 61 77 2c 20 6d 61 79 62 |ete redr|aw, mayb|
|00003590| 65 20 74 68 65 20 77 69 | 6e 64 6f 77 20 77 61 73 |e the wi|ndow was|
|000035a0| 20 6a 75 73 74 20 6f 70 | 65 6e 65 64 2e 20 2a 2f | just op|ened. */|
|000035b0| 0a 20 20 20 20 20 20 44 | 72 61 77 4f 62 6a 65 63 |. D|rawObjec|
|000035c0| 74 43 6f 6d 70 6c 65 74 | 65 6c 79 28 63 6c 2c 6f |tComplet|ely(cl,o|
|000035d0| 62 6a 29 3b 0a 20 20 20 | 7d 0a 0a 20 20 20 2f 2a |bj);. |}.. /*|
|000035e0| 20 69 66 20 4d 41 44 46 | 5f 44 52 41 57 4f 42 4a | if MADF|_DRAWOBJ|
|000035f0| 45 43 54 20 77 61 73 6e | 27 74 20 73 65 74 2c 20 |ECT wasn|'t set, |
|00003600| 4d 55 49 20 6a 75 73 74 | 20 77 61 6e 74 65 64 20 |MUI just| wanted |
|00003610| 74 6f 20 75 70 64 61 74 | 65 0a 20 20 20 20 20 20 |to updat|e. |
|00003620| 74 68 65 20 66 72 61 6d | 65 20 6f 72 20 73 6f 6d |the fram|e or som|
|00003630| 65 20 6f 74 68 65 72 20 | 70 61 72 74 20 6f 66 20 |e other |part of |
|00003640| 6f 75 72 20 6f 62 6a 65 | 63 74 2e 20 49 6e 20 74 |our obje|ct. In t|
|00003650| 68 69 73 20 63 61 73 65 | 0a 20 20 20 20 20 20 77 |his case|. w|
|00003660| 65 20 6a 75 73 74 20 64 | 6f 20 6e 6f 74 68 69 6e |e just d|o nothin|
|00003670| 67 2e 20 2a 2f 0a 0a 20 | 20 20 20 72 65 74 75 72 |g. */.. | retur|
|00003680| 6e 28 30 29 3b 0a 7d 0a | 0a 5c 65 6e 64 7b 76 65 |n(0);.}.|.\end{ve|
|00003690| 72 62 61 74 69 6d 7d 0a | 5c 6e 6f 72 6d 61 6c 73 |rbatim}.|\normals|
|000036a0| 69 7a 65 0a 5c 73 75 62 | 73 75 62 73 65 63 74 69 |ize.\sub|subsecti|
|000036b0| 6f 6e 2a 7b 53 45 45 20 | 41 4c 53 4f 7d 0a 61 72 |on*{SEE |ALSO}.ar|
|000036c0| 65 61 2e 6d 75 69 2f 4d | 55 49 4d 5c 5f 44 72 61 |ea.mui/M|UIM\_Dra|
|000036d0| 77 0a 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 5b |w...\sub|section[|
|000036e0| 4d 55 49 5c 5f 52 65 71 | 75 65 73 74 41 5d 7b 4d |MUI\_Req|uestA]{M|
|000036f0| 55 49 5c 5f 52 65 71 75 | 65 73 74 41 20 20 2d 2d |UI\_Requ|estA --|
|00003700| 20 50 6f 70 20 75 70 20 | 61 20 4d 55 49 20 72 65 | Pop up |a MUI re|
|00003710| 71 75 65 73 74 65 72 2e | 7d 0a 0a 5c 73 75 62 73 |quester.|}..\subs|
|00003720| 75 62 73 65 63 74 69 6f | 6e 2a 7b 53 59 4e 4f 50 |ubsectio|n*{SYNOP|
|00003730| 53 49 53 7d 0a 5c 62 65 | 67 69 6e 7b 74 61 62 62 |SIS}.\be|gin{tabb|
|00003740| 69 6e 67 7d 0a 4d 55 49 | 5c 5f 52 65 71 75 65 73 |ing}.MUI|\_Reques|
|00003750| 74 41 28 5c 3d 61 70 70 | 2c 5c 3d 77 69 6e 2c 5c |tA(\=app|,\=win,\|
|00003760| 3d 66 6c 61 67 73 2c 5c | 3d 74 69 74 6c 65 2c 5c |=flags,\|=title,\|
|00003770| 3d 67 61 64 67 65 74 73 | 2c 5c 3d 66 6f 72 6d 61 |=gadgets|,\=forma|
|00003780| 74 2c 5c 3d 70 61 72 61 | 6d 73 29 5c 5c 0a 5c 3e |t,\=para|ms)\\.\>|
|00003790| 44 30 20 20 20 5c 3e 44 | 31 20 20 5c 3e 44 32 20 |D0 \>D|1 \>D2 |
|000037a0| 20 20 20 5c 3e 41 30 20 | 20 20 20 20 5c 3e 41 31 | \>A0 | \>A1|
|000037b0| 20 20 20 20 20 20 5c 3e | 41 32 20 20 20 20 20 5c | \>|A2 \|
|000037c0| 3e 41 33 0a 5c 65 6e 64 | 7b 74 61 62 62 69 6e 67 |>A3.\end|{tabbing|
|000037d0| 7d 0a 0a 4c 4f 4e 47 20 | 4d 55 49 5c 5f 52 65 71 |}..LONG |MUI\_Req|
|000037e0| 75 65 73 74 41 20 28 20 | 41 50 54 52 20 61 70 70 |uestA ( |APTR app|
|000037f0| 2c 20 41 50 54 52 20 77 | 69 6e 2c 20 4c 4f 4e 47 |, APTR w|in, LONG|
|00003800| 42 49 54 53 20 66 6c 61 | 67 73 2c 0a 63 68 61 72 |BITS fla|gs,.char|
|00003810| 20 24 5c 61 73 74 24 74 | 69 74 6c 65 2c 20 63 68 | $\ast$t|itle, ch|
|00003820| 61 72 20 24 5c 61 73 74 | 24 67 61 64 67 65 74 73 |ar $\ast|$gadgets|
|00003830| 2c 20 63 68 61 72 20 24 | 5c 61 73 74 24 66 6f 72 |, char $|\ast$for|
|00003840| 6d 61 74 2c 20 41 50 54 | 52 20 70 61 72 61 6d 73 |mat, APT|R params|
|00003850| 20 29 3b 0a 0a 4c 4f 4e | 47 20 4d 55 49 5c 5f 52 | );..LON|G MUI\_R|
|00003860| 65 71 75 65 73 74 20 28 | 20 41 50 54 52 20 61 70 |equest (| APTR ap|
|00003870| 70 2c 20 41 50 54 52 20 | 77 69 6e 2c 20 4c 4f 4e |p, APTR |win, LON|
|00003880| 47 42 49 54 53 20 66 6c | 61 67 73 2c 0a 63 68 61 |GBITS fl|ags,.cha|
|00003890| 72 20 24 5c 61 73 74 24 | 74 69 74 6c 65 2c 20 63 |r $\ast$|title, c|
|000038a0| 68 61 72 20 24 5c 61 73 | 74 24 67 61 64 67 65 74 |har $\as|t$gadget|
|000038b0| 73 2c 20 63 68 61 72 20 | 24 5c 61 73 74 24 66 6f |s, char |$\ast$fo|
|000038c0| 72 6d 61 74 2c 20 2e 2e | 2e 29 3b 0a 0a a0 20 20 |rmat, ..|.);... |
|000038d0| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|000038e0| 46 55 4e 43 54 49 4f 4e | 7d 0a 50 6f 70 20 75 70 |FUNCTION|}.Pop up|
|000038f0| 20 61 20 4d 55 49 20 72 | 65 71 75 65 73 74 65 72 | a MUI r|equester|
|00003900| 2e 20 55 73 69 6e 67 20 | 61 20 4d 55 49 20 72 65 |. Using |a MUI re|
|00003910| 71 75 65 73 74 65 72 20 | 69 6e 73 74 65 61 64 0a |quester |instead.|
|00003920| 6f 66 20 61 20 73 74 61 | 6e 64 61 72 64 20 73 79 |of a sta|ndard sy|
|00003930| 73 74 65 6d 20 72 65 71 | 75 65 73 74 65 72 20 6f |stem req|uester o|
|00003940| 66 66 65 72 73 20 79 6f | 75 20 74 68 65 20 70 6f |ffers yo|u the po|
|00003950| 73 73 69 62 69 6c 69 74 | 79 0a 74 6f 20 69 6e 63 |ssibilit|y.to inc|
|00003960| 6c 75 64 65 20 74 65 78 | 74 20 63 6f 6e 74 61 69 |lude tex|t contai|
|00003970| 6e 69 6e 67 20 61 6c 6c | 20 74 68 65 20 74 65 78 |ning all| the tex|
|00003980| 74 20 65 6e 67 69 6e 65 | 20 66 6f 72 6d 61 74 20 |t engine| format |
|00003990| 63 6f 64 65 73 2e 0a 0a | 5c 73 75 62 73 75 62 73 |codes...|\subsubs|
|000039a0| 65 63 74 69 6f 6e 2a 7b | 49 4e 50 55 54 53 7d 0a |ection*{|INPUTS}.|
|000039b0| 5c 62 65 67 69 6e 7b 64 | 65 73 63 72 69 70 74 69 |\begin{d|escripti|
|000039c0| 6f 6e 7d 0a 5c 69 74 65 | 6d 5b 61 70 70 5d 20 20 |on}.\ite|m[app] |
|000039d0| 20 20 20 2d 20 54 68 65 | 20 61 70 70 6c 69 63 61 | - The| applica|
|000039e0| 74 69 6f 6e 20 6f 62 6a | 65 63 74 2e 20 49 66 20 |tion obj|ect. If |
|000039f0| 79 6f 75 20 6c 65 61 76 | 65 20 74 68 69 73 0a 4e |you leav|e this.N|
|00003a00| 55 4c 4c 2c 20 4d 55 49 | 5c 5f 52 65 71 75 65 73 |ULL, MUI|\_Reques|
|00003a10| 74 41 28 29 20 77 69 6c | 6c 20 66 61 6c 6c 20 62 |tA() wil|l fall b|
|00003a20| 61 63 6b 20 74 6f 20 61 | 0a 73 74 61 6e 64 61 72 |ack to a|.standar|
|00003a30| 64 20 73 79 73 74 65 6d | 20 72 65 71 75 65 73 74 |d system| request|
|00003a40| 65 72 2e 0a 0a 5c 69 74 | 65 6d 5b 77 69 6e 5d 20 |er...\it|em[win] |
|00003a50| 20 20 20 20 2d 20 50 6f | 69 6e 74 65 72 20 74 6f | - Po|inter to|
|00003a60| 20 61 20 77 69 6e 64 6f | 77 20 6f 66 20 74 68 65 | a windo|w of the|
|00003a70| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 2e 20 49 66 | applica|tion. If|
|00003a80| 0a 74 68 69 73 20 69 73 | 20 75 73 65 64 2c 20 74 |.this is| used, t|
|00003a90| 68 65 20 72 65 71 75 65 | 73 74 65 72 20 77 69 6c |he reque|ster wil|
|00003aa0| 6c 20 61 70 70 65 61 72 | 20 63 65 6e 74 65 72 65 |l appear| centere|
|00003ab0| 64 0a 72 65 6c 61 74 69 | 76 65 20 74 6f 20 74 68 |d.relati|ve to th|
|00003ac0| 69 73 20 77 69 6e 64 6f | 77 2e 0a 0a 5c 69 74 65 |is windo|w...\ite|
|00003ad0| 6d 5b 66 6c 61 67 73 5d | 20 20 20 2d 20 46 6f 72 |m[flags]| - For|
|00003ae0| 20 66 75 74 75 72 65 20 | 65 78 70 61 6e 73 69 6f | future |expansio|
|00003af0| 6e 2c 20 6d 75 73 74 20 | 62 65 20 30 20 66 6f 72 |n, must |be 0 for|
|00003b00| 20 6e 6f 77 2e 0a 0a 5c | 69 74 65 6d 5b 74 69 74 | now...\|item[tit|
|00003b10| 6c 65 5d 20 20 20 2d 20 | 54 69 74 6c 65 20 66 6f |le] - |Title fo|
|00003b20| 72 20 74 68 65 20 72 65 | 71 75 65 73 74 65 72 20 |r the re|quester |
|00003b30| 77 69 6e 64 6f 77 2e 20 | 44 65 66 61 75 6c 74 73 |window. |Defaults|
|00003b40| 20 74 6f 20 74 68 65 0a | 6e 61 6d 65 20 6f 66 20 | to the.|name of |
|00003b50| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |the appl|ication |
|00003b60| 77 68 65 6e 20 4e 55 4c | 4c 20 28 61 6e 64 20 61 |when NUL|L (and a|
|00003b70| 70 70 21 3d 4e 55 4c 4c | 29 2e 0a 0a 5c 69 74 65 |pp!=NULL|)...\ite|
|00003b80| 6d 5b 67 61 64 67 65 74 | 73 5d 20 2d 20 50 6f 69 |m[gadget|s] - Poi|
|00003b90| 6e 74 65 72 20 74 6f 20 | 61 20 73 74 72 69 6e 67 |nter to |a string|
|00003ba0| 20 63 6f 6e 74 61 69 6e | 69 6e 67 20 74 68 65 20 | contain|ing the |
|00003bb0| 70 6f 73 73 69 62 6c 65 | 20 61 6e 73 77 65 72 73 |possible| answers|
|00003bc0| 2e 0a 54 68 65 20 66 6f | 72 6d 61 74 20 6c 6f 6f |..The fo|rmat loo|
|00003bd0| 6b 73 20 6c 69 6b 65 20 | 27 27 5c 5f 53 61 76 65 |ks like |''\_Save|
|00003be0| 7c 5c 5f 55 73 65 7c 5c | 5f 54 65 73 74 7c 5c 5f ||\_Use|\|_Test|\_|
|00003bf0| 43 61 6e 63 65 6c 27 27 | 2e 0a 49 66 20 79 6f 75 |Cancel''|..If you|
|00003c00| 20 70 72 65 63 65 64 65 | 20 61 6e 20 65 6e 74 72 | precede| an entr|
|00003c10| 79 20 77 69 74 68 20 61 | 20 27 24 5c 61 73 74 24 |y with a| '$\ast$|
|00003c20| 27 2c 20 74 68 69 73 20 | 61 6e 73 77 65 72 20 77 |', this |answer w|
|00003c30| 69 6c 6c 0a 62 65 63 6f | 6d 65 20 74 68 65 20 61 |ill.beco|me the a|
|00003c40| 63 74 69 76 65 20 6f 62 | 6a 65 63 74 2e 20 50 72 |ctive ob|ject. Pr|
|00003c50| 65 73 73 69 6e 67 20 3c | 52 65 74 75 72 6e 3e 20 |essing <|Return> |
|00003c60| 77 69 6c 6c 0a 74 65 72 | 6d 69 6e 61 74 65 20 74 |will.ter|minate t|
|00003c70| 68 65 20 72 65 71 75 65 | 73 74 65 72 20 77 69 74 |he reque|ster wit|
|00003c80| 68 20 74 68 69 73 20 72 | 65 73 70 6f 6e 73 65 2e |h this r|esponse.|
|00003c90| 20 41 20 27 5c 5f 27 0a | 63 68 61 72 61 63 74 65 | A '\_'.|characte|
|00003ca0| 72 20 69 6e 64 69 63 61 | 74 65 73 20 74 68 65 20 |r indica|tes the |
|00003cb0| 6b 65 79 62 6f 61 72 64 | 20 73 68 6f 72 74 63 75 |keyboard| shortcu|
|00003cc0| 74 20 66 6f 72 20 74 68 | 69 73 0a 72 65 73 70 6f |t for th|is.respo|
|00003cd0| 6e 73 65 2e 0a 0a 5c 69 | 74 65 6d 5b 66 6f 72 6d |nse...\i|tem[form|
|00003ce0| 61 74 5d 20 20 2d 20 41 | 20 70 72 69 6e 74 66 2d |at] - A| printf-|
|00003cf0| 73 74 79 6c 65 20 66 6f | 72 6d 61 74 74 69 6e 67 |style fo|rmatting|
|00003d00| 20 73 74 72 69 6e 67 2e | 0a 0a 5c 69 74 65 6d 5b | string.|..\item[|
|00003d10| 70 61 72 61 6d 73 5d 20 | 20 2d 20 50 6f 69 6e 74 |params] | - Point|
|00003d20| 65 72 20 74 6f 20 61 6e | 20 61 72 72 61 79 20 6f |er to an| array o|
|00003d30| 66 20 55 4c 4f 4e 47 20 | 63 6f 6e 74 61 69 6e 69 |f ULONG |containi|
|00003d40| 6e 67 20 74 68 65 20 70 | 61 72 61 6d 65 74 65 72 |ng the p|arameter|
|00003d50| 0a 76 61 6c 75 65 73 20 | 66 6f 72 20 66 6f 72 6d |.values |for form|
|00003d60| 61 74 2e 0a 5c 65 6e 64 | 7b 64 65 73 63 72 69 70 |at..\end|{descrip|
|00003d70| 74 69 6f 6e 7d 0a 0a 5c | 73 75 62 73 75 62 73 65 |tion}..\|subsubse|
|00003d80| 63 74 69 6f 6e 2a 7b 52 | 45 53 55 4c 54 7d 0a 30 |ction*{R|ESULT}.0|
|00003d90| 2c 20 31 2c 20 2e 2e 2e | 2c 20 4e 20 3d 20 53 75 |, 1, ...|, N = Su|
|00003da0| 63 63 65 73 73 69 76 65 | 20 69 64 20 76 61 6c 75 |ccessive| id valu|
|00003db0| 65 73 2c 20 66 6f 72 20 | 74 68 65 20 67 61 64 67 |es, for |the gadg|
|00003dc0| 65 74 73 0a 79 6f 75 20 | 73 70 65 63 69 66 79 20 |ets.you |specify |
|00003dd0| 66 6f 72 20 74 68 65 20 | 72 65 71 75 65 73 74 65 |for the |requeste|
|00003de0| 72 2e 20 20 7b 5c 62 66 | 20 4e 4f 54 45 3a 7d 20 |r. {\bf| NOTE:} |
|00003df0| 54 68 65 20 6e 75 6d 62 | 65 72 69 6e 67 0a 66 72 |The numb|ering.fr|
|00003e00| 6f 6d 20 6c 65 66 74 20 | 74 6f 20 72 69 67 68 74 |om left |to right|
|00003e10| 20 69 73 20 61 63 74 75 | 61 6c 6c 79 3a 20 31 2c | is actu|ally: 1,|
|00003e20| 20 32 2c 20 2e 2e 2e 2c | 20 4e 2c 20 30 2e 0a 49 | 2, ...,| N, 0..I|
|00003e30| 6e 20 63 61 73 65 20 6f | 66 20 61 20 70 72 6f 62 |n case o|f a prob|
|00003e40| 6c 65 6d 20 28 65 2e 67 | 2e 20 6f 75 74 20 6f 66 |lem (e.g|. out of|
|00003e50| 20 6d 65 6d 6f 72 79 29 | 2c 20 74 68 65 0a 66 75 | memory)|, the.fu|
|00003e60| 6e 63 74 69 6f 6e 20 72 | 65 74 75 72 6e 73 20 46 |nction r|eturns F|
|00003e70| 41 4c 53 45 2e 0a 0a 5c | 73 75 62 73 75 62 73 65 |ALSE...\|subsubse|
|00003e80| 63 74 69 6f 6e 2a 7b 53 | 45 45 20 41 4c 53 4f 7d |ction*{S|EE ALSO}|
|00003e90| 0a 4d 55 49 41 5c 5f 54 | 65 78 74 5c 5f 43 6f 6e |.MUIA\_T|ext\_Con|
|00003ea0| 74 65 6e 74 73 0a 0a 0a | 5c 73 75 62 73 65 63 74 |tents...|\subsect|
|00003eb0| 69 6f 6e 5b 4d 55 49 5c | 5f 52 65 6a 65 63 74 49 |ion[MUI\|_RejectI|
|00003ec0| 44 43 4d 50 5d 7b 4d 55 | 49 5c 5f 52 65 6a 65 63 |DCMP]{MU|I\_Rejec|
|00003ed0| 74 49 44 43 4d 50 20 2d | 2d 20 52 65 6a 65 63 74 |tIDCMP -|- Reject|
|00003ee0| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 72 65 71 75 | previou|sly requ|
|00003ef0| 65 73 74 65 64 20 69 6e | 70 75 74 20 65 76 65 6e |ested in|put even|
|00003f00| 74 73 2e 7d 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |ts.}..\s|ubsubsec|
|00003f10| 74 69 6f 6e 2a 7b 53 59 | 4e 4f 50 53 49 53 7d 0a |tion*{SY|NOPSIS}.|
|00003f20| 5c 62 65 67 69 6e 7b 74 | 61 62 62 69 6e 67 7d 0a |\begin{t|abbing}.|
|00003f30| 4d 55 49 5c 5f 52 65 6a | 65 63 74 49 44 43 4d 50 |MUI\_Rej|ectIDCMP|
|00003f40| 28 20 5c 3d 6f 62 6a 2c | 20 5c 3d 66 6c 61 67 73 |( \=obj,| \=flags|
|00003f50| 20 29 5c 5c 0a 5c 3e 41 | 30 20 20 20 5c 3e 44 30 | )\\.\>A|0 \>D0|
|00003f60| 0a 5c 65 6e 64 7b 74 61 | 62 62 69 6e 67 7d 0a 0a |.\end{ta|bbing}..|
|00003f70| 56 4f 49 44 20 4d 55 49 | 5c 5f 52 65 6a 65 63 74 |VOID MUI|\_Reject|
|00003f80| 49 44 43 4d 50 28 20 4f | 62 6a 65 63 74 20 24 5c |IDCMP( O|bject $\|
|00003f90| 61 73 74 24 6f 62 6a 2c | 20 55 4c 4f 4e 47 20 66 |ast$obj,| ULONG f|
|00003fa0| 6c 61 67 73 20 29 3b 0a | 0a a0 20 20 5c 73 75 62 |lags );.|.. \sub|
|00003fb0| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 46 55 4e 43 |subsecti|on*{FUNC|
|00003fc0| 54 49 4f 4e 7d 0a 52 65 | 6a 65 63 74 20 70 72 65 |TION}.Re|ject pre|
|00003fd0| 76 69 6f 75 73 6c 79 20 | 72 65 71 75 65 73 74 65 |viously |requeste|
|00003fe0| 64 20 69 6e 70 75 74 20 | 65 76 65 6e 74 73 2e 20 |d input |events. |
|00003ff0| 59 6f 75 20 73 68 6f 75 | 6c 64 0a 65 6e 73 75 72 |You shou|ld.ensur|
|00004000| 65 20 74 68 61 74 20 79 | 6f 75 20 72 65 6a 65 63 |e that y|ou rejec|
|00004010| 74 20 61 6c 6c 20 69 6e | 70 75 74 20 65 76 65 6e |t all in|put even|
|00004020| 74 73 20 79 6f 75 20 72 | 65 71 75 65 73 74 65 64 |ts you r|equested|
|00004030| 0a 66 6f 72 20 61 6e 20 | 6f 62 6a 65 63 74 20 62 |.for an |object b|
|00004040| 65 66 6f 72 65 20 69 74 | 20 67 65 74 73 20 64 69 |efore it| gets di|
|00004050| 73 70 6f 73 65 64 2e 20 | 52 65 6a 65 63 74 69 6e |sposed. |Rejectin|
|00004060| 67 0a 66 6c 61 67 73 20 | 74 68 61 74 20 79 6f 75 |g.flags |that you|
|00004070| 20 6e 65 76 65 72 20 72 | 65 71 75 65 73 74 65 64 | never r|equested|
|00004080| 20 68 61 73 20 6e 6f 20 | 65 66 66 65 63 74 2e 0a | has no |effect..|
|00004090| 0a 43 72 69 74 69 63 61 | 6c 20 66 6c 61 67 73 20 |.Critica|l flags |
|000040a0| 73 75 63 68 20 61 73 20 | 49 44 43 4d 50 5c 5f 4d |such as |IDCMP\_M|
|000040b0| 4f 55 53 45 4d 4f 56 45 | 20 61 6e 64 20 49 44 43 |OUSEMOVE| and IDC|
|000040c0| 4d 50 5c 5f 49 4e 54 55 | 49 54 49 43 4b 53 0a 73 |MP\_INTU|ITICKS.s|
|000040d0| 68 6f 75 6c 64 20 62 65 | 20 72 65 6a 65 63 74 65 |hould be| rejecte|
|000040e0| 64 20 61 73 20 73 6f 6f | 6e 20 61 73 20 70 6f 73 |d as soo|n as pos|
|000040f0| 73 69 62 6c 65 2e 20 53 | 65 65 20 4d 55 49 5c 5f |sible. S|ee MUI\_|
|00004100| 52 65 71 75 65 73 74 49 | 44 43 4d 50 28 29 0a 66 |RequestI|DCMP().f|
|00004110| 6f 72 20 64 65 74 61 69 | 6c 73 2e 0a 0a 5c 73 75 |or detai|ls...\su|
|00004120| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 49 4e 50 |bsubsect|ion*{INP|
|00004130| 55 54 53 7d 0a 5c 62 65 | 67 69 6e 7b 64 65 73 63 |UTS}.\be|gin{desc|
|00004140| 72 69 70 74 69 6f 6e 7d | 0a 5c 69 74 65 6d 5b 6f |ription}|.\item[o|
|00004150| 62 6a 5d 20 20 20 2d 20 | 70 6f 69 6e 74 65 72 20 |bj] - |pointer |
|00004160| 74 6f 20 79 6f 75 72 73 | 65 6c 66 20 61 73 20 61 |to yours|elf as a|
|00004170| 6e 20 6f 62 6a 65 63 74 | 2e 0a 5c 69 74 65 6d 5b |n object|..\item[|
|00004180| 66 6c 61 67 73 5d 20 2d | 20 6f 6e 65 20 6f 72 20 |flags] -| one or |
|00004190| 6d 6f 72 65 20 49 44 43 | 4d 50 5c 5f 58 58 58 58 |more IDC|MP\_XXXX|
|000041a0| 20 66 6c 61 67 73 2e 0a | 5c 65 6e 64 7b 64 65 73 | flags..|\end{des|
|000041b0| 63 72 69 70 74 69 6f 6e | 7d 0a 0a 5c 73 75 62 73 |cription|}..\subs|
|000041c0| 75 62 73 65 63 74 69 6f | 6e 2a 7b 45 58 41 4d 50 |ubsectio|n*{EXAMP|
|000041d0| 4c 45 7d 0a 5c 73 6d 61 | 6c 6c 0a 5c 62 65 67 69 |LE}.\sma|ll.\begi|
|000041e0| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 4c 4f 4e 47 |n{verbat|im}.LONG|
|000041f0| 20 43 6c 65 61 6e 75 70 | 4d 65 74 68 6f 64 28 73 | Cleanup|Method(s|
|00004200| 74 72 75 63 74 20 49 43 | 6c 61 73 73 20 2a 63 6c |truct IC|lass *cl|
|00004210| 2c 20 4f 62 6a 65 63 74 | 20 2a 6f 62 6a 2c 20 4d |, Object| *obj, M|
|00004220| 73 67 20 6d 73 67 29 0a | 7b 0a 20 20 20 4d 55 49 |sg msg).|{. MUI|
|00004230| 5f 52 65 6a 65 63 74 49 | 44 43 4d 50 28 20 6f 62 |_RejectI|DCMP( ob|
|00004240| 6a 2c 20 49 44 43 4d 50 | 5f 4d 4f 55 53 45 42 55 |j, IDCMP|_MOUSEBU|
|00004250| 54 54 4f 4e 53 7c 49 44 | 43 4d 50 5f 52 41 57 4b |TTONS|ID|CMP_RAWK|
|00004260| 45 59 20 29 3b 0a 20 20 | 20 72 65 74 75 72 6e 28 |EY );. | return(|
|00004270| 44 6f 53 75 70 65 72 4d | 65 74 68 6f 64 41 28 63 |DoSuperM|ethodA(c|
|00004280| 6c 2c 6f 62 6a 2c 6d 73 | 67 29 29 3b 0a 7d 0a 0a |l,obj,ms|g));.}..|
|00004290| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 5c |\end{ver|batim}.\|
|000042a0| 6e 6f 72 6d 61 6c 73 69 | 7a 65 0a 5c 73 75 62 73 |normalsi|ze.\subs|
|000042b0| 75 62 73 65 63 74 69 6f | 6e 2a 7b 53 45 45 20 41 |ubsectio|n*{SEE A|
|000042c0| 4c 53 4f 7d 0a 4d 55 49 | 5c 5f 52 65 71 75 65 73 |LSO}.MUI|\_Reques|
|000042d0| 74 49 44 4d 43 50 28 29 | 0a 0a 0a 5c 73 75 62 73 |tIDMCP()|...\subs|
|000042e0| 65 63 74 69 6f 6e 5b 4d | 55 49 5c 5f 52 65 71 75 |ection[M|UI\_Requ|
|000042f0| 65 73 74 49 44 43 4d 50 | 5d 7b 4d 55 49 5c 5f 52 |estIDCMP|]{MUI\_R|
|00004300| 65 71 75 65 73 74 49 44 | 43 4d 50 20 2d 2d 20 52 |equestID|CMP -- R|
|00004310| 65 71 75 65 73 74 20 69 | 6e 70 75 74 20 65 76 65 |equest i|nput eve|
|00004320| 6e 74 73 20 66 6f 72 20 | 79 6f 75 72 20 63 75 73 |nts for |your cus|
|00004330| 74 6f 6d 20 63 6c 61 73 | 73 2e 7d 0a 0a 5c 73 75 |tom clas|s.}..\su|
|00004340| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 53 59 4e |bsubsect|ion*{SYN|
|00004350| 4f 50 53 49 53 7d 0a 5c | 62 65 67 69 6e 7b 74 61 |OPSIS}.\|begin{ta|
|00004360| 62 62 69 6e 67 7d 0a 4d | 55 49 5c 5f 52 65 71 75 |bbing}.M|UI\_Requ|
|00004370| 65 73 74 49 44 43 4d 50 | 28 20 5c 3d 6f 62 6a 2c |estIDCMP|( \=obj,|
|00004380| 20 5c 3d 66 6c 61 67 73 | 20 29 5c 5c 0a 5c 3e 41 | \=flags| )\\.\>A|
|00004390| 30 20 20 20 5c 3e 44 30 | 0a 5c 65 6e 64 7b 74 61 |0 \>D0|.\end{ta|
|000043a0| 62 62 69 6e 67 7d 0a 0a | 56 4f 49 44 20 4d 55 49 |bbing}..|VOID MUI|
|000043b0| 5c 5f 52 65 71 75 65 73 | 74 49 44 43 4d 50 28 20 |\_Reques|tIDCMP( |
|000043c0| 4f 62 6a 65 63 74 20 24 | 5c 61 73 74 24 6f 62 6a |Object $|\ast$obj|
|000043d0| 2c 20 55 4c 4f 4e 47 20 | 66 6c 61 67 73 20 29 3b |, ULONG |flags );|
|000043e0| 0a 0a a0 20 20 5c 73 75 | 62 73 75 62 73 65 63 74 |... \su|bsubsect|
|000043f0| 69 6f 6e 2a 7b 46 55 4e | 43 54 49 4f 4e 7d 0a 49 |ion*{FUN|CTION}.I|
|00004400| 66 20 79 6f 75 72 20 63 | 75 73 74 6f 6d 20 63 6c |f your c|ustom cl|
|00004410| 61 73 73 20 6e 65 65 64 | 73 20 74 6f 20 64 6f 20 |ass need|s to do |
|00004420| 73 6f 6d 65 20 69 6e 70 | 75 74 20 68 61 6e 64 6c |some inp|ut handl|
|00004430| 69 6e 67 2c 20 79 6f 75 | 20 6d 75 73 74 0a 65 78 |ing, you| must.ex|
|00004440| 70 6c 69 63 69 74 6c 79 | 20 72 65 71 75 65 73 74 |plicitly| request|
|00004450| 20 74 68 65 20 65 76 65 | 6e 74 73 20 79 6f 75 20 | the eve|nts you |
|00004460| 77 61 6e 74 20 74 6f 20 | 72 65 63 65 69 76 65 2e |want to |receive.|
|00004470| 20 59 6f 75 20 63 61 6e | 0a 72 65 71 75 65 73 74 | You can|.request|
|00004480| 20 28 61 6e 64 20 72 65 | 6a 65 63 74 29 20 65 76 | (and re|ject) ev|
|00004490| 65 6e 74 73 20 61 74 20 | 61 6e 79 20 74 69 6d 65 |ents at |any time|
|000044a0| 2e 0a 0a 57 68 65 6e 65 | 76 65 72 20 61 6e 20 69 |...Whene|ver an i|
|000044b0| 6e 70 75 74 20 65 76 65 | 6e 74 20 79 6f 75 20 72 |nput eve|nt you r|
|000044c0| 65 71 75 65 73 74 65 64 | 20 61 72 72 69 76 65 73 |equested| arrives|
|000044d0| 20 61 74 20 79 6f 75 72 | 20 70 61 72 65 6e 74 0a | at your| parent.|
|000044e0| 77 69 6e 64 6f 77 73 20 | 6d 65 73 73 61 67 65 20 |windows |message |
|000044f0| 70 6f 72 74 2c 20 79 6f | 75 72 20 6f 62 6a 65 63 |port, yo|ur objec|
|00004500| 74 20 77 69 6c 6c 20 72 | 65 63 65 69 76 65 20 61 |t will r|eceive a|
|00004510| 0a 4d 55 49 4d 5c 5f 48 | 61 6e 64 6c 65 49 6e 70 |.MUIM\_H|andleInp|
|00004520| 75 74 20 6d 65 74 68 6f | 64 2e 0a 0a 5c 73 75 62 |ut metho|d...\sub|
|00004530| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 4e 4f 54 45 |subsecti|on*{NOTE|
|00004540| 7d 0a 54 69 6d 65 20 63 | 6f 6e 73 75 6d 69 6e 67 |}.Time c|onsuming|
|00004550| 20 49 44 43 4d 50 20 66 | 6c 61 67 73 20 73 75 63 | IDCMP f|lags suc|
|00004560| 68 20 61 73 20 49 44 43 | 4d 50 5c 5f 49 4e 54 55 |h as IDC|MP\_INTU|
|00004570| 49 54 49 43 4b 53 20 61 | 6e 64 0a 49 44 43 4d 50 |ITICKS a|nd.IDCMP|
|00004580| 5c 5f 4d 4f 55 53 45 4d | 4f 56 45 20 73 68 6f 75 |\_MOUSEM|OVE shou|
|00004590| 6c 64 20 62 65 20 68 61 | 6e 64 6c 65 64 20 77 69 |ld be ha|ndled wi|
|000045a0| 74 68 20 63 61 72 65 2e | 20 54 6f 6f 20 6d 61 6e |th care.| Too man|
|000045b0| 79 0a 6f 62 6a 65 63 74 | 73 20 72 65 63 65 69 76 |y.object|s receiv|
|000045c0| 69 6e 67 20 74 68 65 6d | 20 77 69 6c 6c 20 64 65 |ing them| will de|
|000045d0| 67 72 61 64 65 20 70 65 | 72 66 6f 72 6d 61 6e 63 |grade pe|rformanc|
|000045e0| 65 20 57 69 74 68 0a 74 | 68 65 20 66 6f 6c 6c 6f |e With.t|he follo|
|000045f0| 77 69 6e 67 20 70 61 72 | 61 67 72 61 70 68 20 69 |wing par|agraph i|
|00004600| 6e 20 6d 69 6e 64 2c 20 | 74 68 69 73 20 69 73 6e |n mind, |this isn|
|00004610| 27 74 20 72 65 61 6c 6c | 79 0a 61 20 70 72 6f 62 |'t reall|y.a prob|
|00004620| 6c 65 6d 3a 0a 0a 59 6f | 75 20 73 68 6f 75 6c 64 |lem:..Yo|u should|
|00004630| 20 74 72 79 20 74 6f 20 | 72 65 71 75 65 73 74 20 | try to |request |
|00004640| 63 72 69 74 69 63 61 6c | 20 65 76 65 6e 74 73 20 |critical| events |
|00004650| 6f 6e 6c 79 20 77 68 65 | 6e 20 79 6f 75 0a 72 65 |only whe|n you.re|
|00004660| 61 6c 6c 79 20 6e 65 65 | 64 20 74 68 65 6d 20 61 |ally nee|d them a|
|00004670| 6e 64 20 72 65 6a 65 63 | 74 20 74 68 65 6d 20 77 |nd rejec|t them w|
|00004680| 69 74 68 20 4d 55 49 5c | 5f 52 65 6a 65 63 74 49 |ith MUI\|_RejectI|
|00004690| 44 43 4d 50 28 29 0a 61 | 73 20 73 6f 6f 6e 20 61 |DCMP().a|s soon a|
|000046a0| 73 20 70 6f 73 73 69 62 | 6c 65 2e 20 55 73 75 61 |s possib|le. Usua|
|000046b0| 6c 6c 79 2c 20 6d 6f 75 | 73 65 20 63 6f 6e 74 72 |lly, mou|se contr|
|000046c0| 6f 6c 6c 65 64 20 6f 62 | 6a 65 63 74 73 0a 6f 6e |olled ob|jects.on|
|000046d0| 6c 79 20 6e 65 65 64 20 | 4d 4f 55 53 45 4d 4f 56 |ly need |MOUSEMOV|
|000046e0| 45 53 20 61 6e 64 20 49 | 4e 54 55 49 54 49 43 4b |ES and I|NTUITICK|
|000046f0| 53 20 77 68 65 6e 20 61 | 20 62 75 74 74 6f 6e 0a |S when a| button.|
|00004700| 69 73 20 70 72 65 73 73 | 65 64 2e 20 59 6f 75 20 |is press|ed. You |
|00004710| 73 68 6f 75 6c 64 20 72 | 65 71 75 65 73 74 20 74 |should r|equest t|
|00004720| 68 65 73 65 20 66 6c 61 | 67 73 20 6f 6e 6c 79 0a |hese fla|gs only.|
|00004730| 6f 6e 20 64 65 6d 61 6e | 64 2c 20 69 2e 65 2e 20 |on deman|d, i.e. |
|00004740| 61 66 74 65 72 20 72 65 | 63 65 69 76 69 6e 67 20 |after re|ceiving |
|00004750| 61 20 6d 6f 75 73 65 20 | 64 6f 77 6e 20 65 76 65 |a mouse |down eve|
|00004760| 6e 74 0a 61 6e 64 20 72 | 65 6a 65 63 74 20 74 68 |nt.and r|eject th|
|00004770| 65 6d 20 69 6d 6d 65 64 | 69 61 74 65 6c 79 20 61 |em immed|iately a|
|00004780| 66 74 65 72 20 74 68 65 | 20 62 75 74 74 6f 6e 20 |fter the| button |
|00004790| 68 61 73 20 62 65 65 6e | 0a 72 65 6c 65 61 73 65 |has been|.release|
|000047a0| 64 2e 0a 0a 5c 73 75 62 | 73 75 62 73 65 63 74 69 |d...\sub|subsecti|
|000047b0| 6f 6e 2a 7b 49 4e 50 55 | 54 53 7d 0a 5c 62 65 67 |on*{INPU|TS}.\beg|
|000047c0| 69 6e 7b 64 65 73 63 72 | 69 70 74 69 6f 6e 7d 0a |in{descr|iption}.|
|000047d0| 5c 69 74 65 6d 5b 6f 62 | 6a 5d 20 20 20 2d 20 70 |\item[ob|j] - p|
|000047e0| 6f 69 6e 74 65 72 20 74 | 6f 20 79 6f 75 72 73 65 |ointer t|o yourse|
|000047f0| 6c 66 20 61 73 20 61 6e | 20 6f 62 6a 65 63 74 2e |lf as an| object.|
|00004800| 0a 5c 69 74 65 6d 5b 66 | 6c 61 67 73 5d 20 2d 20 |.\item[f|lags] - |
|00004810| 6f 6e 65 20 6f 72 20 6d | 6f 72 65 20 49 44 43 4d |one or m|ore IDCM|
|00004820| 50 5c 5f 58 58 58 58 20 | 66 6c 61 67 73 2e 0a 5c |P\_XXXX |flags..\|
|00004830| 65 6e 64 7b 64 65 73 63 | 72 69 70 74 69 6f 6e 7d |end{desc|ription}|
|00004840| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00004850| 2a 7b 45 58 41 4d 50 4c | 45 7d 0a 5c 73 6d 61 6c |*{EXAMPL|E}.\smal|
|00004860| 6c 0a 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |l.\begin|{verbati|
|00004870| 6d 7d 0a 4c 4f 4e 47 20 | 53 65 74 75 70 4d 65 74 |m}.LONG |SetupMet|
|00004880| 68 6f 64 28 73 74 72 75 | 63 74 20 49 43 6c 61 73 |hod(stru|ct IClas|
|00004890| 73 20 2a 63 6c 2c 20 4f | 62 6a 65 63 74 20 2a 6f |s *cl, O|bject *o|
|000048a0| 62 6a 2c 20 4d 73 67 20 | 6d 73 67 29 0a 7b 0a 20 |bj, Msg |msg).{. |
|000048b0| 20 20 69 66 20 28 21 44 | 6f 53 75 70 65 72 4d 65 | if (!D|oSuperMe|
|000048c0| 74 68 6f 64 41 28 63 6c | 2c 6f 62 6a 2c 6d 73 67 |thodA(cl|,obj,msg|
|000048d0| 29 29 0a 20 20 20 20 20 | 20 72 65 74 75 72 6e 28 |)). | return(|
|000048e0| 46 41 4c 53 45 29 3b 0a | 0a 20 20 20 2f 2a 20 64 |FALSE);.|. /* d|
|000048f0| 6f 20 73 6f 6d 65 20 73 | 65 74 75 70 20 68 65 72 |o some s|etup her|
|00004900| 65 2e 2e 2e 20 2a 2f 0a | 20 20 20 2e 2e 2e 3b 0a |e... */.| ...;.|
|00004910| 0a 20 20 20 2f 2a 20 69 | 20 6e 65 65 64 20 6d 6f |. /* i| need mo|
|00004920| 75 73 65 62 75 74 74 6f | 6e 20 65 76 65 6e 74 73 |usebutto|n events|
|00004930| 20 61 6e 64 20 6b 65 79 | 62 6f 61 72 64 20 2a 2f | and key|board */|
|00004940| 0a 20 20 20 4d 55 49 5f | 52 65 71 75 65 73 74 49 |. MUI_|RequestI|
|00004950| 44 43 4d 50 28 20 6f 62 | 6a 2c 20 49 44 43 4d 50 |DCMP( ob|j, IDCMP|
|00004960| 5f 4d 4f 55 53 45 42 55 | 54 54 4f 4e 53 7c 49 44 |_MOUSEBU|TTONS|ID|
|00004970| 43 4d 50 5f 52 41 57 4b | 45 59 20 29 3b 0a 0a 20 |CMP_RAWK|EY );.. |
|00004980| 20 20 72 65 74 75 72 6e | 28 54 52 55 45 29 3b 0a | return|(TRUE);.|
|00004990| 7d 0a 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |}..\end{|verbatim|
|000049a0| 7d 0a 5c 6e 6f 72 6d 61 | 6c 73 69 7a 65 0a 5c 73 |}.\norma|lsize.\s|
|000049b0| 75 62 73 75 62 73 65 63 | 74 69 6f 6e 2a 7b 53 45 |ubsubsec|tion*{SE|
|000049c0| 45 20 41 4c 53 4f 7d 0a | 4d 55 49 5c 5f 52 65 6a |E ALSO}.|MUI\_Rej|
|000049d0| 65 63 74 49 44 4d 43 50 | 28 29 0a 0a 0a 5c 73 75 |ectIDMCP|()...\su|
|000049e0| 62 73 65 63 74 69 6f 6e | 5b 4d 55 49 5c 5f 53 65 |bsection|[MUI\_Se|
|000049f0| 74 45 72 72 6f 72 5d 7b | 4d 55 49 5c 5f 53 65 74 |tError]{|MUI\_Set|
|00004a00| 45 72 72 6f 72 20 2d 2d | 20 53 65 74 20 61 6e 20 |Error --| Set an |
|00004a10| 65 72 72 6f 72 20 76 61 | 6c 75 65 2e 7d 0a 0a 5c |error va|lue.}..\|
|00004a20| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 53 |subsubse|ction*{S|
|00004a30| 59 4e 4f 50 53 49 53 7d | 0a 56 4f 49 44 20 4d 55 |YNOPSIS}|.VOID MU|
|00004a40| 49 5c 5f 53 65 74 45 72 | 72 6f 72 28 4c 4f 4e 47 |I\_SetEr|ror(LONG|
|00004a50| 29 3b 0a 0a a0 20 20 5c | 73 75 62 73 75 62 73 65 |);... \|subsubse|
|00004a60| 63 74 69 6f 6e 2a 7b 46 | 55 4e 43 54 49 4f 4e 7d |ction*{F|UNCTION}|
|00004a70| 0a 53 65 74 75 70 20 61 | 20 4d 55 49 20 65 72 72 |.Setup a| MUI err|
|00004a80| 6f 72 2e 20 4d 55 49 5c | 5f 45 72 72 6f 72 28 29 |or. MUI\|_Error()|
|00004a90| 20 77 69 6c 6c 20 72 65 | 74 75 72 6e 20 74 68 69 | will re|turn thi|
|00004aa0| 73 20 76 61 6c 75 65 20 | 77 68 65 6e 0a 61 73 6b |s value |when.ask|
|00004ab0| 65 64 2e 0a 0a 5c 73 75 | 62 73 75 62 73 65 63 74 |ed...\su|bsubsect|
|00004ac0| 69 6f 6e 2a 7b 53 45 45 | 20 41 4c 53 4f 7d 0a 4d |ion*{SEE| ALSO}.M|
|00004ad0| 55 49 5c 5f 45 72 72 6f | 72 28 29 0a 0a 0a |UI\_Erro|r()... |
+--------+-------------------------+-------------------------+--------+--------+
