home *** CD-ROM | disk | FTP | other *** search
| Texinfo Document | 1996-10-14 | 32.0 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: Texinfo Document
(document/texInfo).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Texinfo Document (document/texInfo)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| TeX document, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| x-fmt/111 Plain Text File
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 69 6e 70 75 74 20 61 | 6d 69 67 61 74 65 78 69 |\input a|migatexi|
|00000010| 6e 66 6f 20 40 63 20 2d | 2a 2d 74 65 78 69 6e 66 |nfo @c -|*-texinf|
|00000020| 6f 2d 2a 2d 0a 5c 69 6e | 70 75 74 20 74 65 78 69 |o-*-.\in|put texi|
|00000030| 6e 66 6f 0a 40 63 6f 6d | 6d 65 6e 74 20 25 2a 2a |nfo.@com|ment %**|
|00000040| 73 74 61 72 74 20 6f 66 | 20 68 65 61 64 65 72 0a |start of| header.|
|00000050| 40 73 65 74 66 69 6c 65 | 6e 61 6d 65 20 54 72 69 |@setfile|name Tri|
|00000060| 74 6f 6e 44 65 76 2e 69 | 6e 66 6f 0a 40 73 65 74 |tonDev.i|nfo.@set|
|00000070| 74 69 74 6c 65 20 54 72 | 69 74 6f 6e 44 65 76 0a |title Tr|itonDev.|
|00000080| 40 69 66 74 65 78 0a 40 | 61 66 6f 75 72 70 61 70 |@iftex.@|afourpap|
|00000090| 65 72 0a 40 65 6e 64 20 | 69 66 74 65 78 0a 40 66 |er.@end |iftex.@f|
|000000a0| 69 6e 61 6c 6f 75 74 0a | 40 63 6f 6d 6d 65 6e 74 |inalout.|@comment|
|000000b0| 20 25 2a 2a 65 6e 64 20 | 6f 66 20 68 65 61 64 65 | %**end |of heade|
|000000c0| 72 0a 0a 40 63 20 40 73 | 65 74 63 68 61 70 74 65 |r..@c @s|etchapte|
|000000d0| 72 6e 65 77 70 61 67 65 | 20 6f 64 64 0a 0a 40 74 |rnewpage| odd..@t|
|000000e0| 69 74 6c 65 70 61 67 65 | 0a 40 73 70 20 35 0a 40 |itlepage|.@sp 5.@|
|000000f0| 63 65 6e 74 65 72 20 40 | 74 69 74 6c 65 66 6f 6e |center @|titlefon|
|00000100| 74 7b 54 72 69 74 6f 6e | 7d 0a 40 73 70 20 34 0a |t{Triton|}.@sp 4.|
|00000110| 40 63 65 6e 74 65 72 20 | 52 65 6c 65 61 73 65 20 |@center |Release |
|00000120| 32 2e 30 20 28 70 75 62 | 6c 69 63 20 62 65 74 61 |2.0 (pub|lic beta|
|00000130| 20 31 29 0a 40 73 70 20 | 34 0a 40 63 65 6e 74 65 | 1).@sp |4.@cente|
|00000140| 72 20 40 74 69 74 6c 65 | 66 6f 6e 74 7b 44 65 76 |r @title|font{Dev|
|00000150| 65 6c 6f 70 65 72 20 44 | 6f 63 75 6d 65 6e 74 61 |eloper D|ocumenta|
|00000160| 74 69 6f 6e 7d 0a 40 73 | 70 20 34 0a 40 63 65 6e |tion}.@s|p 4.@cen|
|00000170| 74 65 72 20 40 63 6f 70 | 79 72 69 67 68 74 7b 7d |ter @cop|yright{}|
|00000180| 20 31 39 39 33 2d 31 39 | 39 36 20 62 79 20 53 74 | 1993-19|96 by St|
|00000190| 65 66 61 6e 20 5a 65 69 | 67 65 72 2e 0a 40 63 65 |efan Zei|ger..@ce|
|000001a0| 6e 74 65 72 20 41 6c 6c | 20 72 69 67 68 74 73 20 |nter All| rights |
|000001b0| 72 65 73 65 72 76 65 64 | 2e 0a 40 65 6e 64 20 74 |reserved|..@end t|
|000001c0| 69 74 6c 65 70 61 67 65 | 0a 0a 40 6e 6f 64 65 20 |itlepage|..@node |
|000001d0| 54 6f 70 2c 20 49 4e 54 | 5f 4f 56 45 2c 20 28 64 |Top, INT|_OVE, (d|
|000001e0| 69 72 29 2c 20 28 64 69 | 72 29 0a 40 69 66 69 6e |ir), (di|r).@ifin|
|000001f0| 66 6f 0a 0a 40 63 65 6e | 74 65 72 20 2a 2a 2a 2a |fo..@cen|ter ****|
|00000200| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00000210| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00000220| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 0a 0a 40 63 65 6e |********|**..@cen|
|00000230| 74 65 72 20 54 72 69 74 | 6f 6e 0a 0a 40 63 65 6e |ter Trit|on..@cen|
|00000240| 74 65 72 20 52 65 6c 65 | 61 73 65 20 32 2e 30 20 |ter Rele|ase 2.0 |
|00000250| 28 70 75 62 6c 69 63 20 | 62 65 74 61 20 31 29 0a |(public |beta 1).|
|00000260| 0a 40 63 65 6e 74 65 72 | 20 44 65 76 65 6c 6f 70 |.@center| Develop|
|00000270| 65 72 20 44 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |er Docum|entation|
|00000280| 0a 0a 40 63 65 6e 74 65 | 72 20 28 63 29 20 31 39 |..@cente|r (c) 19|
|00000290| 39 33 2d 31 39 39 36 20 | 53 74 65 66 61 6e 20 5a |93-1996 |Stefan Z|
|000002a0| 65 69 67 65 72 0a 0a 40 | 63 65 6e 74 65 72 20 2a |eiger..@|center *|
|000002b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000002c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000002d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 0a 40 |********|*****..@|
|000002e0| 65 6e 64 20 69 66 69 6e | 66 6f 0a 0a 40 6d 65 6e |end ifin|fo..@men|
|000002f0| 75 0a 0a 49 6e 74 72 6f | 64 75 63 74 69 6f 6e 0a |u..Intro|duction.|
|00000300| 0a 2a 20 4f 76 65 72 76 | 69 65 77 20 20 20 20 20 |.* Overv|iew |
|00000310| 20 20 20 3a 49 4e 54 5f | 4f 56 45 2e 20 20 20 20 | :INT_|OVE. |
|00000320| 20 20 20 50 72 6f 67 72 | 61 6d 6d 69 6e 67 20 77 | Progr|amming w|
|00000330| 69 74 68 20 54 72 69 74 | 6f 6e 0a 2a 20 4f 4f 50 |ith Trit|on.* OOP|
|00000340| 20 49 6e 74 65 72 6e 61 | 6c 73 20 20 20 3a 49 4e | Interna|ls :IN|
|00000350| 54 5f 4f 4f 50 2e 20 20 | 20 20 20 20 20 54 68 65 |T_OOP. | The|
|00000360| 20 69 6e 74 65 72 6e 61 | 6c 20 77 6f 72 6b 69 6e | interna|l workin|
|00000370| 67 20 6f 66 20 54 72 69 | 74 6f 6e 0a 2a 20 43 6c |g of Tri|ton.* Cl|
|00000380| 61 73 73 20 54 72 65 65 | 20 20 20 20 20 20 3a 49 |ass Tree| :I|
|00000390| 4e 54 5f 43 4c 41 2e 20 | 20 20 20 20 20 20 41 76 |NT_CLA. | Av|
|000003a0| 61 69 6c 61 62 6c 65 20 | 63 6c 61 73 73 65 73 0a |ailable |classes.|
|000003b0| 2a 20 41 75 74 6f 64 6f | 63 73 20 20 20 20 20 20 |* Autodo|cs |
|000003c0| 20 20 3a 49 4e 54 5f 41 | 55 54 2e 20 20 20 20 20 | :INT_A|UT. |
|000003d0| 20 20 4e 6f 74 65 73 20 | 6f 6e 20 74 68 65 20 61 | Notes |on the a|
|000003e0| 75 74 6f 64 6f 63 73 0a | 0a 57 72 69 74 69 6e 67 |utodocs.|.Writing|
|000003f0| 20 41 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 2d 20 | Applica|tions - |
|00000400| 53 74 65 70 20 62 79 20 | 53 74 65 70 20 54 75 74 |Step by |Step Tut|
|00000410| 6f 72 69 61 6c 0a 0a 2a | 20 41 70 70 6c 69 63 61 |orial..*| Applica|
|00000420| 74 69 6f 6e 73 20 20 20 | 20 3a 54 55 54 5f 41 50 |tions | :TUT_AP|
|00000430| 50 2e 20 20 20 20 20 20 | 20 54 68 65 20 6b 65 79 |P. | The key|
|00000440| 20 74 6f 20 54 72 69 74 | 6f 6e 0a 2a 20 50 72 6f | to Trit|on.* Pro|
|00000450| 6a 65 63 74 73 20 20 20 | 20 20 20 20 20 3a 54 55 |jects | :TU|
|00000460| 54 5f 50 52 4f 2e 20 20 | 20 20 20 20 20 54 72 69 |T_PRO. | Tri|
|00000470| 74 6f 6e 20 47 55 49 20 | 77 69 6e 64 6f 77 73 0a |ton GUI |windows.|
|00000480| 2a 20 4d 65 6e 75 73 20 | 20 20 20 20 20 20 20 20 |* Menus | |
|00000490| 20 20 3a 54 55 54 5f 4d | 45 4e 2e 20 20 20 20 20 | :TUT_M|EN. |
|000004a0| 20 20 4d 65 6e 75 73 0a | 2a 20 4f 62 6a 65 63 74 | Menus.|* Object|
|000004b0| 73 20 20 20 20 20 20 20 | 20 20 3a 54 55 54 5f 4f |s | :TUT_O|
|000004c0| 42 4a 2e 20 20 20 20 20 | 20 20 54 72 69 74 6f 6e |BJ. | Triton|
|000004d0| 20 6f 62 6a 65 63 74 73 | 0a 2a 20 4c 61 79 6f 75 | objects|.* Layou|
|000004e0| 74 20 20 20 20 20 20 20 | 20 20 20 3a 54 55 54 5f |t | :TUT_|
|000004f0| 4c 41 59 2e 20 20 20 20 | 20 20 20 54 68 65 20 6c |LAY. | The l|
|00000500| 61 79 6f 75 74 20 65 6e | 67 69 6e 65 0a 2a 20 4d |ayout en|gine.* M|
|00000510| 61 63 72 6f 73 20 20 20 | 20 20 20 20 20 20 20 3a |acros | :|
|00000520| 54 55 54 5f 4d 41 43 2e | 20 20 20 20 20 20 20 55 |TUT_MAC.| U|
|00000530| 73 69 6e 67 20 74 68 65 | 20 54 72 69 74 6f 6e 20 |sing the| Triton |
|00000540| 47 55 49 20 6d 61 63 72 | 6f 73 0a 2a 20 50 6f 6c |GUI macr|os.* Pol|
|00000550| 6c 69 6e 67 20 4c 6f 6f | 70 20 20 20 20 3a 54 55 |ling Loo|p :TU|
|00000560| 54 5f 50 4f 4c 2e 20 20 | 20 20 20 20 20 48 61 6e |T_POL. | Han|
|00000570| 64 6c 69 6e 67 20 47 55 | 49 20 65 76 65 6e 74 73 |dling GU|I events|
|00000580| 0a 2a 20 4d 65 73 73 61 | 67 65 73 20 20 20 20 20 |.* Messa|ges |
|00000590| 20 20 20 3a 54 55 54 5f | 4d 45 53 2e 20 20 20 20 | :TUT_|MES. |
|000005a0| 20 20 20 53 65 6e 64 69 | 6e 67 20 6d 65 73 73 61 | Sendi|ng messa|
|000005b0| 67 65 73 0a 2a 20 48 65 | 6c 70 20 20 20 20 20 20 |ges.* He|lp |
|000005c0| 20 20 20 20 20 20 3a 54 | 55 54 5f 48 45 4c 2e 20 | :T|UT_HEL. |
|000005d0| 20 20 20 20 20 20 50 72 | 6f 76 69 64 69 6e 67 20 | Pr|oviding |
|000005e0| 68 65 6c 70 0a 2a 20 52 | 65 71 75 65 73 74 65 72 |help.* R|equester|
|000005f0| 73 20 20 20 20 20 20 3a | 54 55 54 5f 52 45 51 2e |s :|TUT_REQ.|
|00000600| 20 20 20 20 20 20 20 54 | 72 69 74 6f 6e 20 72 65 | T|riton re|
|00000610| 71 75 65 73 74 65 72 73 | 0a 0a 43 6c 61 73 73 20 |questers|..Class |
|00000620| 41 75 74 68 6f 72 69 6e | 67 20 54 75 74 6f 72 69 |Authorin|g Tutori|
|00000630| 61 6c 20 28 4e 6f 74 20 | 69 6e 63 6c 75 64 65 64 |al (Not |included|
|00000640| 20 69 6e 20 74 68 69 73 | 20 72 65 6c 65 61 73 65 | in this| release|
|00000650| 29 0a 0a 53 74 79 6c 65 | 20 47 75 69 64 65 0a 0a |)..Style| Guide..|
|00000660| 2a 20 47 75 69 64 65 6c | 69 6e 65 73 20 20 20 20 |* Guidel|ines |
|00000670| 20 20 3a 53 54 59 5f 4f | 56 45 2e 20 20 20 20 20 | :STY_O|VE. |
|00000680| 20 20 47 75 69 64 65 6c | 69 6e 65 73 20 66 6f 72 | Guidel|ines for|
|00000690| 20 54 72 69 74 6f 6e 20 | 47 55 49 73 0a 0a 4f 64 | Triton |GUIs..Od|
|000006a0| 64 73 20 26 20 45 6e 64 | 73 0a 0a 2a 20 4d 61 69 |ds & End|s..* Mai|
|000006b0| 6c 69 6e 67 20 6c 69 73 | 74 20 20 20 20 3a 4f 44 |ling lis|t :OD|
|000006c0| 44 5f 4d 41 49 2e 20 20 | 20 20 20 20 20 41 62 6f |D_MAI. | Abo|
|000006d0| 75 74 20 74 68 65 20 54 | 72 69 74 6f 6e 20 6d 61 |ut the T|riton ma|
|000006e0| 69 6c 69 6e 67 20 6c 69 | 73 74 0a 2a 20 46 41 51 |iling li|st.* FAQ|
|000006f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 3a 4f 44 | | :OD|
|00000700| 44 5f 46 41 51 2e 20 20 | 20 20 20 20 20 46 72 65 |D_FAQ. | Fre|
|00000710| 71 75 65 6e 74 6c 79 20 | 41 73 6b 65 64 20 51 75 |quently |Asked Qu|
|00000720| 65 73 74 69 6f 6e 73 0a | 0a 2a 20 49 6e 64 65 78 |estions.|.* Index|
|00000730| 20 20 20 20 20 20 20 20 | 20 20 20 3a 49 6e 64 65 | | :Inde|
|00000740| 78 2e 0a 0a 40 65 6e 64 | 20 6d 65 6e 75 0a 0a 40 |x...@end| menu..@|
|00000750| 65 78 61 6d 70 6c 65 0a | 40 2a 0a 40 65 6e 64 20 |example.|@*.@end |
|00000760| 65 78 61 6d 70 6c 65 0a | 0a 40 69 66 69 6e 66 6f |example.|.@ifinfo|
|00000770| 0a 4e 6f 74 65 20 74 68 | 61 74 20 61 6c 6c 20 70 |.Note th|at all p|
|00000780| 61 67 65 73 20 63 61 6e | 20 62 65 20 72 65 61 63 |ages can| be reac|
|00000790| 68 65 64 20 64 69 72 65 | 63 74 6c 79 20 66 72 6f |hed dire|ctly fro|
|000007a0| 6d 20 74 68 69 73 20 6d | 65 6e 75 2c 0a 73 6f 20 |m this m|enu,.so |
|000007b0| 74 68 61 74 20 79 6f 75 | 20 6d 61 79 20 63 6f 6e |that you| may con|
|000007c0| 76 65 6e 69 65 6e 74 6c | 79 20 62 72 6f 77 73 65 |venientl|y browse|
|000007d0| 20 74 68 72 6f 75 67 68 | 20 61 6c 6c 20 69 74 65 | through| all ite|
|000007e0| 6d 73 20 69 6e 20 74 68 | 69 73 0a 6d 61 69 6e 20 |ms in th|is.main |
|000007f0| 6d 65 6e 75 20 69 6e 20 | 6f 72 64 65 72 20 74 6f |menu in |order to|
|00000800| 20 72 65 61 64 20 74 68 | 65 20 65 6e 74 69 72 65 | read th|e entire|
|00000810| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 2e 0a | documen|tation..|
|00000820| 40 65 6e 64 20 69 66 69 | 6e 66 6f 0a 0a 40 6e 6f |@end ifi|nfo..@no|
|00000830| 64 65 20 49 4e 54 5f 4f | 56 45 2c 20 49 4e 54 5f |de INT_O|VE, INT_|
|00000840| 4f 4f 50 2c 20 54 6f 70 | 2c 20 54 6f 70 0a 40 63 |OOP, Top|, Top.@c|
|00000850| 68 61 70 74 65 72 20 49 | 6e 74 72 6f 64 75 63 74 |hapter I|ntroduct|
|00000860| 69 6f 6e 0a 40 63 69 6e | 64 65 78 20 49 6e 74 72 |ion.@cin|dex Intr|
|00000870| 6f 64 75 63 74 69 6f 6e | 0a 40 73 65 63 74 69 6f |oduction|.@sectio|
|00000880| 6e 20 4f 76 65 72 76 69 | 65 77 0a 40 63 69 6e 64 |n Overvi|ew.@cind|
|00000890| 65 78 20 4f 76 65 72 76 | 69 65 77 0a 0a 54 68 65 |ex Overv|iew..The|
|000008a0| 20 54 72 69 74 6f 6e 20 | 47 55 49 20 63 72 65 61 | Triton |GUI crea|
|000008b0| 74 69 6f 6e 20 73 79 73 | 74 65 6d 20 6f 66 66 65 |tion sys|tem offe|
|000008c0| 72 73 20 61 6e 20 65 61 | 73 79 20 77 61 79 20 74 |rs an ea|sy way t|
|000008d0| 6f 20 63 72 65 61 74 65 | 20 67 6f 6f 64 20 6c 6f |o create| good lo|
|000008e0| 6f 6b 69 6e 67 0a 47 55 | 49 73 20 66 6f 72 20 79 |oking.GU|Is for y|
|000008f0| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |our appl|ications|
|00000900| 2e 20 49 74 20 63 61 6e | 20 62 65 20 75 73 65 64 |. It can| be used|
|00000910| 20 77 69 74 68 20 61 20 | 76 61 72 69 65 74 79 20 | with a |variety |
|00000920| 6f 66 0a 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 6c |of.progr|amming l|
|00000930| 61 6e 67 75 61 67 65 73 | 2e 20 53 75 70 70 6f 72 |anguages|. Suppor|
|00000940| 74 20 66 6f 72 20 53 41 | 53 2f 43 20 69 73 20 69 |t for SA|S/C is i|
|00000950| 6e 63 6c 75 64 65 64 20 | 64 69 72 65 63 74 6c 79 |ncluded |directly|
|00000960| 20 69 6e 20 74 68 69 73 | 0a 70 61 63 6b 61 67 65 | in this|.package|
|00000970| 2e 20 43 68 65 63 6b 20 | 6f 75 74 20 74 68 65 20 |. Check |out the |
|00000980| 41 6d 69 4e 65 74 20 64 | 69 72 65 63 74 6f 72 79 |AmiNet d|irectory|
|00000990| 20 40 66 69 6c 65 7b 64 | 65 76 2f 67 75 69 7d 20 | @file{d|ev/gui} |
|000009a0| 6f 72 20 74 68 65 20 54 | 72 69 74 6f 6e 0a 48 6f |or the T|riton.Ho|
|000009b0| 6d 65 20 50 61 67 65 20 | 61 74 20 40 63 6f 64 65 |me Page |at @code|
|000009c0| 7b 68 74 74 70 3a 2f 2f | 68 6f 6d 65 2e 70 61 67 |{http://|home.pag|
|000009d0| 65 73 2e 64 65 2f 7e 73 | 7a 65 69 67 65 72 2f 74 |es.de/~s|zeiger/t|
|000009e0| 72 69 74 6f 6e 2e 68 74 | 6d 6c 7d 20 66 6f 72 0a |riton.ht|ml} for.|
|000009f0| 73 75 70 70 6f 72 74 20 | 66 69 6c 65 73 20 66 6f |support |files fo|
|00000a00| 72 20 6f 74 68 65 72 20 | 6c 61 6e 67 75 61 67 65 |r other |language|
|00000a10| 73 20 61 6e 64 20 64 65 | 76 65 6c 6f 70 6d 65 6e |s and de|velopmen|
|00000a20| 74 20 73 79 73 74 65 6d | 73 2e 0a 0a 49 66 20 79 |t system|s...If y|
|00000a30| 6f 75 20 68 61 76 65 20 | 72 65 6c 65 61 73 65 64 |ou have |released|
|00000a40| 20 61 20 54 72 69 74 6f | 6e 20 73 75 70 70 6f 72 | a Trito|n suppor|
|00000a50| 74 20 70 61 63 6b 61 67 | 65 20 66 6f 72 20 61 20 |t packag|e for a |
|00000a60| 6e 65 77 20 6c 61 6e 67 | 75 61 67 65 20 6f 72 0a |new lang|uage or.|
|00000a70| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 73 79 73 74 |developm|ent syst|
|00000a80| 65 6d 2c 20 70 6c 65 61 | 73 65 20 63 6f 6e 74 61 |em, plea|se conta|
|00000a90| 63 74 20 6d 65 20 66 6f | 72 20 69 6e 63 6c 75 73 |ct me fo|r inclus|
|00000aa0| 69 6f 6e 20 69 6e 74 6f | 20 74 68 65 20 6c 69 73 |ion into| the lis|
|00000ab0| 74 20 6f 6e 20 74 68 65 | 0a 54 72 69 74 6f 6e 20 |t on the|.Triton |
|00000ac0| 68 6f 6d 65 20 70 61 67 | 65 2e 0a 0a 54 68 69 73 |home pag|e...This|
|00000ad0| 20 64 6f 63 75 6d 65 6e | 74 20 64 65 73 63 72 69 | documen|t descri|
|00000ae0| 62 65 73 20 68 6f 77 20 | 74 6f 20 75 73 65 20 54 |bes how |to use T|
|00000af0| 72 69 74 6f 6e 20 69 6e | 20 79 6f 75 72 20 6f 77 |riton in| your ow|
|00000b00| 6e 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 73 0a 62 |n applic|ations.b|
|00000b10| 79 20 70 72 6f 76 69 64 | 69 6e 67 20 79 6f 75 20 |y provid|ing you |
|00000b20| 77 69 74 68 20 73 6f 6d | 65 20 6f 76 65 72 76 69 |with som|e overvi|
|00000b30| 65 77 20 74 6f 70 69 63 | 73 20 61 6e 64 20 61 20 |ew topic|s and a |
|00000b40| 73 74 65 70 20 62 79 20 | 73 74 65 70 0a 69 6e 74 |step by |step.int|
|00000b50| 72 6f 64 75 63 74 69 6f | 6e 2e 20 49 74 20 64 6f |roductio|n. It do|
|00000b60| 65 73 20 40 73 74 72 6f | 6e 67 7b 6e 6f 74 7d 20 |es @stro|ng{not} |
|00000b70| 64 65 73 63 72 69 62 65 | 20 69 6e 20 64 65 74 61 |describe| in deta|
|00000b80| 69 6c 20 74 68 65 20 66 | 75 6e 63 74 69 6f 6e 73 |il the f|unctions|
|00000b90| 2c 0a 73 74 72 75 63 74 | 75 72 65 73 2c 20 74 61 |,.struct|ures, ta|
|00000ba0| 67 73 2c 20 65 74 63 40 | 2e 20 77 68 69 63 68 20 |gs, etc@|. which |
|00000bb0| 61 72 65 20 75 73 65 64 | 2c 20 73 6f 20 79 6f 75 |are used|, so you|
|00000bc0| 20 73 68 6f 75 6c 64 20 | 61 6c 77 61 79 73 20 6c | should |always l|
|00000bd0| 6f 6f 6b 0a 74 68 65 6d | 20 75 70 20 69 6e 20 74 |ook.them| up in t|
|00000be0| 68 65 20 61 75 74 6f 64 | 6f 63 73 20 66 69 6c 65 |he autod|ocs file|
|00000bf0| 20 28 73 65 65 20 40 72 | 65 66 7b 49 4e 54 5f 41 | (see @r|ef{INT_A|
|00000c00| 55 54 2c 20 41 75 74 6f | 64 6f 63 73 2c 20 49 6e |UT, Auto|docs, In|
|00000c10| 74 72 6f 64 75 63 74 69 | 6f 6e 20 2d 20 41 75 74 |troducti|on - Aut|
|00000c20| 6f 64 6f 63 73 7d 29 0a | 61 6e 64 20 74 68 65 20 |odocs}).|and the |
|00000c30| 43 20 68 65 61 64 65 72 | 20 66 69 6c 65 20 40 66 |C header| file @f|
|00000c40| 69 6c 65 7b 44 65 76 65 | 6c 6f 70 65 72 2f 49 6e |ile{Deve|loper/In|
|00000c50| 63 6c 75 64 65 2f 6c 69 | 62 72 61 72 69 65 73 2f |clude/li|braries/|
|00000c60| 74 72 69 74 6f 6e 2e 68 | 7d 2e 0a 0a 54 68 65 20 |triton.h|}...The |
|00000c70| 65 78 61 6d 70 6c 65 73 | 20 69 6e 20 74 68 69 73 |examples| in this|
|00000c80| 20 64 6f 63 75 6d 65 6e | 74 20 61 73 73 75 6d 65 | documen|t assume|
|00000c90| 20 74 68 61 74 20 79 6f | 75 27 72 65 20 75 73 69 | that yo|u're usi|
|00000ca0| 6e 67 20 74 68 65 20 43 | 20 73 75 70 70 6f 72 74 |ng the C| support|
|00000cb0| 0a 66 69 6c 65 73 20 77 | 69 74 68 20 74 68 65 20 |.files w|ith the |
|00000cc0| 53 41 53 2f 43 20 63 6f | 6d 70 69 6c 65 72 2e 20 |SAS/C co|mpiler. |
|00000cd0| 54 68 65 72 65 20 6d 61 | 79 20 62 65 20 64 69 66 |There ma|y be dif|
|00000ce0| 66 65 72 65 6e 63 65 73 | 20 69 6e 20 6f 74 68 65 |ferences| in othe|
|00000cf0| 72 0a 6c 61 6e 67 75 61 | 67 65 73 20 6f 72 20 65 |r.langua|ges or e|
|00000d00| 76 65 6e 20 77 69 74 68 | 20 6f 74 68 65 72 20 43 |ven with| other C|
|00000d10| 20 64 65 76 65 6c 6f 70 | 6d 65 6e 74 20 73 79 73 | develop|ment sys|
|00000d20| 74 65 6d 73 2e 0a 0a 40 | 6e 6f 64 65 20 49 4e 54 |tems...@|node INT|
|00000d30| 5f 4f 4f 50 2c 20 49 4e | 54 5f 43 4c 41 2c 20 49 |_OOP, IN|T_CLA, I|
|00000d40| 4e 54 5f 4f 56 45 2c 20 | 54 6f 70 0a 40 73 65 63 |NT_OVE, |Top.@sec|
|00000d50| 74 69 6f 6e 20 4f 4f 50 | 20 49 6e 74 65 72 6e 61 |tion OOP| Interna|
|00000d60| 6c 73 0a 40 63 69 6e 64 | 65 78 20 4f 4f 50 20 49 |ls.@cind|ex OOP I|
|00000d70| 6e 74 65 72 6e 61 6c 73 | 0a 0a 41 6c 74 68 6f 75 |nternals|..Althou|
|00000d80| 67 68 20 54 72 69 74 6f | 6e 20 6f 66 66 65 72 73 |gh Trito|n offers|
|00000d90| 20 61 20 6d 6f 73 74 6c | 79 20 70 72 6f 63 65 64 | a mostl|y proced|
|00000da0| 75 72 61 6c 20 41 50 49 | 2c 20 69 74 20 69 73 20 |ural API|, it is |
|00000db0| 62 61 73 65 64 20 6f 6e | 20 61 6e 0a 6f 62 6a 65 |based on| an.obje|
|00000dc0| 63 74 2d 6f 72 69 65 6e | 74 65 64 20 73 79 73 74 |ct-orien|ted syst|
|00000dd0| 65 6d 2e 20 41 73 20 61 | 20 54 72 69 74 6f 6e 20 |em. As a| Triton |
|00000de0| 75 73 65 72 20 79 6f 75 | 20 77 69 6c 6c 20 6e 65 |user you| will ne|
|00000df0| 76 65 72 20 73 65 65 20 | 54 72 69 74 6f 6e 0a 6f |ver see |Triton.o|
|00000e00| 62 6a 65 63 74 73 20 64 | 69 72 65 63 74 6c 79 2c |bjects d|irectly,|
|00000e10| 20 62 75 74 20 69 6e 73 | 74 65 61 64 20 72 65 66 | but ins|tead ref|
|00000e20| 65 72 65 6e 63 65 20 74 | 68 65 6d 20 74 68 72 6f |erence t|hem thro|
|00000e30| 75 67 68 20 49 44 20 6e | 75 6d 62 65 72 73 2e 0a |ugh ID n|umbers..|
|00000e40| 0a 40 6e 6f 64 65 20 49 | 4e 54 5f 43 4c 41 2c 20 |.@node I|NT_CLA, |
|00000e50| 49 4e 54 5f 41 55 54 2c | 20 49 4e 54 5f 4f 4f 50 |INT_AUT,| INT_OOP|
|00000e60| 2c 20 54 6f 70 0a 40 73 | 65 63 74 69 6f 6e 20 43 |, Top.@s|ection C|
|00000e70| 6c 61 73 73 20 54 72 65 | 65 0a 40 63 69 6e 64 65 |lass Tre|e.@cinde|
|00000e80| 78 20 43 6c 61 73 73 20 | 54 72 65 65 0a 0a 54 68 |x Class |Tree..Th|
|00000e90| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 63 6c 61 73 |e follow|ing clas|
|00000ea0| 73 65 73 20 61 72 65 20 | 61 76 61 69 6c 61 62 6c |ses are |availabl|
|00000eb0| 65 20 69 6e 20 54 72 69 | 74 6f 6e 3a 0a 0a 40 65 |e in Tri|ton:..@e|
|00000ec0| 78 61 6d 70 6c 65 0a 20 | 20 20 20 4f 62 6a 65 63 |xample. | Objec|
|00000ed0| 74 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |t | |
|00000ee0| 20 20 20 41 62 73 74 72 | 61 63 74 20 72 6f 6f 74 | Abstr|act root|
|00000ef0| 20 63 6c 61 73 73 0a 20 | 20 20 20 60 2d 2d 20 44 | class. | `-- D|
|00000f00| 69 73 70 6c 61 79 4f 62 | 6a 65 63 74 20 20 20 20 |isplayOb|ject |
|00000f10| 20 20 20 41 62 73 74 72 | 61 63 74 20 63 6c 61 73 | Abstr|act clas|
|00000f20| 73 20 66 6f 72 20 77 69 | 6e 64 6f 77 20 63 6f 6e |s for wi|ndow con|
|00000f30| 74 65 6e 74 73 0a 20 20 | 20 20 20 20 20 20 2b 2d |tents. | +-|
|00000f40| 2d 20 42 75 74 74 6f 6e | 20 20 20 20 20 20 20 20 |- Button| |
|00000f50| 20 20 42 4f 4f 50 53 49 | 20 62 75 74 74 6f 6e 20 | BOOPSI| button |
|00000f60| 67 61 64 67 65 74 0a 20 | 20 20 20 20 20 20 20 2b |gadget. | +|
|00000f70| 2d 2d 20 43 68 65 63 6b | 42 6f 78 20 20 20 20 20 |-- Check|Box |
|00000f80| 20 20 20 47 61 64 54 6f | 6f 6c 73 20 43 68 65 63 | GadTo|ols Chec|
|00000f90| 6b 42 6f 78 0a 20 20 20 | 20 20 20 20 20 2b 2d 2d |kBox. | +--|
|00000fa0| 20 43 79 63 6c 65 20 20 | 20 20 20 20 20 20 20 20 | Cycle | |
|00000fb0| 20 47 61 64 54 6f 6f 6c | 73 20 43 79 63 6c 65 20 | GadTool|s Cycle |
|00000fc0| 61 6e 64 20 4d 58 20 67 | 61 64 67 65 74 0a 20 20 |and MX g|adget. |
|00000fd0| 20 20 20 20 20 20 2b 2d | 2d 20 44 72 6f 70 42 6f | +-|- DropBo|
|00000fe0| 78 20 20 20 20 20 20 20 | 20 20 41 70 70 49 63 6f |x | AppIco|
|00000ff0| 6e 20 64 72 6f 70 70 69 | 6e 67 20 62 6f 78 0a 20 |n droppi|ng box. |
|00001000| 20 20 20 20 20 20 20 2b | 2d 2d 20 46 72 61 6d 65 | +|-- Frame|
|00001010| 42 6f 78 20 20 20 20 20 | 20 20 20 46 72 61 6d 69 |Box | Frami|
|00001020| 6e 67 20 6f 72 20 67 72 | 6f 75 70 69 6e 67 20 62 |ng or gr|ouping b|
|00001030| 6f 78 0a 20 20 20 20 20 | 20 20 20 2b 2d 2d 20 47 |ox. | +-- G|
|00001040| 72 6f 75 70 20 20 20 20 | 20 20 20 20 20 20 20 54 |roup | T|
|00001050| 72 69 74 6f 6e 27 73 20 | 6c 61 79 6f 75 74 20 65 |riton's |layout e|
|00001060| 6e 67 69 6e 65 0a 20 20 | 20 20 20 20 20 20 2b 2d |ngine. | +-|
|00001070| 2d 20 49 6d 61 67 65 20 | 20 20 20 20 20 20 20 20 |- Image | |
|00001080| 20 20 49 6d 61 67 65 0a | 20 20 20 20 20 20 20 20 | Image.| |
|00001090| 2b 2d 2d 20 4c 69 6e 65 | 20 20 20 20 20 20 20 20 |+-- Line| |
|000010a0| 20 20 20 20 33 44 20 6c | 69 6e 65 0a 20 20 20 20 | 3D l|ine. |
|000010b0| 20 20 20 20 2b 2d 2d 20 | 4c 69 73 74 76 69 65 77 | +-- |Listview|
|000010c0| 20 20 20 20 20 20 20 20 | 47 61 64 54 6f 6f 6c 73 | |GadTools|
|000010d0| 20 4c 69 73 74 76 69 65 | 77 0a 20 20 20 20 20 20 | Listvie|w. |
|000010e0| 20 20 2b 2d 2d 20 50 61 | 6c 65 74 74 65 20 20 20 | +-- Pa|lette |
|000010f0| 20 20 20 20 20 20 47 61 | 64 54 6f 6f 6c 73 20 50 | Ga|dTools P|
|00001100| 61 6c 65 74 74 65 20 67 | 61 64 67 65 74 0a 20 20 |alette g|adget. |
|00001110| 20 20 20 20 20 20 2b 2d | 2d 20 50 72 6f 67 72 65 | +-|- Progre|
|00001120| 73 73 20 20 20 20 20 20 | 20 20 50 72 6f 67 72 65 |ss | Progre|
|00001130| 73 73 20 69 6e 64 69 63 | 61 74 6f 72 0a 20 20 20 |ss indic|ator. |
|00001140| 20 20 20 20 20 2b 2d 2d | 20 53 63 72 6f 6c 6c 65 | +--| Scrolle|
|00001150| 72 20 20 20 20 20 20 20 | 20 47 61 64 54 6f 6f 6c |r | GadTool|
|00001160| 73 20 53 63 72 6f 6c 6c | 65 72 0a 20 20 20 20 20 |s Scroll|er. |
|00001170| 20 20 20 2b 2d 2d 20 53 | 6c 69 64 65 72 20 20 20 | +-- S|lider |
|00001180| 20 20 20 20 20 20 20 47 | 61 64 54 6f 6f 6c 73 20 | G|adTools |
|00001190| 53 6c 69 64 65 72 0a 20 | 20 20 20 20 20 20 20 2b |Slider. | +|
|000011a0| 2d 2d 20 53 70 61 63 65 | 20 20 20 20 20 20 20 20 |-- Space| |
|000011b0| 20 20 20 45 6d 70 74 79 | 20 73 70 61 63 65 0a 20 | Empty| space. |
|000011c0| 20 20 20 20 20 20 20 2b | 2d 2d 20 53 74 72 69 6e | +|-- Strin|
|000011d0| 67 20 20 20 20 20 20 20 | 20 20 20 47 61 64 54 6f |g | GadTo|
|000011e0| 6f 6c 73 20 53 74 72 69 | 6e 67 20 67 61 64 67 65 |ols Stri|ng gadge|
|000011f0| 74 0a 20 20 20 20 20 20 | 20 20 60 2d 2d 20 54 65 |t. | `-- Te|
|00001200| 78 74 20 20 20 20 20 20 | 20 20 20 20 20 20 54 65 |xt | Te|
|00001210| 78 74 0a 40 65 6e 64 20 | 65 78 61 6d 70 6c 65 0a |xt.@end |example.|
|00001220| 0a 44 65 73 63 72 69 70 | 74 69 6f 6e 73 20 66 6f |.Descrip|tions fo|
|00001230| 72 20 61 6c 6c 20 63 6c | 61 73 73 65 73 20 63 61 |r all cl|asses ca|
|00001240| 6e 20 62 65 20 66 6f 75 | 6e 64 20 69 6e 20 74 68 |n be fou|nd in th|
|00001250| 65 20 54 72 69 74 6f 6e | 20 61 75 74 6f 64 6f 63 |e Triton| autodoc|
|00001260| 73 0a 28 73 65 65 20 40 | 72 65 66 7b 49 4e 54 5f |s.(see @|ref{INT_|
|00001270| 41 55 54 2c 20 41 75 74 | 6f 64 6f 63 73 2c 20 49 |AUT, Aut|odocs, I|
|00001280| 6e 74 72 6f 64 75 63 74 | 69 6f 6e 20 2d 20 41 75 |ntroduct|ion - Au|
|00001290| 74 6f 64 6f 63 73 7d 29 | 0a 75 6e 64 65 72 20 40 |todocs})|.under @|
|000012a0| 63 6f 64 65 7b 74 72 69 | 74 6f 6e 2e 6c 69 62 72 |code{tri|ton.libr|
|000012b0| 61 72 79 2f 63 6c 61 73 | 73 5f 3c 63 6c 61 73 73 |ary/clas|s_<class|
|000012c0| 6e 61 6d 65 3e 7d 2e 0a | 0a 40 6e 6f 64 65 20 49 |name>}..|.@node I|
|000012d0| 4e 54 5f 41 55 54 2c 20 | 54 55 54 5f 41 50 50 2c |NT_AUT, |TUT_APP,|
|000012e0| 20 49 4e 54 5f 43 4c 41 | 2c 20 54 6f 70 0a 40 73 | INT_CLA|, Top.@s|
|000012f0| 65 63 74 69 6f 6e 20 41 | 75 74 6f 64 6f 63 73 0a |ection A|utodocs.|
|00001300| 40 63 69 6e 64 65 78 20 | 41 75 74 6f 64 6f 63 73 |@cindex |Autodocs|
|00001310| 0a 0a 44 6f 63 75 6d 65 | 6e 74 61 74 69 6f 6e 20 |..Docume|ntation |
|00001320| 6f 6e 20 61 6c 6c 20 54 | 72 69 74 6f 6e 20 63 6c |on all T|riton cl|
|00001330| 61 73 73 65 73 20 61 6e | 64 20 40 66 69 6c 65 7b |asses an|d @file{|
|00001340| 74 72 69 74 6f 6e 2e 6c | 69 62 72 61 72 79 7d 20 |triton.l|ibrary} |
|00001350| 66 75 6e 63 74 69 6f 6e | 73 20 63 61 6e 20 62 65 |function|s can be|
|00001360| 0a 66 6f 75 6e 64 20 69 | 6e 20 74 68 65 20 54 72 |.found i|n the Tr|
|00001370| 69 74 6f 6e 20 61 75 74 | 6f 64 6f 63 73 20 66 69 |iton aut|odocs fi|
|00001380| 6c 65 20 40 66 69 6c 65 | 7b 44 65 76 65 6c 6f 70 |le @file|{Develop|
|00001390| 65 72 2f 41 75 74 6f 64 | 6f 63 73 2f 74 72 69 74 |er/Autod|ocs/trit|
|000013a0| 6f 6e 2e 64 6f 63 7d 2e | 20 54 68 65 0a 66 75 6e |on.doc}.| The.fun|
|000013b0| 63 74 69 6f 6e 20 64 65 | 73 63 72 69 70 74 69 6f |ction de|scriptio|
|000013c0| 6e 73 20 66 6f 6c 6c 6f | 77 20 74 68 65 20 75 73 |ns follo|w the us|
|000013d0| 75 61 6c 20 73 79 6e 74 | 61 78 20 61 73 20 75 73 |ual synt|ax as us|
|000013e0| 65 64 20 69 6e 20 74 68 | 65 20 41 6d 69 67 61 4f |ed in th|e AmigaO|
|000013f0| 53 20 61 75 74 6f 64 6f | 63 73 2e 0a 54 68 65 20 |S autodo|cs..The |
|00001400| 54 72 69 74 6f 6e 20 63 | 6c 61 73 73 65 73 20 61 |Triton c|lasses a|
|00001410| 72 65 20 6c 69 73 74 65 | 64 20 77 69 74 68 20 74 |re liste|d with t|
|00001420| 68 65 20 70 72 65 66 69 | 78 20 40 63 6f 64 65 7b |he prefi|x @code{|
|00001430| 74 72 69 74 6f 6e 2e 6c | 69 62 72 61 72 79 2f 63 |triton.l|ibrary/c|
|00001440| 6c 61 73 73 5f 7d 20 61 | 6e 64 0a 61 72 65 20 64 |lass_} a|nd.are d|
|00001450| 65 73 63 72 69 62 65 64 | 20 75 73 69 6e 67 20 74 |escribed| using t|
|00001460| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 6b 65 79 |he follo|wing key|
|00001470| 77 6f 72 64 73 3a 0a 0a | 40 69 74 65 6d 69 7a 65 |words:..|@itemize|
|00001480| 20 40 62 75 6c 6c 65 74 | 0a 40 69 74 65 6d 20 40 | @bullet|.@item @|
|00001490| 63 6f 64 65 7b 4e 41 4d | 45 7d 0a 0a 54 68 65 20 |code{NAM|E}..The |
|000014a0| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 63 6c 61 73 |name of |the clas|
|000014b0| 73 20 61 6e 64 20 61 20 | 73 68 6f 72 74 20 64 65 |s and a |short de|
|000014c0| 73 63 72 69 70 74 69 6f | 6e 2e 0a 40 69 74 65 6d |scriptio|n..@item|
|000014d0| 20 40 63 6f 64 65 7b 53 | 55 50 45 52 43 4c 41 53 | @code{S|UPERCLAS|
|000014e0| 53 7d 0a 0a 54 68 65 20 | 73 75 70 65 72 63 6c 61 |S}..The |supercla|
|000014f0| 73 73 2e 20 49 66 20 74 | 68 65 20 63 6f 6d 6d 65 |ss. If t|he comme|
|00001500| 6e 74 20 40 63 6f 64 65 | 7b 28 6e 6f 20 61 74 74 |nt @code|{(no att|
|00001510| 72 69 62 75 74 65 73 20 | 69 6e 68 65 72 69 74 65 |ributes |inherite|
|00001520| 64 29 7d 20 69 73 20 61 | 64 64 65 64 2c 0a 61 6c |d)} is a|dded,.al|
|00001530| 6c 20 61 74 74 72 69 62 | 75 74 65 73 20 28 73 65 |l attrib|utes (se|
|00001540| 65 20 62 65 6c 6f 77 29 | 20 61 72 65 20 64 65 73 |e below)| are des|
|00001550| 63 72 69 62 65 64 20 69 | 6e 20 74 68 69 73 20 61 |cribed i|n this a|
|00001560| 75 74 6f 64 6f 63 20 63 | 6c 69 70 2e 20 4f 74 68 |utodoc c|lip. Oth|
|00001570| 65 72 77 69 73 65 0a 61 | 6c 6c 20 61 74 74 72 69 |erwise.a|ll attri|
|00001580| 62 75 74 65 73 20 6f 66 | 20 74 68 65 20 73 75 70 |butes of| the sup|
|00001590| 65 72 63 6c 61 73 73 20 | 61 72 65 20 69 6e 68 65 |erclass |are inhe|
|000015a0| 72 69 74 65 64 2e 0a 40 | 69 74 65 6d 20 40 63 6f |rited..@|item @co|
|000015b0| 64 65 7b 53 59 4e 4f 50 | 53 49 53 7d 0a 0a 54 68 |de{SYNOP|SIS}..Th|
|000015c0| 65 20 74 61 67 73 20 77 | 68 69 63 68 20 69 6e 76 |e tags w|hich inv|
|000015d0| 6f 6b 65 20 74 68 65 20 | 63 72 65 61 74 69 6f 6e |oke the |creation|
|000015e0| 20 6f 66 20 61 6e 20 69 | 6e 73 74 61 6e 63 65 20 | of an i|nstance |
|000015f0| 6f 66 20 74 68 65 20 63 | 6c 61 73 73 2e 20 49 66 |of the c|lass. If|
|00001600| 20 74 68 65 20 74 61 67 | 73 0a 61 72 65 20 65 6e | the tag|s.are en|
|00001610| 63 6c 6f 73 65 64 20 69 | 6e 20 70 61 72 61 6e 74 |closed i|n parant|
|00001620| 68 65 73 65 73 20 74 68 | 65 20 63 6c 61 73 73 20 |heses th|e class |
|00001630| 69 73 20 61 62 73 74 72 | 61 63 74 20 61 6e 64 20 |is abstr|act and |
|00001640| 6e 6f 20 69 6e 73 74 61 | 6e 63 65 73 20 63 61 6e |no insta|nces can|
|00001650| 20 62 65 0a 63 72 65 61 | 74 65 64 2e 0a 40 69 74 | be.crea|ted..@it|
|00001660| 65 6d 20 40 63 6f 64 65 | 7b 41 54 54 52 49 42 55 |em @code|{ATTRIBU|
|00001670| 54 45 53 7d 0a 0a 54 68 | 65 20 61 74 74 72 69 62 |TES}..Th|e attrib|
|00001680| 75 74 65 73 20 77 68 69 | 63 68 20 61 72 65 20 63 |utes whi|ch are c|
|00001690| 72 65 61 74 65 64 20 66 | 6f 72 20 65 76 65 72 79 |reated f|or every|
|000016a0| 20 69 6e 73 74 61 6e 63 | 65 20 6f 66 20 74 68 65 | instanc|e of the|
|000016b0| 20 63 6c 61 73 73 2e 20 | 41 6c 6c 0a 61 74 74 72 | class. |All.attr|
|000016c0| 69 62 75 74 65 73 20 61 | 72 65 20 6c 69 73 74 65 |ibutes a|re liste|
|000016d0| 64 20 77 69 74 68 20 74 | 68 65 69 72 20 74 61 67 |d with t|heir tag|
|000016e0| 20 6e 61 6d 65 73 2c 20 | 65 78 63 65 70 74 20 66 | names, |except f|
|000016f0| 6f 72 20 74 68 65 20 64 | 65 66 61 75 6c 74 0a 61 |or the d|efault.a|
|00001700| 74 74 72 69 62 75 74 65 | 20 77 68 69 63 68 20 69 |ttribute| which i|
|00001710| 73 20 6c 69 73 74 65 64 | 20 61 73 20 40 63 6f 64 |s listed| as @cod|
|00001720| 65 7b 3c 44 65 66 61 75 | 6c 74 3e 7d 2e 20 53 65 |e{<Defau|lt>}. Se|
|00001730| 65 20 61 62 6f 76 65 20 | 66 6f 72 20 73 75 70 65 |e above |for supe|
|00001740| 72 63 6c 61 73 73 0a 61 | 74 74 72 69 62 75 74 65 |rclass.a|ttribute|
|00001750| 73 2e 20 41 20 63 6f 6d | 6d 65 6e 74 20 69 6e 20 |s. A com|ment in |
|00001760| 73 71 75 61 72 65 20 62 | 72 61 63 6b 65 74 73 20 |square b|rackets |
|00001770| 64 65 6e 6f 74 65 73 20 | 69 66 20 61 6e 20 61 74 |denotes |if an at|
|00001780| 74 72 69 62 75 74 65 20 | 63 61 6e 20 62 65 0a 73 |tribute |can be.s|
|00001790| 70 65 63 69 66 69 65 64 | 20 69 6e 20 61 20 63 72 |pecified| in a cr|
|000017a0| 65 61 74 69 6f 6e 20 74 | 61 67 6c 69 73 74 2c 20 |eation t|aglist, |
|000017b0| 6d 6f 64 69 66 69 65 64 | 20 6c 61 74 65 72 20 77 |modified| later w|
|000017c0| 69 74 68 0a 40 63 6f 64 | 65 7b 54 52 4f 4d 5f 53 |ith.@cod|e{TROM_S|
|000017d0| 45 54 41 54 54 52 49 42 | 55 54 45 7d 20 6f 72 20 |ETATTRIB|UTE} or |
|000017e0| 40 63 6f 64 65 7b 54 52 | 5f 53 65 74 41 74 74 72 |@code{TR|_SetAttr|
|000017f0| 69 62 75 74 65 28 29 7d | 20 6f 72 20 71 75 65 72 |ibute()}| or quer|
|00001800| 69 65 64 20 77 69 74 68 | 0a 40 63 6f 64 65 7b 54 |ied with|.@code{T|
|00001810| 52 4f 4d 5f 47 45 54 41 | 54 54 52 49 42 55 54 45 |ROM_GETA|TTRIBUTE|
|00001820| 7d 20 6f 72 20 40 63 6f | 64 65 7b 54 52 5f 47 65 |} or @co|de{TR_Ge|
|00001830| 74 41 74 74 72 69 62 75 | 74 65 28 29 7d 2e 0a 40 |tAttribu|te()}..@|
|00001840| 69 74 65 6d 20 40 63 6f | 64 65 7b 41 50 50 4c 49 |item @co|de{APPLI|
|00001850| 43 41 54 49 4f 4e 20 4d | 45 53 53 41 47 45 53 7d |CATION M|ESSAGES}|
|00001860| 0a 0a 54 68 69 73 20 73 | 65 63 74 69 6f 6e 20 64 |..This s|ection d|
|00001870| 65 73 63 72 69 62 65 73 | 20 61 6c 6c 20 61 70 70 |escribes| all app|
|00001880| 6c 69 63 61 74 69 6f 6e | 20 6d 65 73 73 61 67 65 |lication| message|
|00001890| 73 20 28 40 63 6f 64 65 | 7b 54 52 4d 53 5f 2e 2e |s (@code|{TRMS_..|
|000018a0| 2e 7d 29 20 77 68 69 63 | 68 0a 6f 62 6a 65 63 74 |.}) whic|h.object|
|000018b0| 73 20 6f 66 20 74 68 69 | 73 20 63 6c 61 73 73 20 |s of thi|s class |
|000018c0| 61 72 65 20 63 75 72 72 | 65 6e 74 6c 79 20 61 62 |are curr|ently ab|
|000018d0| 6c 65 20 74 6f 20 73 65 | 6e 64 2e 20 49 66 20 6e |le to se|nd. If n|
|000018e0| 6f 20 6d 65 73 73 61 67 | 65 73 20 61 72 65 0a 64 |o messag|es are.d|
|000018f0| 65 73 63 72 69 62 65 64 | 2c 20 74 68 69 73 20 64 |escribed|, this d|
|00001900| 6f 65 73 6e 27 74 20 6d | 65 61 6e 20 74 68 61 74 |oesn't m|ean that|
|00001910| 20 6e 6f 6e 65 20 61 72 | 65 20 73 65 6e 74 2e 20 | none ar|e sent. |
|00001920| 4e 6f 74 20 61 6c 6c 20 | 63 6c 61 73 73 0a 64 65 |Not all |class.de|
|00001930| 73 63 72 69 70 74 69 6f | 6e 73 20 68 61 76 65 20 |scriptio|ns have |
|00001940| 74 68 69 73 20 73 65 63 | 74 69 6f 6e 20 79 65 74 |this sec|tion yet|
|00001950| 2e 0a 40 69 74 65 6d 20 | 40 63 6f 64 65 7b 4f 42 |..@item |@code{OB|
|00001960| 4a 45 43 54 20 4d 45 53 | 53 41 47 45 53 7d 0a 0a |JECT MES|SAGES}..|
|00001970| 54 68 69 73 20 73 65 63 | 74 69 6f 6e 20 64 65 73 |This sec|tion des|
|00001980| 63 72 69 62 65 73 20 61 | 6c 6c 20 6d 65 73 73 61 |cribes a|ll messa|
|00001990| 67 65 73 20 77 68 69 63 | 68 20 63 61 6e 20 62 65 |ges whic|h can be|
|000019a0| 20 73 65 6e 74 20 74 6f | 20 69 6e 73 74 61 6e 63 | sent to| instanc|
|000019b0| 65 73 20 6f 66 0a 74 68 | 69 73 20 63 6c 61 73 73 |es of.th|is class|
|000019c0| 2e 20 44 65 66 65 72 72 | 65 64 20 6d 65 73 73 61 |. Deferr|ed messa|
|000019d0| 67 65 73 20 61 72 65 20 | 6c 69 73 74 65 64 20 69 |ges are |listed i|
|000019e0| 6e 20 70 61 72 61 6e 74 | 68 65 73 65 73 2e 20 49 |n parant|heses. I|
|000019f0| 6e 68 65 72 69 74 65 64 | 0a 6d 65 73 73 61 67 65 |nherited|.message|
|00001a00| 73 20 61 72 65 20 6e 6f | 74 20 6c 69 73 74 65 64 |s are no|t listed|
|00001a10| 2e 0a 40 65 6e 64 20 69 | 74 65 6d 69 7a 65 0a 0a |..@end i|temize..|
|00001a20| 40 6e 6f 64 65 20 54 55 | 54 5f 41 50 50 2c 20 54 |@node TU|T_APP, T|
|00001a30| 55 54 5f 50 52 4f 2c 20 | 49 4e 54 5f 41 55 54 2c |UT_PRO, |INT_AUT,|
|00001a40| 20 54 6f 70 0a 40 63 68 | 61 70 74 65 72 20 57 72 | Top.@ch|apter Wr|
|00001a50| 69 74 69 6e 67 20 41 70 | 70 6c 69 63 61 74 69 6f |iting Ap|plicatio|
|00001a60| 6e 73 0a 40 63 69 6e 64 | 65 78 20 54 75 74 6f 72 |ns.@cind|ex Tutor|
|00001a70| 69 61 6c 0a 40 73 65 63 | 74 69 6f 6e 20 41 70 70 |ial.@sec|tion App|
|00001a80| 6c 69 63 61 74 69 6f 6e | 73 0a 40 63 69 6e 64 65 |lication|s.@cinde|
|00001a90| 78 20 41 70 70 6c 69 63 | 61 74 69 6f 6e 73 0a 0a |x Applic|ations..|
|00001aa0| 49 6e 20 6f 72 64 65 72 | 20 74 6f 20 75 73 65 20 |In order| to use |
|00001ab0| 40 66 69 6c 65 7b 74 72 | 69 74 6f 6e 2e 6c 69 62 |@file{tr|iton.lib|
|00001ac0| 72 61 72 79 7d 20 79 6f | 75 20 6d 75 73 74 20 66 |rary} yo|u must f|
|00001ad0| 69 72 73 74 20 6f 66 20 | 61 6c 6c 20 6f 70 65 6e |irst of |all open|
|00001ae0| 20 69 74 2c 20 6c 69 6b | 65 20 61 6e 79 20 6f 74 | it, lik|e any ot|
|00001af0| 68 65 72 0a 73 68 61 72 | 65 64 20 6c 69 62 72 61 |her.shar|ed libra|
|00001b00| 72 79 2c 20 61 73 20 64 | 65 73 63 72 69 62 65 64 |ry, as d|escribed|
|00001b10| 20 69 6e 20 74 68 65 20 | 40 63 6f 64 65 7b 41 6d | in the |@code{Am|
|00001b20| 69 67 61 20 52 4f 4d 20 | 4b 65 72 6e 65 6c 20 52 |iga ROM |Kernel R|
|00001b30| 65 66 65 72 65 6e 63 65 | 20 4d 61 6e 75 61 6c 7d |eference| Manual}|
|00001b40| 2c 0a 76 6f 6c 75 6d 65 | 20 40 63 6f 64 65 7b 4c |,.volume| @code{L|
|00001b50| 69 62 72 61 72 69 65 73 | 7d 2e 20 42 65 66 6f 72 |ibraries|}. Befor|
|00001b60| 65 20 71 75 69 74 74 69 | 6e 67 2c 20 79 6f 75 20 |e quitti|ng, you |
|00001b70| 68 61 76 65 20 74 6f 20 | 63 6c 6f 73 65 20 69 74 |have to |close it|
|00001b80| 0a 61 67 61 69 6e 2e 20 | 54 68 65 20 66 6f 6c 6c |.again. |The foll|
|00001b90| 6f 77 69 6e 67 20 63 6f | 64 65 20 6d 61 6b 65 73 |owing co|de makes|
|00001ba0| 20 73 75 72 65 20 74 68 | 61 74 20 79 6f 75 20 63 | sure th|at you c|
|00001bb0| 61 6e 20 75 73 65 20 66 | 75 6e 63 74 69 6f 6e 73 |an use f|unctions|
|00001bc0| 20 66 72 6f 6d 0a 40 66 | 69 6c 65 7b 74 72 69 74 | from.@f|ile{trit|
|00001bd0| 6f 6e 2e 6c 69 62 72 61 | 72 79 7d 20 72 65 6c 65 |on.libra|ry} rele|
|00001be0| 61 73 65 20 31 2e 32 20 | 6f 72 20 68 69 67 68 65 |ase 1.2 |or highe|
|00001bf0| 72 3a 0a 0a 40 65 78 61 | 6d 70 6c 65 0a 20 20 20 |r:..@exa|mple. |
|00001c00| 20 23 69 6e 63 6c 75 64 | 65 20 3c 6c 69 62 72 61 | #includ|e <libra|
|00001c10| 72 69 65 73 2f 74 72 69 | 74 6f 6e 2e 68 3e 0a 20 |ries/tri|ton.h>. |
|00001c20| 20 20 20 23 69 6e 63 6c | 75 64 65 20 3c 63 6c 69 | #incl|ude <cli|
|00001c30| 62 2f 74 72 69 74 6f 6e | 5f 70 72 6f 74 6f 73 2e |b/triton|_protos.|
|00001c40| 68 3e 0a 20 20 20 20 23 | 69 6e 63 6c 75 64 65 20 |h>. #|include |
|00001c50| 3c 70 72 61 67 6d 61 73 | 2f 74 72 69 74 6f 6e 5f |<pragmas|/triton_|
|00001c60| 70 72 61 67 6d 61 73 2e | 68 3e 0a 0a 20 20 20 20 |pragmas.|h>.. |
|00001c70| 73 74 72 75 63 74 20 4c | 69 62 72 61 72 79 20 2a |struct L|ibrary *|
|00001c80| 54 72 69 74 6f 6e 42 61 | 73 65 3b 0a 0a 20 20 20 |TritonBa|se;.. |
|00001c90| 20 69 6e 74 20 6d 61 69 | 6e 28 76 6f 69 64 29 0a | int mai|n(void).|
|00001ca0| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 69 66 28 | @{. | if(|
|00001cb0| 54 72 69 74 6f 6e 42 61 | 73 65 3d 4f 70 65 6e 4c |TritonBa|se=OpenL|
|00001cc0| 69 62 72 61 72 79 28 54 | 52 49 54 4f 4e 4e 41 4d |ibrary(T|RITONNAM|
|00001cd0| 45 2c 54 52 49 54 4f 4e | 31 32 56 45 52 53 49 4f |E,TRITON|12VERSIO|
|00001ce0| 4e 29 29 0a 20 20 20 20 | 20 20 40 7b 0a 20 20 20 |N)). | @{. |
|00001cf0| 20 20 20 20 20 2f 2a 20 | 55 73 65 20 66 75 6e 63 | /* |Use func|
|00001d00| 74 69 6f 6e 73 20 66 72 | 6f 6d 20 74 72 69 74 6f |tions fr|om trito|
|00001d10| 6e 2e 6c 69 62 72 61 72 | 79 2e 2e 2e 20 2a 2f 0a |n.librar|y... */.|
|00001d20| 20 20 20 20 20 20 20 20 | 43 6c 6f 73 65 4c 69 62 | |CloseLib|
|00001d30| 72 61 72 79 28 54 72 69 | 74 6f 6e 42 61 73 65 29 |rary(Tri|tonBase)|
|00001d40| 3b 0a 20 20 20 20 20 20 | 40 7d 0a 20 20 20 20 20 |;. |@}. |
|00001d50| 20 65 6c 73 65 0a 20 20 | 20 20 20 20 40 7b 0a 20 | else. | @{. |
|00001d60| 20 20 20 20 20 20 20 2f | 2a 20 52 65 61 63 74 20 | /|* React |
|00001d70| 6f 6e 20 74 68 65 20 65 | 72 72 6f 72 2e 2e 2e 20 |on the e|rror... |
|00001d80| 2a 2f 0a 20 20 20 20 20 | 20 40 7d 0a 20 20 20 20 |*/. | @}. |
|00001d90| 20 20 72 65 74 75 72 6e | 20 30 3b 0a 20 20 20 20 | return| 0;. |
|00001da0| 40 7d 0a 40 65 6e 64 20 | 65 78 61 6d 70 6c 65 0a |@}.@end |example.|
|00001db0| 0a 41 6c 6c 20 54 72 69 | 74 6f 6e 20 70 72 6f 67 |.All Tri|ton prog|
|00001dc0| 72 61 6d 73 20 61 72 65 | 20 62 61 73 65 64 20 6f |rams are| based o|
|00001dd0| 6e 20 61 20 54 72 69 74 | 6f 6e 20 61 70 70 6c 69 |n a Trit|on appli|
|00001de0| 63 61 74 69 6f 6e 20 73 | 74 72 75 63 74 75 72 65 |cation s|tructure|
|00001df0| 20 28 73 74 72 75 63 74 | 20 54 52 5f 41 70 70 29 | (struct| TR_App)|
|00001e00| 2e 0a 54 68 69 73 20 73 | 74 72 75 63 74 75 72 65 |..This s|tructure|
|00001e10| 20 69 73 20 74 68 65 20 | 63 6f 6e 6e 65 63 74 69 | is the |connecti|
|00001e20| 6f 6e 20 77 68 69 63 68 | 20 6b 65 65 70 73 20 61 |on which| keeps a|
|00001e30| 6c 6c 20 54 72 69 74 6f | 6e 20 70 61 72 74 73 20 |ll Trito|n parts |
|00001e40| 6f 66 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |of your |applicat|
|00001e50| 69 6f 6e 0a 74 6f 67 65 | 74 68 65 72 2e 20 42 65 |ion.toge|ther. Be|
|00001e60| 66 6f 72 65 20 75 73 69 | 6e 67 20 61 6e 79 20 6f |fore usi|ng any o|
|00001e70| 74 68 65 72 20 54 72 69 | 74 6f 6e 20 66 75 6e 63 |ther Tri|ton func|
|00001e80| 74 69 6f 6e 73 2c 20 79 | 6f 75 20 68 61 76 65 20 |tions, y|ou have |
|00001e90| 74 6f 20 63 72 65 61 74 | 65 20 61 20 54 72 69 74 |to creat|e a Trit|
|00001ea0| 6f 6e 0a 61 70 70 6c 69 | 63 61 74 69 6f 6e 2c 20 |on.appli|cation, |
|00001eb0| 61 6e 64 20 79 6f 75 20 | 6d 75 73 74 20 64 65 6c |and you |must del|
|00001ec0| 65 74 65 20 69 74 20 61 | 67 61 69 6e 20 62 65 66 |ete it a|gain bef|
|00001ed0| 6f 72 65 20 79 6f 75 72 | 20 70 72 6f 67 72 61 6d |ore your| program|
|00001ee0| 20 71 75 69 74 73 20 28 | 61 6e 64 20 62 65 66 6f | quits (|and befo|
|00001ef0| 72 65 0a 79 6f 75 20 63 | 6c 6f 73 65 20 40 66 69 |re.you c|lose @fi|
|00001f00| 6c 65 7b 74 72 69 74 6f | 6e 2e 6c 69 62 72 61 72 |le{trito|n.librar|
|00001f10| 79 7d 20 6f 66 20 63 6f | 75 72 73 65 29 2e 20 41 |y} of co|urse). A|
|00001f20| 6e 79 20 54 72 69 74 6f | 6e 20 61 70 70 6c 69 63 |ny Trito|n applic|
|00001f30| 61 74 69 6f 6e 20 6d 75 | 73 74 20 68 61 76 65 20 |ation mu|st have |
|00001f40| 61 74 0a 6c 65 61 73 74 | 20 61 20 73 68 6f 72 74 |at.least| a short|
|00001f50| 20 6e 61 6d 65 2c 20 77 | 68 69 63 68 20 69 73 20 | name, w|hich is |
|00001f60| 75 73 65 64 20 62 79 20 | 54 72 69 74 6f 6e 20 74 |used by |Triton t|
|00001f70| 6f 20 69 64 65 6e 74 69 | 66 79 20 74 68 65 20 61 |o identi|fy the a|
|00001f80| 70 70 6c 69 63 61 74 69 | 6f 6e 2e 20 41 6c 6c 20 |pplicati|on. All |
|00001f90| 6f 74 68 65 72 0a 74 61 | 67 73 20 61 72 65 20 6f |other.ta|gs are o|
|00001fa0| 70 74 69 6f 6e 61 6c 2e | 20 41 20 74 79 70 69 63 |ptional.| A typic|
|00001fb0| 61 6c 20 63 6f 64 65 20 | 73 65 67 6d 65 6e 74 20 |al code |segment |
|00001fc0| 63 6f 75 6c 64 20 6c 6f | 6f 6b 20 6c 69 6b 65 20 |could lo|ok like |
|00001fd0| 74 68 69 73 3a 0a 0a 40 | 65 78 61 6d 70 6c 65 0a |this:..@|example.|
|00001fe0| 20 20 20 20 73 74 72 75 | 63 74 20 54 52 5f 41 70 | stru|ct TR_Ap|
|00001ff0| 70 20 2a 6d 79 41 70 70 | 3b 0a 0a 20 20 20 20 69 |p *myApp|;.. i|
|00002000| 66 28 6d 79 41 70 70 3d | 54 52 5f 43 72 65 61 74 |f(myApp=|TR_Creat|
|00002010| 65 41 70 70 54 61 67 73 | 28 0a 20 20 20 20 20 20 |eAppTags|(. |
|00002020| 54 52 43 41 5f 4e 61 6d | 65 2c 20 20 20 20 22 4d |TRCA_Nam|e, "M|
|00002030| 79 41 70 70 22 2c 0a 20 | 20 20 20 20 20 54 52 43 |yApp",. | TRC|
|00002040| 41 5f 52 65 6c 65 61 73 | 65 2c 20 22 31 2e 30 22 |A_Releas|e, "1.0"|
|00002050| 2c 0a 20 20 20 20 20 20 | 54 52 43 41 5f 56 65 72 |,. |TRCA_Ver|
|00002060| 73 69 6f 6e 2c 20 22 34 | 32 2e 31 31 33 22 2c 0a |sion, "4|2.113",.|
|00002070| 20 20 20 20 20 20 54 52 | 43 41 5f 44 61 74 65 2c | TR|CA_Date,|
|00002080| 20 20 20 20 22 33 2e 31 | 31 2e 39 34 22 2c 0a 20 | "3.1|1.94",. |
|00002090| 20 20 20 20 20 54 41 47 | 5f 45 4e 44 29 29 0a 20 | TAG|_END)). |
|000020a0| 20 20 20 40 7b 0a 20 20 | 20 20 20 20 2f 2a 20 55 | @{. | /* U|
|000020b0| 73 65 20 6d 79 41 70 70 | 20 66 6f 72 20 6f 74 68 |se myApp| for oth|
|000020c0| 65 72 20 54 72 69 74 6f | 6e 20 66 75 6e 63 74 69 |er Trito|n functi|
|000020d0| 6f 6e 73 2e 2e 2e 20 2a | 2f 0a 20 20 20 20 20 20 |ons... *|/. |
|000020e0| 54 52 5f 44 65 6c 65 74 | 65 41 70 70 28 6d 79 41 |TR_Delet|eApp(myA|
|000020f0| 70 70 29 3b 0a 20 20 20 | 20 40 7d 0a 20 20 20 20 |pp);. | @}. |
|00002100| 65 6c 73 65 0a 20 20 20 | 20 40 7b 0a 20 20 20 20 |else. | @{. |
|00002110| 20 20 2f 2a 20 52 65 61 | 63 74 20 6f 6e 20 74 68 | /* Rea|ct on th|
|00002120| 65 20 65 72 72 6f 72 2e | 2e 2e 20 2a 2f 0a 20 20 |e error.|.. */. |
|00002130| 20 20 40 7d 0a 40 65 6e | 64 20 65 78 61 6d 70 6c | @}.@en|d exampl|
|00002140| 65 0a 0a 54 68 65 20 6c | 69 6e 6b 65 72 20 6c 69 |e..The l|inker li|
|00002150| 62 72 61 72 79 20 40 66 | 69 6c 65 7b 74 72 69 74 |brary @f|ile{trit|
|00002160| 6f 6e 2e 6c 69 62 7d 20 | 6f 66 66 65 72 73 20 61 |on.lib} |offers a|
|00002170| 6e 20 65 61 73 69 65 72 | 20 77 61 79 20 74 6f 20 |n easier| way to |
|00002180| 6f 70 65 6e 20 40 66 69 | 6c 65 7b 74 72 69 74 6f |open @fi|le{trito|
|00002190| 6e 2e 6c 69 62 72 61 72 | 79 7d 0a 61 6e 64 20 63 |n.librar|y}.and c|
|000021a0| 72 65 61 74 65 20 61 20 | 54 72 69 74 6f 6e 20 61 |reate a |Triton a|
|000021b0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 73 74 72 75 63 |pplicati|on struc|
|000021c0| 74 75 72 65 2e 20 54 68 | 65 20 74 77 6f 20 65 78 |ture. Th|e two ex|
|000021d0| 61 6d 70 6c 65 73 20 66 | 72 6f 6d 20 61 62 6f 76 |amples f|rom abov|
|000021e0| 65 20 63 61 6e 20 62 65 | 20 63 6f 6d 62 69 6e 65 |e can be| combine|
|000021f0| 64 0a 69 6e 74 6f 20 74 | 68 65 20 66 6f 6c 6c 6f |d.into t|he follo|
|00002200| 77 69 6e 67 20 73 68 6f | 72 74 20 76 65 72 73 69 |wing sho|rt versi|
|00002210| 6f 6e 3a 0a 0a 40 65 78 | 61 6d 70 6c 65 0a 20 20 |on:..@ex|ample. |
|00002220| 20 20 23 69 6e 63 6c 75 | 64 65 20 3c 6c 69 62 72 | #inclu|de <libr|
|00002230| 61 72 69 65 73 2f 74 72 | 69 74 6f 6e 2e 68 3e 0a |aries/tr|iton.h>.|
|00002240| 20 20 20 20 23 69 6e 63 | 6c 75 64 65 20 3c 70 72 | #inc|lude <pr|
|00002250| 6f 74 6f 2f 74 72 69 74 | 6f 6e 2e 68 3e 0a 0a 20 |oto/trit|on.h>.. |
|00002260| 20 20 20 69 6e 74 20 6d | 61 69 6e 28 76 6f 69 64 | int m|ain(void|
|00002270| 29 0a 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 69 |). @{|. i|
|00002280| 66 28 54 52 5f 4f 70 65 | 6e 54 72 69 74 6f 6e 28 |f(TR_Ope|nTriton(|
|00002290| 54 52 49 54 4f 4e 31 32 | 56 45 52 53 49 4f 4e 2c |TRITON12|VERSION,|
|000022a0| 0a 20 20 20 20 20 20 20 | 20 54 52 43 41 5f 4e 61 |. | TRCA_Na|
|000022b0| 6d 65 2c 20 20 20 20 22 | 4d 79 41 70 70 22 2c 0a |me, "|MyApp",.|
|000022c0| 20 20 20 20 20 20 20 20 | 54 52 43 41 5f 52 65 6c | |TRCA_Rel|
|000022d0| 65 61 73 65 2c 20 22 31 | 2e 30 22 2c 0a 20 20 20 |ease, "1|.0",. |
|000022e0| 20 20 20 20 20 54 52 43 | 41 5f 56 65 72 73 69 6f | TRC|A_Versio|
|000022f0| 6e 2c 20 22 34 32 2e 31 | 31 33 22 2c 0a 20 20 20 |n, "42.1|13",. |
|00002300| 20 20 20 20 20 54 52 43 | 41 5f 44 61 74 65 2c 20 | TRC|A_Date, |
|00002310| 20 20 20 22 33 2e 31 31 | 2e 39 34 22 2c 0a 20 20 | "3.11|.94",. |
|00002320| 20 20 20 20 20 20 54 41 | 47 5f 45 4e 44 29 29 0a | TA|G_END)).|
|00002330| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|00002340| 20 2f 2a 20 54 68 65 20 | 6f 70 65 6e 65 64 20 61 | /* The |opened a|
|00002350| 70 70 6c 69 63 61 74 69 | 6f 6e 20 69 73 20 63 61 |pplicati|on is ca|
|00002360| 6c 6c 65 64 20 27 41 70 | 70 6c 69 63 61 74 69 6f |lled 'Ap|plicatio|
|00002370| 6e 27 20 2a 2f 0a 20 20 | 20 20 20 20 20 20 54 52 |n' */. | TR|
|00002380| 5f 43 6c 6f 73 65 54 72 | 69 74 6f 6e 28 29 3b 0a |_CloseTr|iton();.|
|00002390| 20 20 20 20 20 20 40 7d | 0a 20 20 20 20 20 20 65 | @}|. e|
|000023a0| 6c 73 65 0a 20 20 20 20 | 20 20 40 7b 0a 20 20 20 |lse. | @{. |
|000023b0| 20 20 20 20 20 2f 2a 20 | 52 65 61 63 74 20 6f 6e | /* |React on|
|000023c0| 20 74 68 65 20 65 72 72 | 6f 72 2e 2e 2e 20 2a 2f | the err|or... */|
|000023d0| 0a 20 20 20 20 20 20 40 | 7d 0a 20 20 20 20 20 20 |. @|}. |
|000023e0| 72 65 74 75 72 6e 20 30 | 3b 0a 20 20 20 20 40 7d |return 0|;. @}|
|000023f0| 0a 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 0a 40 |.@end ex|ample..@|
|00002400| 6e 6f 64 65 20 54 55 54 | 5f 50 52 4f 2c 20 54 55 |node TUT|_PRO, TU|
|00002410| 54 5f 4d 45 4e 2c 20 54 | 55 54 5f 41 50 50 2c 20 |T_MEN, T|UT_APP, |
|00002420| 54 6f 70 0a 40 73 65 63 | 74 69 6f 6e 20 50 72 6f |Top.@sec|tion Pro|
|00002430| 6a 65 63 74 73 0a 40 63 | 69 6e 64 65 78 20 50 72 |jects.@c|index Pr|
|00002440| 6f 6a 65 63 74 73 0a 0a | 41 20 54 72 69 74 6f 6e |ojects..|A Triton|
|00002450| 20 50 72 6f 6a 65 63 74 | 20 69 73 20 74 68 65 20 | Project| is the |
|00002460| 6e 65 78 74 20 73 6d 61 | 6c 6c 65 72 20 65 6e 74 |next sma|ller ent|
|00002470| 69 74 79 20 6f 66 20 61 | 20 54 72 69 74 6f 6e 20 |ity of a| Triton |
|00002480| 47 55 49 2e 20 43 75 72 | 72 65 6e 74 6c 79 0a 61 |GUI. Cur|rently.a|
|00002490| 20 70 72 6f 6a 65 63 74 | 20 63 6f 6e 74 61 69 6e | project| contain|
|000024a0| 73 20 65 78 61 63 74 6c | 79 20 6f 6e 65 20 49 6e |s exactl|y one In|
|000024b0| 74 75 69 74 69 6f 6e 20 | 77 69 6e 64 6f 77 2c 20 |tuition |window, |
|000024c0| 62 75 74 20 69 6e 20 66 | 75 74 75 72 65 20 76 65 |but in f|uture ve|
|000024d0| 72 73 69 6f 6e 73 0a 6f | 66 20 54 72 69 74 6f 6e |rsions.o|f Triton|
|000024e0| 20 69 74 20 63 6f 75 6c | 64 20 62 65 20 70 6f 73 | it coul|d be pos|
|000024f0| 73 69 62 6c 65 20 74 6f | 20 61 74 74 61 63 68 20 |sible to| attach |
|00002500| 6d 6f 72 65 20 77 69 6e | 64 6f 77 73 20 74 6f 20 |more win|dows to |
|00002510| 61 20 70 72 6f 6a 65 63 | 74 2e 0a 55 70 6f 6e 20 |a projec|t..Upon |
|00002520| 6f 70 65 6e 69 6e 67 20 | 61 20 70 72 6f 6a 65 63 |opening |a projec|
|00002530| 74 2c 20 79 6f 75 20 68 | 61 76 65 20 74 6f 20 73 |t, you h|ave to s|
|00002540| 70 65 63 69 66 79 20 61 | 6c 6c 20 6f 62 6a 65 63 |pecify a|ll objec|
|00002550| 74 73 20 77 68 69 63 68 | 20 61 72 65 20 74 6f 0a |ts which| are to.|
|00002560| 62 65 20 64 69 73 70 6c | 61 79 65 64 20 69 6e 20 |be displ|ayed in |
|00002570| 74 68 65 20 77 69 6e 64 | 6f 77 2c 20 74 68 65 20 |the wind|ow, the |
|00002580| 77 69 6e 64 6f 77 27 73 | 20 6d 65 6e 75 20 61 6e |window's| menu an|
|00002590| 64 20 73 6f 6d 65 20 74 | 61 67 73 20 64 65 73 63 |d some t|ags desc|
|000025a0| 72 69 62 69 6e 67 0a 77 | 69 6e 64 6f 77 20 70 72 |ribing.w|indow pr|
|000025b0| 6f 70 65 72 74 69 65 73 | 2e 0a 0a 41 74 20 66 69 |operties|...At fi|
|000025c0| 72 73 74 20 79 6f 75 20 | 68 61 76 65 20 74 6f 20 |rst you |have to |
|000025d0| 73 70 65 63 69 66 79 20 | 74 68 65 20 77 69 6e 64 |specify |the wind|
|000025e0| 6f 77 20 70 72 6f 70 65 | 72 74 69 65 73 2c 20 74 |ow prope|rties, t|
|000025f0| 68 65 6e 20 74 68 65 20 | 6d 65 6e 75 73 20 61 6e |hen the |menus an|
|00002600| 64 0a 66 69 6e 61 6c 6c | 79 20 6f 6e 65 20 28 21 |d.finall|y one (!|
|00002610| 29 20 6f 62 6a 65 63 74 | 2e 20 4e 6f 72 6d 61 6c |) object|. Normal|
|00002620| 6c 79 20 74 68 69 73 20 | 6f 62 6a 65 63 74 20 77 |ly this |object w|
|00002630| 69 6c 6c 20 62 65 20 61 | 20 67 72 6f 75 70 20 77 |ill be a| group w|
|00002640| 68 69 63 68 20 63 6f 6e | 74 61 69 6e 73 0a 6f 74 |hich con|tains.ot|
|00002650| 68 65 72 20 6f 62 6a 65 | 63 74 73 20 6f 72 20 67 |her obje|cts or g|
|00002660| 72 6f 75 70 73 2e 0a 0a | 4e 6f 74 65 20 74 68 61 |roups...|Note tha|
|00002670| 74 20 61 6c 6c 20 74 61 | 67 73 20 61 72 65 20 6f |t all ta|gs are o|
|00002680| 70 74 69 6f 6e 61 6c 2e | 20 59 6f 75 20 6d 61 79 |ptional.| You may|
|00002690| 20 6a 75 73 74 20 61 73 | 20 77 65 6c 6c 0a 6f 70 | just as| well.op|
|000026a0| 65 6e 20 61 20 77 69 6e | 64 6f 77 20 77 69 74 68 |en a win|dow with|
|000026b0| 6f 75 74 20 61 6e 79 20 | 74 61 67 73 2e 20 54 68 |out any |tags. Th|
|000026c0| 69 73 20 77 69 6c 6c 20 | 72 65 73 75 6c 74 20 69 |is will |result i|
|000026d0| 6e 20 61 20 73 6d 61 6c | 6c 20 77 69 6e 64 6f 77 |n a smal|l window|
|000026e0| 2c 20 63 6f 6e 73 69 73 | 74 69 6e 67 0a 6f 6e 6c |, consis|ting.onl|
|000026f0| 79 20 6f 66 20 74 68 65 | 20 63 6c 6f 73 65 20 61 |y of the| close a|
|00002700| 6e 64 20 64 65 70 74 68 | 20 67 61 64 67 65 74 20 |nd depth| gadget |
|00002710| 61 6e 64 20 61 20 73 6d | 61 6c 6c 20 64 72 61 67 |and a sm|all drag|
|00002720| 67 69 6e 67 20 62 61 72 | 2c 20 62 65 69 6e 67 20 |ging bar|, being |
|00002730| 6f 70 65 6e 65 64 0a 6f | 76 65 72 20 74 68 65 20 |opened.o|ver the |
|00002740| 64 65 66 61 75 6c 74 20 | 70 75 62 6c 69 63 20 73 |default |public s|
|00002750| 63 72 65 65 6e 27 73 20 | 74 69 74 6c 65 20 62 61 |creen's |title ba|
|00002760| 72 2e 0a 0a 41 73 20 77 | 69 74 68 20 6e 61 6d 69 |r...As w|ith nami|
|00002770| 6e 67 20 54 72 69 74 6f | 6e 20 61 70 70 6c 69 63 |ng Trito|n applic|
|00002780| 61 74 69 6f 6e 73 2c 0a | 79 6f 75 20 73 68 6f 75 |ations,.|you shou|
|00002790| 6c 64 20 67 69 76 65 20 | 65 61 63 68 20 70 72 6f |ld give |each pro|
|000027a0| 6a 65 63 74 20 61 74 20 | 6c 65 61 73 74 20 61 20 |ject at |least a |
|000027b0| 75 6e 69 71 75 65 20 49 | 44 20 77 68 69 63 68 20 |unique I|D which |
|000027c0| 69 73 20 75 73 65 64 20 | 62 79 20 54 72 69 74 6f |is used |by Trito|
|000027d0| 6e 0a 65 2e 67 2e 20 66 | 6f 72 20 72 65 6d 65 6d |n.e.g. f|or remem|
|000027e0| 62 65 72 69 6e 67 20 74 | 68 65 20 77 69 6e 64 6f |bering t|he windo|
|000027f0| 77 20 64 69 6d 65 6e 73 | 69 6f 6e 73 2e 0a 0a 4f |w dimens|ions...O|
|00002800| 70 65 6e 69 6e 67 20 61 | 6e 64 20 63 6c 6f 73 69 |pening a|nd closi|
|00002810| 6e 67 20 61 0a 70 72 6f | 6a 65 63 74 20 77 69 74 |ng a.pro|ject wit|
|00002820| 68 6f 75 74 20 61 6e 79 | 20 6f 62 6a 65 63 74 73 |hout any| objects|
|00002830| 20 61 6e 64 20 6d 65 6e | 75 73 20 63 6f 75 6c 64 | and men|us could|
|00002840| 20 6c 6f 6f 6b 20 6c 69 | 6b 65 20 74 68 69 73 3a | look li|ke this:|
|00002850| 0a 0a 40 65 78 61 6d 70 | 6c 65 0a 20 20 20 20 73 |..@examp|le. s|
|00002860| 74 72 75 63 74 20 54 61 | 67 49 74 65 6d 20 64 75 |truct Ta|gItem du|
|00002870| 6d 6d 79 54 61 67 73 3d | 0a 20 20 20 20 40 7b 0a |mmyTags=|. @{.|
|00002880| 20 20 20 20 20 20 54 52 | 57 49 5f 54 69 74 6c 65 | TR|WI_Title|
|00002890| 2c 20 28 55 4c 4f 4e 47 | 29 20 22 41 20 64 75 6d |, (ULONG|) "A dum|
|000028a0| 6d 79 20 77 69 6e 64 6f | 77 22 2c 0a 20 20 20 20 |my windo|w",. |
|000028b0| 20 20 54 52 57 49 5f 49 | 44 2c 20 20 20 20 20 20 | TRWI_I|D, |
|000028c0| 20 20 20 20 20 20 34 32 | 2c 0a 20 20 20 20 20 20 | 42|,. |
|000028d0| 54 41 47 5f 45 4e 44 0a | 20 20 20 20 40 7d 3b 0a |TAG_END.| @};.|
|000028e0| 0a 20 20 20 20 76 6f 69 | 64 20 64 75 6d 6d 79 46 |. voi|d dummyF|
|000028f0| 75 6e 63 74 69 6f 6e 28 | 76 6f 69 64 29 0a 20 20 |unction(|void). |
|00002900| 20 20 40 7b 0a 20 20 20 | 20 20 20 73 74 72 75 63 | @{. | struc|
|00002910| 74 20 54 52 5f 50 72 6f | 6a 65 63 74 20 2a 64 75 |t TR_Pro|ject *du|
|00002920| 6d 6d 79 50 72 6f 6a 65 | 63 74 3b 0a 0a 20 20 20 |mmyProje|ct;.. |
|00002930| 20 20 20 69 66 28 64 75 | 6d 6d 79 50 72 6f 6a 65 | if(du|mmyProje|
|00002940| 63 74 3d 54 52 5f 4f 70 | 65 6e 50 72 6f 6a 65 63 |ct=TR_Op|enProjec|
|00002950| 74 28 41 70 70 6c 69 63 | 61 74 69 6f 6e 2c 64 75 |t(Applic|ation,du|
|00002960| 6d 6d 79 54 61 67 73 29 | 29 0a 20 20 20 20 20 20 |mmyTags)|). |
|00002970| 40 7b 0a 20 20 20 20 20 | 20 20 20 2f 2a 20 4f 70 |@{. | /* Op|
|00002980| 65 6e 65 64 20 73 75 63 | 63 65 73 73 66 75 6c 6c |ened suc|cessfull|
|00002990| 79 20 2a 2f 0a 20 20 20 | 20 20 20 20 20 54 52 5f |y */. | TR_|
|000029a0| 43 6c 6f 73 65 50 72 6f | 6a 65 63 74 28 64 75 6d |ClosePro|ject(dum|
|000029b0| 6d 79 50 72 6f 6a 65 63 | 74 29 3b 0a 20 20 20 20 |myProjec|t);. |
|000029c0| 20 20 40 7d 0a 20 20 20 | 20 20 20 65 6c 73 65 0a | @}. | else.|
|000029d0| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|000029e0| 20 2f 2a 20 52 65 61 63 | 74 20 6f 6e 20 74 68 65 | /* Reac|t on the|
|000029f0| 20 65 72 72 6f 72 2e 2e | 2e 20 2a 2f 0a 20 20 20 | error..|. */. |
|00002a00| 20 20 20 40 7d 0a 20 20 | 20 20 40 7d 0a 40 65 6e | @}. | @}.@en|
|00002a10| 64 20 65 78 61 6d 70 6c | 65 0a 0a 4f 66 20 63 6f |d exampl|e..Of co|
|00002a20| 75 72 73 65 2c 20 74 68 | 69 73 20 77 61 79 20 6f |urse, th|is way o|
|00002a30| 66 20 6f 70 65 6e 69 6e | 67 20 61 20 70 72 6f 6a |f openin|g a proj|
|00002a40| 65 63 74 20 76 69 61 20 | 61 20 73 74 61 74 69 63 |ect via |a static|
|00002a50| 20 54 61 67 49 74 65 6d | 20 6c 69 73 74 20 64 6f | TagItem| list do|
|00002a60| 65 73 6e 27 74 0a 61 6c | 6c 6f 77 20 69 6e 73 65 |esn't.al|low inse|
|00002a70| 72 74 69 6f 6e 20 6f 66 | 20 6f 62 6a 65 63 74 20 |rtion of| object |
|00002a80| 70 61 72 61 6d 65 74 65 | 72 73 20 6f 72 20 6c 6f |paramete|rs or lo|
|00002a90| 63 61 6c 69 7a 65 64 20 | 73 74 72 69 6e 67 73 2e |calized |strings.|
|00002aa0| 20 53 69 6e 63 65 20 79 | 6f 75 20 6e 65 65 64 20 | Since y|ou need |
|00002ab0| 74 68 65 73 65 0a 66 65 | 61 74 75 72 65 73 20 6d |these.fe|atures m|
|00002ac0| 6f 73 74 20 74 69 6d 65 | 73 2c 20 79 6f 75 20 73 |ost time|s, you s|
|00002ad0| 68 6f 75 6c 64 20 69 6e | 73 74 65 61 64 20 75 73 |hould in|stead us|
|00002ae0| 65 20 61 20 64 79 6e 61 | 6d 69 63 20 54 61 67 4c |e a dyna|mic TagL|
|00002af0| 69 73 74 20 77 68 69 63 | 68 20 69 73 20 62 75 69 |ist whic|h is bui|
|00002b00| 6c 74 0a 6f 6e 20 74 68 | 65 20 73 74 61 63 6b 20 |lt.on th|e stack |
|00002b10| 61 74 20 72 75 6e 74 69 | 6d 65 2e 20 42 65 20 73 |at runti|me. Be s|
|00002b20| 75 72 65 20 74 6f 20 73 | 65 74 20 61 20 6c 61 72 |ure to s|et a lar|
|00002b30| 67 65 20 65 6e 6f 75 67 | 68 20 73 74 61 63 6b 21 |ge enoug|h stack!|
|00002b40| 20 53 6f 6d 65 20 64 65 | 76 65 6c 6f 70 6d 65 6e | Some de|velopmen|
|00002b50| 74 0a 73 79 73 74 65 6d | 73 20 6f 66 66 65 72 20 |t.system|s offer |
|00002b60| 61 75 74 6f 6d 61 74 69 | 63 20 73 74 61 63 6b 20 |automati|c stack |
|00002b70| 73 65 74 74 69 6e 67 20 | 69 6e 20 74 68 65 69 72 |setting |in their|
|00002b80| 20 73 74 61 72 74 75 70 | 20 63 6f 64 65 2c 20 77 | startup| code, w|
|00002b90| 68 69 63 68 20 63 6f 6d | 65 73 0a 68 61 6e 64 79 |hich com|es.handy|
|00002ba0| 20 69 6e 20 74 68 6f 73 | 65 20 73 69 74 75 61 74 | in thos|e situat|
|00002bb0| 69 6f 6e 73 2e 20 50 6c | 65 61 73 65 20 64 6f 20 |ions. Pl|ease do |
|00002bc0| 6e 6f 74 20 72 65 6c 79 | 20 6f 6e 20 74 68 65 20 |not rely| on the |
|00002bd0| 75 73 65 72 20 74 6f 20 | 73 65 74 20 74 68 65 0a |user to |set the.|
|00002be0| 73 74 61 63 6b 21 0a 0a | 4e 6f 74 65 20 74 68 61 |stack!..|Note tha|
|00002bf0| 74 20 69 74 20 69 73 20 | 63 75 72 72 65 6e 74 6c |t it is |currentl|
|00002c00| 79 20 6e 6f 74 20 70 6f | 73 73 69 62 6c 65 20 74 |y not po|ssible t|
|00002c10| 6f 20 75 73 65 20 40 63 | 6f 64 65 7b 54 41 47 5f |o use @c|ode{TAG_|
|00002c20| 4d 4f 52 45 7d 2c 0a 40 | 63 6f 64 65 7b 54 41 47 |MORE},.@|code{TAG|
|00002c30| 5f 53 4b 49 50 7d 20 61 | 6e 64 20 40 63 6f 64 65 |_SKIP} a|nd @code|
|00002c40| 7b 54 41 47 5f 49 47 4e | 4f 52 45 7d 20 77 69 74 |{TAG_IGN|ORE} wit|
|00002c50| 68 20 54 72 69 74 6f 6e | 20 74 61 67 6c 69 73 74 |h Triton| taglist|
|00002c60| 73 2e 0a 0a 41 6e 64 20 | 6e 6f 77 20 62 61 63 6b |s...And |now back|
|00002c70| 20 74 6f 20 6f 75 72 20 | 63 6f 64 65 2c 20 74 68 | to our |code, th|
|00002c80| 69 73 20 74 69 6d 65 20 | 77 69 74 68 20 61 20 64 |is time |with a d|
|00002c90| 79 6e 61 6d 69 63 20 6c | 69 73 74 2e 20 49 6d 61 |ynamic l|ist. Ima|
|00002ca0| 67 69 6e 65 20 61 20 66 | 75 6e 63 74 69 6f 6e 0a |gine a f|unction.|
|00002cb0| 40 63 6f 64 65 7b 53 54 | 52 50 54 52 20 47 65 74 |@code{ST|RPTR Get|
|00002cc0| 4c 6f 63 53 74 72 28 69 | 6e 74 20 6e 75 6d 29 7d |LocStr(i|nt num)}|
|00002cd0| 20 77 68 69 63 68 20 67 | 69 76 65 73 20 79 6f 75 | which g|ives you|
|00002ce0| 20 61 20 6c 6f 63 61 6c | 69 7a 65 64 20 73 74 72 | a local|ized str|
|00002cf0| 69 6e 67 2e 0a 0a 40 65 | 78 61 6d 70 6c 65 0a 20 |ing...@e|xample. |
|00002d00| 20 20 20 76 6f 69 64 20 | 64 75 6d 6d 79 46 75 6e | void |dummyFun|
|00002d10| 63 74 69 6f 6e 28 76 6f | 69 64 29 0a 20 20 20 20 |ction(vo|id). |
|00002d20| 40 7b 0a 20 20 20 20 20 | 20 73 74 72 75 63 74 20 |@{. | struct |
|00002d30| 54 52 5f 50 72 6f 6a 65 | 63 74 20 2a 64 75 6d 6d |TR_Proje|ct *dumm|
|00002d40| 79 50 72 6f 6a 65 63 74 | 3b 0a 0a 20 20 20 20 20 |yProject|;.. |
|00002d50| 20 69 66 28 64 75 6d 6d | 79 50 72 6f 6a 65 63 74 | if(dumm|yProject|
|00002d60| 3d 54 52 5f 4f 70 65 6e | 50 72 6f 6a 65 63 74 54 |=TR_Open|ProjectT|
|00002d70| 61 67 73 28 41 70 70 6c | 69 63 61 74 69 6f 6e 2c |ags(Appl|ication,|
|00002d80| 0a 20 20 20 20 20 20 20 | 20 54 52 57 49 5f 54 69 |. | TRWI_Ti|
|00002d90| 74 6c 65 2c 20 28 55 4c | 4f 4e 47 29 20 47 65 74 |tle, (UL|ONG) Get|
|00002da0| 4c 6f 63 53 74 72 28 4d | 53 47 5f 57 49 4e 54 49 |LocStr(M|SG_WINTI|
|00002db0| 54 4c 45 5f 44 55 4d 4d | 59 29 2c 0a 20 20 20 20 |TLE_DUMM|Y),. |
|00002dc0| 20 20 20 20 54 52 57 49 | 5f 49 44 2c 20 20 20 20 | TRWI|_ID, |
|00002dd0| 20 20 20 20 20 20 20 20 | 34 32 2c 0a 20 20 20 20 | |42,. |
|00002de0| 20 20 20 20 54 41 47 5f | 45 4e 44 29 29 0a 20 20 | TAG_|END)). |
|00002df0| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 20 20 2f | @{. | /|
|00002e00| 2a 20 4f 70 65 6e 65 64 | 20 73 75 63 63 65 73 73 |* Opened| success|
|00002e10| 66 75 6c 6c 79 20 2a 2f | 0a 20 20 20 20 20 20 20 |fully */|. |
|00002e20| 20 54 52 5f 43 6c 6f 73 | 65 50 72 6f 6a 65 63 74 | TR_Clos|eProject|
|00002e30| 28 64 75 6d 6d 79 50 72 | 6f 6a 65 63 74 29 3b 0a |(dummyPr|oject);.|
|00002e40| 20 20 20 20 20 20 40 7d | 0a 20 20 20 20 20 20 65 | @}|. e|
|00002e50| 6c 73 65 0a 20 20 20 20 | 20 20 40 7b 0a 20 20 20 |lse. | @{. |
|00002e60| 20 20 20 20 20 2f 2a 20 | 52 65 61 63 74 20 6f 6e | /* |React on|
|00002e70| 20 74 68 65 20 65 72 72 | 6f 72 2e 2e 2e 20 2a 2f | the err|or... */|
|00002e80| 0a 20 20 20 20 20 20 40 | 7d 0a 20 20 20 20 40 7d |. @|}. @}|
|00002e90| 0a 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 0a 54 |.@end ex|ample..T|
|00002ea0| 68 65 20 49 44 20 34 32 | 20 69 6e 20 74 68 65 20 |he ID 42| in the |
|00002eb0| 61 62 6f 76 65 20 65 78 | 61 6d 70 6c 65 73 20 68 |above ex|amples h|
|00002ec0| 61 73 20 62 65 65 6e 20 | 63 68 6f 73 65 6e 20 72 |as been |chosen r|
|00002ed0| 61 6e 64 6f 6d 6c 79 2e | 20 54 68 69 73 20 69 73 |andomly.| This is|
|00002ee0| 20 6e 6f 0a 70 72 6f 62 | 6c 65 6d 20 61 73 20 6c | no.prob|lem as l|
|00002ef0| 6f 6e 67 20 61 73 20 79 | 6f 75 20 73 74 69 63 6b |ong as y|ou stick|
|00002f00| 20 74 6f 20 74 68 69 73 | 20 49 44 20 69 6e 20 66 | to this| ID in f|
|00002f10| 75 74 75 72 65 20 75 70 | 64 61 74 65 73 20 6f 66 |uture up|dates of|
|00002f20| 20 79 6f 75 72 20 61 70 | 70 6c 69 63 61 74 69 6f | your ap|plicatio|
|00002f30| 6e 2e 0a 4f 74 68 65 72 | 77 69 73 65 20 74 68 65 |n..Other|wise the|
|00002f40| 20 77 69 6e 64 6f 77 20 | 64 69 6d 65 6e 73 69 6f | window |dimensio|
|00002f50| 6e 73 20 77 6f 75 6c 64 | 20 62 65 20 77 72 6f 6e |ns would| be wron|
|00002f60| 67 20 61 6e 64 20 74 68 | 65 20 75 73 65 72 20 77 |g and th|e user w|
|00002f70| 6f 75 6c 64 20 68 61 76 | 65 20 74 6f 0a 61 64 6a |ould hav|e to.adj|
|00002f80| 75 73 74 20 74 68 65 6d | 20 61 67 61 69 6e 2e 0a |ust them| again..|
|00002f90| 0a 49 6e 20 6f 72 64 65 | 72 20 74 6f 20 6e 6f 74 |.In orde|r to not|
|00002fa0| 20 75 73 65 20 49 44 73 | 20 74 77 69 63 65 2c 20 | use IDs| twice, |
|00002fb0| 69 74 20 63 61 6e 20 62 | 65 20 75 73 65 66 75 6c |it can b|e useful|
|00002fc0| 20 74 6f 20 65 6e 75 6d | 65 72 61 74 65 20 74 68 | to enum|erate th|
|00002fd0| 65 6d 3a 0a 0a 40 65 78 | 61 6d 70 6c 65 0a 20 20 |em:..@ex|ample. |
|00002fe0| 20 20 65 6e 75 6d 20 77 | 69 6e 64 6f 77 49 44 73 | enum w|indowIDs|
|00002ff0| 20 40 7b 57 49 4e 49 44 | 5f 44 55 4d 4d 59 3d 31 | @{WINID|_DUMMY=1|
|00003000| 2c 20 57 49 4e 49 44 5f | 46 4f 4f 2c 20 57 49 4e |, WINID_|FOO, WIN|
|00003010| 49 44 5f 42 41 52 40 7d | 3b 0a 40 65 6e 64 20 65 |ID_BAR@}|;.@end e|
|00003020| 78 61 6d 70 6c 65 0a 0a | 4e 6f 74 65 20 74 68 61 |xample..|Note tha|
|00003030| 74 20 77 69 6e 64 6f 77 | 20 49 44 73 20 6d 75 73 |t window| IDs mus|
|00003040| 74 20 62 65 20 64 69 66 | 66 65 72 65 6e 74 20 66 |t be dif|ferent f|
|00003050| 72 6f 6d 20 30 2e 20 30 | 20 69 73 20 65 71 75 61 |rom 0. 0| is equa|
|00003060| 6c 20 74 6f 0a 6e 6f 20 | 49 44 20 61 74 20 61 6c |l to.no |ID at al|
|00003070| 6c 2e 0a 0a 53 65 65 20 | 74 68 65 20 61 75 74 6f |l...See |the auto|
|00003080| 64 6f 63 20 63 6c 69 70 | 20 40 63 6f 64 65 7b 74 |doc clip| @code{t|
|00003090| 72 69 74 6f 6e 2e 6c 69 | 62 72 61 72 79 2f 54 52 |riton.li|brary/TR|
|000030a0| 5f 4f 70 65 6e 50 72 6f | 6a 65 63 74 28 29 7d 20 |_OpenPro|ject()} |
|000030b0| 66 6f 72 20 64 65 74 61 | 69 6c 73 0a 61 62 6f 75 |for deta|ils.abou|
|000030c0| 74 20 74 68 65 20 73 75 | 70 70 6f 72 74 65 64 20 |t the su|pported |
|000030d0| 74 61 67 73 2e 0a 0a 40 | 6e 6f 64 65 20 54 55 54 |tags...@|node TUT|
|000030e0| 5f 4d 45 4e 2c 20 54 55 | 54 5f 4f 42 4a 2c 20 54 |_MEN, TU|T_OBJ, T|
|000030f0| 55 54 5f 50 52 4f 2c 20 | 54 6f 70 0a 40 73 65 63 |UT_PRO, |Top.@sec|
|00003100| 74 69 6f 6e 20 4d 65 6e | 75 73 0a 40 63 69 6e 64 |tion Men|us.@cind|
|00003110| 65 78 20 4d 65 6e 75 73 | 0a 0a 41 6e 79 20 70 72 |ex Menus|..Any pr|
|00003120| 6f 6a 65 63 74 20 64 65 | 66 69 6e 69 74 6f 6e 20 |oject de|finiton |
|00003130| 6d 61 79 20 63 6f 6e 74 | 61 69 6e 20 6d 65 6e 75 |may cont|ain menu|
|00003140| 73 2e 20 54 68 65 20 6d | 65 6e 75 20 74 61 67 73 |s. The m|enu tags|
|00003150| 20 6d 75 73 74 20 66 6f | 6c 6c 6f 77 0a 74 68 65 | must fo|llow.the|
|00003160| 20 77 69 6e 64 6f 77 20 | 74 61 67 73 20 69 6d 6d | window |tags imm|
|00003170| 65 64 69 61 74 65 6c 79 | 2c 20 62 65 66 6f 72 65 |ediately|, before|
|00003180| 20 74 68 65 20 6f 62 6a | 65 63 74 20 74 61 67 73 | the obj|ect tags|
|00003190| 2e 20 49 66 20 61 20 6d | 65 6e 75 20 68 61 73 0a |. If a m|enu has.|
|000031a0| 61 6e 20 6f 62 6a 65 63 | 74 20 49 44 2c 20 74 68 |an objec|t ID, th|
|000031b0| 65 20 54 52 41 54 5f 49 | 44 20 74 61 67 20 6d 75 |e TRAT_I|D tag mu|
|000031c0| 73 74 20 62 65 20 74 68 | 65 20 6c 61 73 74 20 6f |st be th|e last o|
|000031d0| 6e 65 20 69 6e 20 74 68 | 65 20 6d 65 6e 75 0a 64 |ne in th|e menu.d|
|000031e0| 65 66 69 6e 69 74 69 6f | 6e 2e 0a 0a 4f 62 6a 65 |efinitio|n...Obje|
|000031f0| 63 74 20 49 44 73 20 61 | 72 65 20 6d 6f 72 65 20 |ct IDs a|re more |
|00003200| 74 68 61 6e 20 50 72 6f | 6a 65 63 74 20 49 44 73 |than Pro|ject IDs|
|00003210| 2e 20 50 72 6f 6a 65 63 | 74 20 49 44 73 20 61 72 |. Projec|t IDs ar|
|00003220| 65 0a 75 73 65 64 20 6f | 6e 6c 79 20 69 6e 74 65 |e.used o|nly inte|
|00003230| 72 6e 61 6c 6c 79 20 62 | 79 20 54 72 69 74 6f 6e |rnally b|y Triton|
|00003240| 2e 20 41 73 20 61 6e 20 | 61 70 70 6c 69 63 61 74 |. As an |applicat|
|00003250| 69 6f 6e 20 70 72 6f 67 | 72 61 6d 6d 65 72 2c 20 |ion prog|rammer, |
|00003260| 79 6f 75 0a 68 61 76 65 | 20 74 6f 20 72 65 66 65 |you.have| to refe|
|00003270| 72 65 6e 63 65 20 50 72 | 6f 6a 65 63 74 73 20 62 |rence Pr|ojects b|
|00003280| 79 20 61 20 70 6f 69 6e | 74 65 72 20 74 6f 20 74 |y a poin|ter to t|
|00003290| 68 65 69 72 20 40 63 6f | 64 65 7b 73 74 72 75 63 |heir @co|de{struc|
|000032a0| 74 20 54 52 5f 50 72 6f | 6a 65 63 74 7d 2e 0a 4f |t TR_Pro|ject}..O|
|000032b0| 62 6a 65 63 74 73 20 69 | 6e 73 74 65 61 64 20 61 |bjects i|nstead a|
|000032c0| 72 65 20 72 65 66 65 72 | 65 6e 63 65 64 20 6f 6e |re refer|enced on|
|000032d0| 6c 79 20 74 68 72 6f 75 | 67 68 0a 6f 62 6a 65 63 |ly throu|gh.objec|
|000032e0| 74 20 49 44 73 2e 20 54 | 68 65 20 73 61 6d 65 20 |t IDs. T|he same |
|000032f0| 69 73 20 74 72 75 65 20 | 66 6f 72 20 6d 65 6e 75 |is true |for menu|
|00003300| 73 2c 20 77 68 69 63 68 | 20 75 73 65 20 6f 72 64 |s, which| use ord|
|00003310| 69 6e 61 72 79 20 6f 62 | 6a 65 63 74 20 49 44 73 |inary ob|ject IDs|
|00003320| 2e 0a 0a 41 20 74 79 70 | 69 63 61 6c 20 6d 65 6e |...A typ|ical men|
|00003330| 75 20 64 65 66 69 6e 74 | 69 6f 6e 20 63 6f 75 6c |u defint|ion coul|
|00003340| 64 20 6c 6f 6f 6b 20 6c | 69 6b 65 20 74 68 69 73 |d look l|ike this|
|00003350| 3a 0a 0a 40 65 78 61 6d | 70 6c 65 0a 20 20 20 20 |:..@exam|ple. |
|00003360| 54 52 5f 4f 70 65 6e 50 | 72 6f 6a 65 63 74 54 61 |TR_OpenP|rojectTa|
|00003370| 67 73 28 2e 2e 2e 0a 20 | 20 20 20 20 20 54 52 4d |gs(.... | TRM|
|00003380| 4e 5f 54 69 74 6c 65 2c | 20 20 20 28 55 4c 4f 4e |N_Title,| (ULON|
|00003390| 47 29 20 22 50 72 6f 6a | 65 63 74 22 2c 0a 20 20 |G) "Proj|ect",. |
|000033a0| 20 20 20 20 20 20 54 52 | 4d 4e 5f 49 74 65 6d 2c | TR|MN_Item,|
|000033b0| 20 20 28 55 4c 4f 4e 47 | 29 20 22 3f 5f 41 62 6f | (ULONG|) "?_Abo|
|000033c0| 75 74 22 2c 20 20 20 20 | 20 20 20 54 52 41 54 5f |ut", | TRAT_|
|000033d0| 49 44 2c 20 31 2c 0a 20 | 20 20 20 20 20 20 20 54 |ID, 1,. | T|
|000033e0| 52 4d 4e 5f 49 74 65 6d | 2c 20 20 28 55 4c 4f 4e |RMN_Item|, (ULON|
|000033f0| 47 29 20 54 52 4d 4e 5f | 42 41 52 4c 41 42 45 4c |G) TRMN_|BARLABEL|
|00003400| 2c 20 20 20 54 52 41 54 | 5f 49 44 2c 20 32 2c 0a |, TRAT|_ID, 2,.|
|00003410| 20 20 20 20 20 20 20 20 | 54 52 4d 4e 5f 49 74 65 | |TRMN_Ite|
|00003420| 6d 2c 20 20 28 55 4c 4f | 4e 47 29 20 22 51 5f 51 |m, (ULO|NG) "Q_Q|
|00003430| 75 69 74 22 2c 20 20 20 | 20 20 20 20 20 54 52 41 |uit", | TRA|
|00003440| 54 5f 49 44 2c 20 33 2c | 0a 20 20 20 20 20 20 2e |T_ID, 3,|. .|
|00003450| 2e 2e 29 3b 0a 40 65 6e | 64 20 65 78 61 6d 70 6c |..);.@en|d exampl|
|00003460| 65 0a 0a 54 68 65 20 74 | 69 74 6c 65 20 6f 66 20 |e..The t|itle of |
|00003470| 61 20 6d 65 6e 75 20 69 | 74 65 6d 20 6f 72 20 73 |a menu i|tem or s|
|00003480| 75 62 2d 69 74 65 6d 20 | 63 61 6e 20 62 65 20 40 |ub-item |can be @|
|00003490| 63 6f 64 65 7b 54 52 4d | 53 5f 42 41 52 4c 41 42 |code{TRM|S_BARLAB|
|000034a0| 45 4c 7d 0a 74 6f 20 69 | 6e 73 65 72 74 20 61 20 |EL}.to i|nsert a |
|000034b0| 73 74 61 6e 64 61 72 64 | 20 73 65 70 61 72 61 74 |standard| separat|
|000034c0| 6f 72 20 62 61 72 2e 20 | 4b 65 79 62 6f 61 72 64 |or bar. |Keyboard|
|000034d0| 20 73 68 6f 72 74 63 75 | 74 73 20 63 61 6e 20 62 | shortcu|ts can b|
|000034e0| 65 0a 73 70 65 63 69 66 | 69 65 64 20 62 79 20 62 |e.specif|ied by b|
|000034f0| 65 67 69 6e 6e 69 6e 67 | 20 74 68 65 20 6d 65 6e |eginning| the men|
|00003500| 75 20 6c 61 62 65 6c 20 | 77 69 74 68 20 74 68 65 |u label |with the|
|00003510| 20 73 68 6f 72 74 63 75 | 74 20 6b 65 79 0a 66 6f | shortcu|t key.fo|
|00003520| 6c 6c 6f 77 65 64 20 62 | 79 20 61 6e 20 75 6e 64 |llowed b|y an und|
|00003530| 65 72 73 63 6f 72 65 20 | 63 68 61 72 61 63 74 65 |erscore |characte|
|00003540| 72 20 61 6e 64 20 74 68 | 65 20 72 65 61 6c 20 6d |r and th|e real m|
|00003550| 65 6e 75 20 6c 61 62 65 | 6c 2e 0a 54 68 65 73 65 |enu labe|l..These|
|00003560| 20 73 69 6d 70 6c 65 20 | 73 68 6f 72 74 63 75 74 | simple |shortcut|
|00003570| 73 20 28 77 69 74 68 20 | 74 68 65 20 72 69 67 68 |s (with |the righ|
|00003580| 74 20 41 6d 69 67 61 20 | 6b 65 79 29 20 61 72 65 |t Amiga |key) are|
|00003590| 20 70 72 6f 63 65 73 73 | 65 64 0a 61 75 74 6f 6d | process|ed.autom|
|000035a0| 61 74 69 63 61 6c 6c 79 | 2e 20 59 6f 75 20 63 61 |atically|. You ca|
|000035b0| 6e 20 63 72 65 61 74 65 | 20 61 20 73 6f 2d 63 61 |n create| a so-ca|
|000035c0| 6c 6c 65 64 20 27 65 78 | 74 65 6e 64 65 64 20 73 |lled 'ex|tended s|
|000035d0| 68 6f 72 74 63 75 74 27 | 0a 62 79 20 73 74 61 72 |hortcut'|.by star|
|000035e0| 74 69 6e 67 20 61 20 6c | 61 62 65 6c 20 77 69 74 |ting a l|abel wit|
|000035f0| 68 20 61 6e 20 75 6e 64 | 65 72 73 63 6f 72 65 20 |h an und|erscore |
|00003600| 63 68 61 72 61 63 74 65 | 72 2c 20 74 68 65 6e 20 |characte|r, then |
|00003610| 74 68 65 0a 74 65 78 74 | 20 66 6f 72 20 74 68 65 |the.text| for the|
|00003620| 20 73 68 6f 72 74 63 75 | 74 2c 20 61 6e 6f 74 68 | shortcu|t, anoth|
|00003630| 65 72 20 75 6e 64 65 72 | 73 63 6f 72 65 20 61 6e |er under|score an|
|00003640| 64 20 74 68 65 20 6d 65 | 6e 75 20 6c 61 62 65 6c |d the me|nu label|
|00003650| 2e 0a 54 68 65 73 65 20 | 65 78 74 65 6e 64 65 64 |..These |extended|
|00003660| 20 73 68 6f 72 74 63 75 | 74 73 20 61 72 65 20 6f | shortcu|ts are o|
|00003670| 6e 6c 79 20 64 69 73 70 | 6c 61 79 65 64 20 77 69 |nly disp|layed wi|
|00003680| 74 68 20 41 6d 69 67 61 | 4f 53 20 33 2e 30 0a 6f |th Amiga|OS 3.0.o|
|00003690| 72 20 68 69 67 68 65 72 | 20 61 6e 64 20 74 68 65 |r higher| and the|
|000036a0| 79 20 61 72 65 20 6e 6f | 74 20 6d 61 6e 61 67 65 |y are no|t manage|
|000036b0| 64 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 2e |d automa|tically.|
|000036c0| 20 59 6f 75 20 68 61 76 | 65 20 74 6f 0a 6c 69 73 | You hav|e to.lis|
|000036d0| 74 65 6e 20 74 6f 20 69 | 6e 63 6f 6d 69 6e 67 20 |ten to i|ncoming |
|000036e0| 6b 65 79 62 6f 61 72 64 | 20 65 76 65 6e 74 73 20 |keyboard| events |
|000036f0| 69 6e 20 6f 72 64 65 72 | 20 74 6f 20 68 61 6e 64 |in order| to hand|
|00003700| 6c 65 0a 74 68 65 73 65 | 20 73 68 6f 72 74 63 75 |le.these| shortcu|
|00003710| 74 73 20 79 6f 75 72 73 | 65 6c 66 2e 0a 0a 53 65 |ts yours|elf...Se|
|00003720| 65 20 74 68 65 20 40 63 | 6f 64 65 7b 4d 65 6e 75 |e the @c|ode{Menu|
|00003730| 73 7d 20 77 69 6e 64 6f | 77 20 6f 66 20 74 68 65 |s} windo|w of the|
|00003740| 20 54 72 69 74 6f 6e 20 | 64 65 6d 6f 20 61 70 70 | Triton |demo app|
|00003750| 6c 69 63 61 74 69 6f 6e | 20 66 6f 72 20 61 0a 6d |lication| for a.m|
|00003760| 6f 72 65 20 64 65 74 61 | 69 6c 65 64 20 65 78 61 |ore deta|iled exa|
|00003770| 6d 70 6c 65 20 6f 6e 20 | 6d 65 6e 75 73 2e 0a 0a |mple on |menus...|
|00003780| 40 6e 6f 64 65 20 54 55 | 54 5f 4f 42 4a 2c 20 54 |@node TU|T_OBJ, T|
|00003790| 55 54 5f 4c 41 59 2c 20 | 54 55 54 5f 4d 45 4e 2c |UT_LAY, |TUT_MEN,|
|000037a0| 20 54 6f 70 0a 40 73 65 | 63 74 69 6f 6e 20 4f 62 | Top.@se|ction Ob|
|000037b0| 6a 65 63 74 73 0a 40 63 | 69 6e 64 65 78 20 4f 62 |jects.@c|index Ob|
|000037c0| 6a 65 63 74 73 0a 0a 54 | 68 65 20 68 65 61 72 74 |jects..T|he heart|
|000037d0| 20 6f 66 20 65 76 65 72 | 79 20 54 72 69 74 6f 6e | of ever|y Triton|
|000037e0| 20 47 55 49 20 69 73 20 | 6f 62 6a 65 63 74 73 2e | GUI is |objects.|
|000037f0| 20 43 75 72 72 65 6e 74 | 6c 79 20 6f 6e 6c 79 20 | Current|ly only |
|00003800| 69 6e 73 74 61 6e 63 65 | 73 0a 6f 66 20 73 75 62 |instance|s.of sub|
|00003810| 63 6c 61 73 73 65 73 20 | 6f 66 20 74 68 65 20 40 |classes |of the @|
|00003820| 63 6f 64 65 7b 44 69 73 | 70 6c 61 79 4f 62 6a 65 |code{Dis|playObje|
|00003830| 63 74 7d 20 63 6c 61 73 | 73 20 63 61 6e 20 62 65 |ct} clas|s can be|
|00003840| 20 63 72 65 61 74 65 64 | 2e 0a 40 78 72 65 66 7b | created|..@xref{|
|00003850| 49 4e 54 5f 43 4c 41 2c | 20 43 6c 61 73 73 20 54 |INT_CLA,| Class T|
|00003860| 72 65 65 2c 20 49 6e 74 | 72 6f 64 75 63 74 69 6f |ree, Int|roductio|
|00003870| 6e 20 2d 20 43 6c 61 73 | 73 20 54 72 65 65 7d 2c |n - Clas|s Tree},|
|00003880| 20 66 6f 72 20 61 20 73 | 68 6f 72 74 20 6c 69 73 | for a s|hort lis|
|00003890| 74 0a 6f 66 20 61 6c 6c | 20 63 6c 61 73 73 65 73 |t.of all| classes|
|000038a0| 2e 20 44 65 74 61 69 6c | 65 64 20 64 65 73 63 72 |. Detail|ed descr|
|000038b0| 69 70 74 69 6f 6e 73 20 | 63 61 6e 20 62 65 20 66 |iptions |can be f|
|000038c0| 6f 75 6e 64 20 69 6e 20 | 74 68 65 20 61 75 74 6f |ound in |the auto|
|000038d0| 64 6f 63 73 2e 0a 0a 4f | 62 6a 65 63 74 73 20 61 |docs...O|bjects a|
|000038e0| 72 65 20 63 72 65 61 74 | 65 64 20 62 79 20 69 6e |re creat|ed by in|
|000038f0| 73 65 72 74 69 6e 67 20 | 61 6e 20 6f 62 6a 65 63 |serting |an objec|
|00003900| 74 20 74 61 67 20 69 6e | 74 6f 20 61 20 70 72 6f |t tag in|to a pro|
|00003910| 6a 65 63 74 20 64 65 66 | 69 6e 69 74 69 6f 6e 2e |ject def|inition.|
|00003920| 0a 46 6f 72 20 65 78 61 | 6d 70 6c 65 2c 20 61 20 |.For exa|mple, a |
|00003930| 63 68 65 63 6b 65 64 20 | 43 68 65 63 6b 42 6f 78 |checked |CheckBox|
|00003940| 20 6f 62 6a 65 63 74 20 | 77 69 74 68 20 61 6e 20 | object |with an |
|00003950| 49 44 20 6f 66 20 39 39 | 20 63 61 6e 20 62 65 20 |ID of 99| can be |
|00003960| 63 72 65 61 74 65 64 0a | 74 68 65 20 66 6f 6c 6c |created.|the foll|
|00003970| 6f 77 69 6e 67 20 77 61 | 79 3a 0a 0a 40 65 78 61 |owing wa|y:..@exa|
|00003980| 6d 70 6c 65 0a 20 20 20 | 20 54 52 4f 42 5f 43 68 |mple. | TROB_Ch|
|00003990| 65 63 6b 42 6f 78 2c 20 | 20 20 4e 55 4c 4c 2c 0a |eckBox, | NULL,.|
|000039a0| 20 20 20 20 20 20 54 52 | 41 54 5f 56 61 6c 75 65 | TR|AT_Value|
|000039b0| 2c 20 20 20 20 28 55 4c | 4f 4e 47 29 20 54 52 55 |, (UL|ONG) TRU|
|000039c0| 45 2c 0a 20 20 20 20 20 | 20 54 52 41 54 5f 49 44 |E,. | TRAT_ID|
|000039d0| 2c 20 20 20 20 20 20 20 | 39 39 2c 0a 40 65 6e 64 |, |99,.@end|
|000039e0| 20 65 78 61 6d 70 6c 65 | 0a 0a 41 6c 6c 20 61 76 | example|..All av|
|000039f0| 61 69 6c 61 62 6c 65 20 | 74 61 67 73 20 61 72 65 |ailable |tags are|
|00003a00| 20 6c 69 73 74 65 64 20 | 69 6e 20 74 68 65 20 61 | listed |in the a|
|00003a10| 75 74 6f 64 6f 63 73 2e | 20 54 68 65 20 40 63 6f |utodocs.| The @co|
|00003a20| 64 65 7b 3c 44 65 66 61 | 75 6c 74 3e 7d 20 74 61 |de{<Defa|ult>} ta|
|00003a30| 67 27 73 0a 76 61 6c 75 | 65 20 68 61 73 20 74 6f |g's.valu|e has to|
|00003a40| 20 62 65 20 69 6e 73 65 | 72 74 65 64 20 64 69 72 | be inse|rted dir|
|00003a50| 65 63 74 6c 79 20 69 6e | 20 74 68 65 20 40 63 6f |ectly in| the @co|
|00003a60| 64 65 7b 54 52 4f 42 5f | 3c 43 6c 61 73 73 3e 7d |de{TROB_|<Class>}|
|00003a70| 20 74 61 67 20 61 73 20 | 69 74 73 0a 64 61 74 61 | tag as |its.data|
|00003a80| 2e 20 41 6c 6c 20 6f 74 | 68 65 72 20 74 61 67 73 |. All ot|her tags|
|00003a90| 20 61 72 65 20 69 6e 73 | 65 72 74 65 64 20 6e 6f | are ins|erted no|
|00003aa0| 72 6d 61 6c 6c 79 20 61 | 66 74 65 72 20 74 68 65 |rmally a|fter the|
|00003ab0| 20 69 6e 69 74 69 61 6c | 20 63 6c 61 73 73 20 74 | initial| class t|
|00003ac0| 61 67 2e 0a 0a 40 63 69 | 6e 64 65 78 20 4e 6f 74 |ag...@ci|ndex Not|
|00003ad0| 69 66 69 63 61 74 69 6f | 6e 0a 40 63 69 6e 64 65 |ificatio|n.@cinde|
|00003ae0| 78 20 4c 69 6e 6b 69 6e | 67 0a 40 73 74 72 6f 6e |x Linkin|g.@stron|
|00003af0| 67 7b 4e 6f 74 65 3a 7d | 20 49 74 20 69 73 20 75 |g{Note:}| It is u|
|00003b00| 73 65 66 75 6c 20 74 6f | 20 40 63 6f 64 65 7b 65 |seful to| @code{e|
|00003b10| 6e 75 6d 7d 65 72 61 74 | 65 20 6f 62 6a 65 63 74 |num}erat|e object|
|00003b20| 20 49 44 73 20 61 73 20 | 77 69 74 68 0a 70 72 6f | IDs as |with.pro|
|00003b30| 6a 65 63 74 20 49 44 73 | 2e 20 42 75 74 20 69 6e |ject IDs|. But in|
|00003b40| 20 63 6f 6e 74 72 61 73 | 74 20 74 6f 20 70 72 6f | contras|t to pro|
|00003b50| 6a 65 63 74 20 49 44 73 | 2c 20 6f 62 6a 65 63 74 |ject IDs|, object|
|00003b60| 20 49 44 73 20 6d 61 79 | 20 62 65 20 75 73 65 64 | IDs may| be used|
|00003b70| 0a 6d 6f 72 65 20 74 68 | 61 6e 20 6f 6e 63 65 2e |.more th|an once.|
|00003b80| 20 49 66 20 79 6f 75 20 | 75 73 65 20 61 6e 20 6f | If you |use an o|
|00003b90| 62 6a 65 63 74 20 49 44 | 20 73 65 76 65 72 61 6c |bject ID| several|
|00003ba0| 20 74 69 6d 65 73 20 77 | 69 74 68 69 6e 20 74 68 | times w|ithin th|
|00003bb0| 65 20 73 61 6d 65 0a 70 | 72 6f 6a 65 63 74 2c 20 |e same.p|roject, |
|00003bc0| 74 68 65 20 6f 62 6a 65 | 63 74 73 20 77 69 74 68 |the obje|cts with|
|00003bd0| 20 74 68 61 74 20 49 44 | 20 77 69 6c 6c 20 62 65 | that ID| will be|
|00003be0| 20 6c 69 6e 6b 65 64 20 | 74 6f 67 65 74 68 65 72 | linked |together|
|00003bf0| 20 61 6e 64 20 77 68 65 | 6e 65 76 65 72 0a 61 6e | and whe|never.an|
|00003c00| 20 61 74 74 72 69 62 75 | 74 65 20 28 6f 6e 6c 79 | attribu|te (only|
|00003c10| 20 73 65 6c 65 63 74 65 | 64 20 61 74 74 72 69 62 | selecte|d attrib|
|00003c20| 75 74 65 73 2c 20 6e 6f | 74 61 62 6c 79 20 40 63 |utes, no|tably @c|
|00003c30| 6f 64 65 7b 54 52 41 54 | 5f 56 61 6c 75 65 7d 21 |ode{TRAT|_Value}!|
|00003c40| 29 20 6f 66 0a 6f 6e 65 | 20 6f 62 6a 65 63 74 20 |) of.one| object |
|00003c50| 63 68 61 6e 67 65 73 2c | 20 74 68 69 73 20 63 68 |changes,| this ch|
|00003c60| 61 6e 67 65 20 77 69 6c | 6c 20 62 65 20 62 72 6f |ange wil|l be bro|
|00003c70| 61 64 63 61 73 74 20 74 | 6f 20 61 6c 6c 20 6f 74 |adcast t|o all ot|
|00003c80| 68 65 72 20 6f 62 6a 65 | 63 74 73 0a 77 69 74 68 |her obje|cts.with|
|00003c90| 20 74 68 61 74 20 49 44 | 20 61 73 20 69 66 20 79 | that ID| as if y|
|00003ca0| 6f 75 20 68 61 64 20 6e | 6f 74 69 66 69 65 64 20 |ou had n|otified |
|00003cb0| 74 68 65 6d 20 79 6f 75 | 72 73 65 6c 66 20 77 69 |them you|rself wi|
|00003cc0| 74 68 0a 40 63 6f 64 65 | 7b 54 52 5f 53 65 74 41 |th.@code|{TR_SetA|
|00003cd0| 74 74 72 69 62 75 74 65 | 28 29 7d 2e 20 54 68 69 |ttribute|()}. Thi|
|00003ce0| 73 20 69 73 20 70 61 72 | 74 69 63 75 6c 61 72 6c |s is par|ticularl|
|00003cf0| 79 20 75 73 65 66 75 6c | 20 74 6f 20 6c 69 6e 6b |y useful| to link|
|00003d00| 20 61 0a 43 68 65 63 6b | 42 6f 78 20 67 61 64 67 | a.Check|Box gadg|
|00003d10| 65 74 20 61 6e 64 20 61 | 20 63 68 65 63 6b 61 62 |et and a| checkab|
|00003d20| 6c 65 20 6d 65 6e 75 20 | 69 74 65 6d 20 74 6f 67 |le menu |item tog|
|00003d30| 65 74 68 65 72 2e 0a 0a | 53 65 65 20 74 68 65 20 |ether...|See the |
|00003d40| 40 63 6f 64 65 7b 43 6f | 6e 6e 65 63 74 69 6f 6e |@code{Co|nnection|
|00003d50| 73 7d 20 77 69 6e 64 6f | 77 20 6f 66 20 74 68 65 |s} windo|w of the|
|00003d60| 20 54 72 69 74 6f 6e 20 | 64 65 6d 6f 20 61 70 70 | Triton |demo app|
|00003d70| 6c 69 63 61 74 69 6f 6e | 20 66 6f 72 20 61 0a 6d |lication| for a.m|
|00003d80| 6f 72 65 20 64 65 74 61 | 69 6c 65 64 20 65 78 61 |ore deta|iled exa|
|00003d90| 6d 70 6c 65 20 6f 6e 20 | 61 74 74 72 69 62 75 74 |mple on |attribut|
|00003da0| 65 20 62 72 6f 61 64 63 | 61 73 74 69 6e 67 2e 0a |e broadc|asting..|
|00003db0| 0a 40 6e 6f 64 65 20 54 | 55 54 5f 4c 41 59 2c 20 |.@node T|UT_LAY, |
|00003dc0| 54 55 54 5f 4d 41 43 2c | 20 54 55 54 5f 4f 42 4a |TUT_MAC,| TUT_OBJ|
|00003dd0| 2c 20 54 6f 70 0a 40 73 | 65 63 74 69 6f 6e 20 4c |, Top.@s|ection L|
|00003de0| 61 79 6f 75 74 0a 40 63 | 69 6e 64 65 78 20 4c 61 |ayout.@c|index La|
|00003df0| 79 6f 75 74 0a 0a 54 72 | 69 74 6f 6e 27 73 20 6c |yout..Tr|iton's l|
|00003e00| 61 79 6f 75 74 20 65 6e | 67 69 6e 65 20 69 73 20 |ayout en|gine is |
|00003e10| 69 6d 70 6c 65 6d 65 6e | 74 65 64 20 74 68 72 6f |implemen|ted thro|
|00003e20| 75 67 68 20 74 68 65 20 | 40 63 6f 64 65 7b 47 72 |ugh the |@code{Gr|
|00003e30| 6f 75 70 7d 0a 63 6c 61 | 73 73 2e 20 40 63 6f 64 |oup}.cla|ss. @cod|
|00003e40| 65 7b 53 70 61 63 65 7d | 20 6f 62 6a 65 63 74 73 |e{Space}| objects|
|00003e50| 20 61 6c 73 6f 20 70 6c | 61 79 20 61 6e 20 69 6d | also pl|ay an im|
|00003e60| 70 6f 72 74 61 6e 74 20 | 72 6f 6c 65 20 62 65 63 |portant |role bec|
|00003e70| 61 75 73 65 20 28 61 70 | 61 72 74 0a 66 72 6f 6d |ause (ap|art.from|
|00003e80| 20 61 20 66 65 77 20 65 | 78 63 65 70 74 69 6f 6e | a few e|xception|
|00003e90| 73 29 20 67 72 6f 75 70 | 73 20 64 6f 6e 27 74 20 |s) group|s don't |
|00003ea0| 63 6f 6e 74 61 69 6e 20 | 61 6e 79 20 27 65 6d 70 |contain |any 'emp|
|00003eb0| 74 79 27 20 73 70 61 63 | 65 2e 20 49 6e 73 74 65 |ty' spac|e. Inste|
|00003ec0| 61 64 0a 74 68 69 73 20 | 73 70 61 63 65 20 69 73 |ad.this |space is|
|00003ed0| 20 63 6f 76 65 72 65 64 | 20 62 79 20 69 6e 73 74 | covered| by inst|
|00003ee0| 61 6e 63 65 73 20 6f 66 | 20 63 6c 61 73 73 20 40 |ances of| class @|
|00003ef0| 63 6f 64 65 7b 53 70 61 | 63 65 7d 2e 20 53 65 65 |code{Spa|ce}. See|
|00003f00| 20 74 68 65 0a 65 78 61 | 6d 70 6c 65 20 62 65 6c | the.exa|mple bel|
|00003f10| 6f 77 20 66 6f 72 20 64 | 65 74 61 69 6c 73 20 61 |ow for d|etails a|
|00003f20| 62 6f 75 74 20 73 70 61 | 63 65 73 2e 0a 0a 40 63 |bout spa|ces...@c|
|00003f30| 6f 64 65 7b 47 72 6f 75 | 70 7d 20 6f 62 6a 65 63 |ode{Grou|p} objec|
|00003f40| 74 73 20 63 61 6e 20 63 | 72 65 61 74 65 20 62 6f |ts can c|reate bo|
|00003f50| 74 68 20 76 65 72 74 69 | 63 61 6c 20 61 6e 64 20 |th verti|cal and |
|00003f60| 68 6f 72 69 7a 6f 6e 74 | 61 6c 20 67 72 6f 75 70 |horizont|al group|
|00003f70| 73 2c 0a 64 65 70 65 6e | 64 69 6e 67 20 6f 6e 20 |s,.depen|ding on |
|00003f80| 77 68 65 74 68 65 72 20 | 74 68 65 79 20 61 72 65 |whether |they are|
|00003f90| 20 63 72 65 61 74 65 64 | 20 77 69 74 68 20 40 63 | created| with @c|
|00003fa0| 6f 64 65 7b 54 52 47 52 | 5f 56 65 72 74 7d 20 6f |ode{TRGR|_Vert} o|
|00003fb0| 72 0a 40 63 6f 64 65 7b | 54 52 47 52 5f 48 6f 72 |r.@code{|TRGR_Hor|
|00003fc0| 69 7a 7d 2e 0a 0a 46 6f | 75 72 20 64 69 66 66 65 |iz}...Fo|ur diffe|
|00003fd0| 72 65 6e 74 20 6c 61 79 | 6f 75 74 20 74 79 70 65 |rent lay|out type|
|00003fe0| 73 20 61 72 65 20 61 76 | 61 69 6c 61 62 6c 65 20 |s are av|ailable |
|00003ff0| 66 6f 72 20 65 61 63 68 | 20 69 6e 73 74 61 6e 63 |for each| instanc|
|00004000| 65 0a 6f 66 20 40 63 6f | 64 65 7b 47 72 6f 75 70 |e.of @co|de{Group|
|00004010| 7d 20 28 61 64 6a 75 73 | 74 61 62 6c 65 20 77 69 |} (adjus|table wi|
|00004020| 74 68 20 74 68 65 20 67 | 72 6f 75 70 20 66 6c 61 |th the g|roup fla|
|00004030| 67 73 29 2e 20 54 68 65 | 79 20 61 66 66 65 63 74 |gs). The|y affect|
|00004040| 0a 74 68 65 20 70 72 69 | 6d 61 72 79 20 64 69 72 |.the pri|mary dir|
|00004050| 65 63 74 69 6f 6e 20 6f | 6e 6c 79 3a 0a 0a 40 65 |ection o|nly:..@e|
|00004060| 6e 75 6d 65 72 61 74 65 | 0a 40 69 74 65 6d 0a 40 |numerate|.@item.@|
|00004070| 63 6f 64 65 7b 54 52 47 | 52 5f 50 52 4f 50 53 48 |code{TRG|R_PROPSH|
|00004080| 41 52 45 7d 3a 20 45 78 | 70 61 6e 64 73 20 61 6c |ARE}: Ex|pands al|
|00004090| 6c 20 6f 62 6a 65 63 74 | 73 20 70 72 6f 70 6f 72 |l object|s propor|
|000040a0| 74 69 6f 6e 61 6c 6c 79 | 20 74 6f 20 74 68 65 69 |tionally| to thei|
|000040b0| 72 0a 6d 69 6e 69 6d 75 | 6d 20 73 69 7a 65 2e 20 |r.minimu|m size. |
|000040c0| 41 6c 6c 20 73 70 61 63 | 65 73 20 72 65 74 61 69 |All spac|es retai|
|000040d0| 6e 20 74 68 65 69 72 20 | 6d 69 6e 69 6d 75 6d 20 |n their |minimum |
|000040e0| 73 69 7a 65 20 61 6e 64 | 20 61 72 65 20 6e 6f 74 |size and| are not|
|000040f0| 20 72 65 73 69 7a 61 62 | 6c 65 2e 0a 4e 6f 6e 2d | resizab|le..Non-|
|00004100| 72 65 73 69 7a 61 62 6c | 65 20 6e 6f 6e 2d 73 70 |resizabl|e non-sp|
|00004110| 61 63 65 20 6f 62 6a 65 | 63 74 73 20 64 6f 20 61 |ace obje|cts do a|
|00004120| 6c 73 6f 20 72 65 74 61 | 69 6e 20 74 68 65 69 72 |lso reta|in their|
|00004130| 20 6d 69 6e 69 6d 75 6d | 20 73 69 7a 65 73 0a 28 | minimum| sizes.(|
|00004140| 77 65 6c 6c 2c 20 74 68 | 65 79 20 64 6f 6e 27 74 |well, th|ey don't|
|00004150| 20 72 65 61 6c 6c 79 20 | 68 61 76 65 20 61 20 63 | really |have a c|
|00004160| 68 6f 69 63 65 2c 20 64 | 6f 20 74 68 65 79 3f 20 |hoice, d|o they? |
|00004170| 3b 29 2e 0a 40 69 74 65 | 6d 0a 40 63 6f 64 65 7b |;)..@ite|m.@code{|
|00004180| 54 52 47 52 5f 45 51 55 | 41 4c 53 48 41 52 45 7d |TRGR_EQU|ALSHARE}|
|00004190| 3a 20 53 61 6d 65 20 61 | 73 20 40 63 6f 64 65 7b |: Same a|s @code{|
|000041a0| 54 52 47 52 5f 50 52 4f | 50 53 48 41 52 45 7d 20 |TRGR_PRO|PSHARE} |
|000041b0| 65 78 63 65 70 74 20 74 | 68 61 74 20 61 6c 6c 20 |except t|hat all |
|000041c0| 6e 6f 6e 2d 73 70 61 63 | 65 0a 6f 62 6a 65 63 74 |non-spac|e.object|
|000041d0| 73 20 68 61 76 65 20 74 | 68 65 20 73 61 6d 65 20 |s have t|he same |
|000041e0| 73 69 7a 65 2e 20 54 68 | 65 69 72 20 6d 69 6e 69 |size. Th|eir mini|
|000041f0| 6d 75 6d 20 73 69 7a 65 | 20 65 71 75 61 6c 73 20 |mum size| equals |
|00004200| 74 68 65 20 62 69 67 67 | 65 73 74 20 6d 69 6e 69 |the bigg|est mini|
|00004210| 6d 75 6d 20 73 69 7a 65 | 0a 6f 66 20 74 68 65 20 |mum size|.of the |
|00004220| 69 6e 64 69 76 69 64 75 | 61 6c 20 6f 62 6a 65 63 |individu|al objec|
|00004230| 74 73 2e 0a 40 69 74 65 | 6d 0a 40 63 6f 64 65 7b |ts..@ite|m.@code{|
|00004240| 54 52 47 52 5f 50 52 4f | 50 53 50 41 43 45 53 7d |TRGR_PRO|PSPACES}|
|00004250| 3a 20 41 6c 6c 20 6e 6f | 6e 2d 73 70 61 63 65 20 |: All no|n-space |
|00004260| 6f 62 6a 65 63 74 73 20 | 72 65 74 61 69 6e 20 74 |objects |retain t|
|00004270| 68 65 69 72 20 6d 69 6e | 69 6d 75 6d 20 73 69 7a |heir min|imum siz|
|00004280| 65 73 20 61 6c 6c 0a 74 | 68 65 20 74 69 6d 65 20 |es all.t|he time |
|00004290| 61 6e 64 20 64 6f 20 6e | 6f 74 20 67 65 74 20 73 |and do n|ot get s|
|000042a0| 74 72 65 74 63 68 65 64 | 2e 20 49 6e 73 74 65 61 |tretched|. Instea|
|000042b0| 64 20 74 68 65 20 73 70 | 61 63 65 73 20 61 72 65 |d the sp|aces are|
|000042c0| 20 73 74 72 65 74 63 68 | 65 64 0a 70 72 6f 70 6f | stretch|ed.propo|
|000042d0| 72 74 69 6f 6e 61 6c 6c | 79 20 74 6f 20 74 68 65 |rtionall|y to the|
|000042e0| 69 72 20 6d 69 6e 69 6d | 75 6d 20 73 69 7a 65 73 |ir minim|um sizes|
|000042f0| 2e 0a 40 69 74 65 6d 0a | 40 63 6f 64 65 7b 54 52 |..@item.|@code{TR|
|00004300| 47 52 5f 41 52 52 41 59 | 7d 3a 20 54 68 69 73 20 |GR_ARRAY|}: This |
|00004310| 67 72 6f 75 70 20 62 75 | 69 6c 64 73 20 74 68 65 |group bu|ilds the|
|00004320| 20 74 6f 70 20 67 72 6f | 75 70 20 6f 66 20 61 6e | top gro|up of an|
|00004330| 20 61 72 72 61 79 2e 20 | 49 6e 20 6f 72 64 65 72 | array. |In order|
|00004340| 0a 74 6f 20 63 72 65 61 | 74 65 20 61 6e 20 61 72 |.to crea|te an ar|
|00004350| 72 61 79 2c 20 79 6f 75 | 20 68 61 76 65 20 74 6f |ray, you| have to|
|00004360| 20 73 65 74 20 75 70 20 | 61 6e 20 6f 75 74 65 72 | set up |an outer|
|00004370| 20 40 63 6f 64 65 7b 54 | 52 47 52 5f 41 52 52 41 | @code{T|RGR_ARRA|
|00004380| 59 7d 20 67 72 6f 75 70 | 0a 28 68 6f 72 69 7a 6f |Y} group|.(horizo|
|00004390| 6e 74 61 6c 20 66 6f 72 | 20 61 20 63 6f 6c 75 6d |ntal for| a colum|
|000043a0| 6e 20 61 72 72 61 79 2c | 20 76 65 72 74 69 63 61 |n array,| vertica|
|000043b0| 6c 20 66 6f 72 20 61 20 | 6c 69 6e 65 20 61 72 72 |l for a |line arr|
|000043c0| 61 79 29 20 61 6e 64 20 | 66 69 6c 6c 20 69 74 0a |ay) and |fill it.|
|000043d0| 77 69 74 68 20 73 69 6e | 67 6c 65 20 6f 62 6a 65 |with sin|gle obje|
|000043e0| 63 74 73 20 28 6e 6f 74 | 61 62 6c 79 20 73 70 61 |cts (not|ably spa|
|000043f0| 63 65 73 29 20 6f 72 20 | 40 63 6f 64 65 7b 54 52 |ces) or |@code{TR|
|00004400| 47 52 5f 50 52 4f 50 53 | 48 41 52 45 7d 20 67 72 |GR_PROPS|HARE} gr|
|00004410| 6f 75 70 73 20 69 6e 0a | 74 68 65 20 6f 70 70 6f |oups in.|the oppo|
|00004420| 73 69 74 65 20 64 69 72 | 65 63 74 69 6f 6e 2e 20 |site dir|ection. |
|00004430| 41 6c 6c 20 65 6c 65 6d | 65 6e 74 73 20 6f 66 20 |All elem|ents of |
|00004440| 74 68 65 20 69 6e 6e 65 | 72 20 67 72 6f 75 70 73 |the inne|r groups|
|00004450| 20 77 69 6c 6c 20 62 65 | 20 61 6c 69 67 6e 65 64 | will be| aligned|
|00004460| 0a 74 6f 20 62 75 69 6c | 64 20 61 6e 20 61 72 72 |.to buil|d an arr|
|00004470| 61 79 2e 20 49 6e 6e 65 | 72 20 67 72 6f 75 70 73 |ay. Inne|r groups|
|00004480| 20 77 68 69 63 68 20 68 | 61 76 65 20 74 68 65 20 | which h|ave the |
|00004490| 66 6c 61 67 20 40 63 6f | 64 65 7b 54 52 47 52 5f |flag @co|de{TRGR_|
|000044a0| 49 4e 44 45 50 7d 20 73 | 65 74 0a 77 69 6c 6c 20 |INDEP} s|et.will |
|000044b0| 6e 6f 74 20 62 65 20 61 | 6c 69 67 6e 65 64 2e 20 |not be a|ligned. |
|000044c0| 54 68 69 73 20 66 6c 61 | 67 20 69 73 20 6d 61 69 |This fla|g is mai|
|000044d0| 6e 6c 79 20 75 73 65 64 | 20 74 6f 20 69 6e 73 65 |nly used| to inse|
|000044e0| 72 74 20 6e 61 6d 65 64 | 20 73 65 70 61 72 61 74 |rt named| separat|
|000044f0| 6f 72 20 62 61 72 73 0a | 28 63 72 65 61 74 65 64 |or bars.|(created|
|00004500| 20 77 69 74 68 20 40 63 | 6f 64 65 7b 54 52 4f 42 | with @c|ode{TROB|
|00004510| 5f 4c 69 6e 65 7d 20 61 | 6e 64 20 40 63 6f 64 65 |_Line} a|nd @code|
|00004520| 7b 54 52 4f 42 5f 54 65 | 78 74 7d 29 20 69 6e 74 |{TROB_Te|xt}) int|
|00004530| 6f 20 61 6e 20 61 72 72 | 61 79 2e 0a 40 65 6e 64 |o an arr|ay..@end|
|00004540| 20 65 6e 75 6d 65 72 61 | 74 65 0a 0a 43 75 72 72 | enumera|te..Curr|
|00004550| 65 6e 74 6c 79 20 74 68 | 65 20 6f 6e 6c 79 20 6f |ently th|e only o|
|00004560| 62 6a 65 63 74 73 20 77 | 68 69 63 68 20 61 72 65 |bjects w|hich are|
|00004570| 20 74 72 65 61 74 65 64 | 20 61 73 20 73 70 61 63 | treated| as spac|
|00004580| 65 73 20 69 6e 20 74 68 | 65 20 61 62 6f 76 65 20 |es in th|e above |
|00004590| 73 63 68 65 6d 65 0a 61 | 72 65 20 69 6e 73 74 61 |scheme.a|re insta|
|000045a0| 6e 63 65 73 20 6f 66 20 | 63 6c 61 73 73 20 40 63 |nces of |class @c|
|000045b0| 6f 64 65 7b 53 70 61 63 | 65 7d 2e 0a 0a 54 68 65 |ode{Spac|e}...The|
|000045c0| 20 62 65 68 61 76 69 6f | 75 72 20 6f 66 20 74 68 | behavio|ur of th|
|000045d0| 65 20 67 72 6f 75 70 20 | 69 6e 20 69 74 73 20 73 |e group |in its s|
|000045e0| 65 63 6f 6e 64 61 72 79 | 20 64 69 72 65 63 74 69 |econdary| directi|
|000045f0| 6f 6e 20 63 61 6e 20 62 | 65 20 63 68 61 6e 67 65 |on can b|e change|
|00004600| 64 2c 20 74 6f 6f 2e 0a | 54 77 6f 20 61 64 64 69 |d, too..|Two addi|
|00004610| 74 69 6f 6e 61 6c 20 66 | 6c 61 67 73 20 61 72 65 |tional f|lags are|
|00004620| 20 61 76 61 69 6c 61 62 | 6c 65 20 66 6f 72 20 74 | availab|le for t|
|00004630| 68 61 74 20 70 75 72 70 | 6f 73 65 2e 20 49 6e 20 |hat purp|ose. In |
|00004640| 6d 6f 73 74 20 63 61 73 | 65 73 20 79 6f 75 20 6d |most cas|es you m|
|00004650| 61 79 0a 77 61 6e 74 20 | 74 6f 20 73 65 74 20 62 |ay.want |to set b|
|00004660| 6f 74 68 20 6f 66 20 74 | 68 65 6d 3a 0a 0a 40 65 |oth of t|hem:..@e|
|00004670| 6e 75 6d 65 72 61 74 65 | 0a 40 69 74 65 6d 0a 40 |numerate|.@item.@|
|00004680| 63 6f 64 65 7b 54 52 47 | 52 5f 41 4c 49 47 4e 7d |code{TRG|R_ALIGN}|
|00004690| 3a 20 41 6c 6c 20 72 65 | 73 69 7a 61 62 6c 65 20 |: All re|sizable |
|000046a0| 6f 62 6a 65 63 74 73 20 | 28 69 2e 65 2e 20 72 65 |objects |(i.e. re|
|000046b0| 73 69 7a 61 62 6c 65 20 | 69 6e 20 74 68 65 20 73 |sizable |in the s|
|000046c0| 65 63 6f 6e 64 61 72 79 | 0a 64 69 6d 65 6e 73 69 |econdary|.dimensi|
|000046d0| 6f 6e 20 6f 66 20 74 68 | 65 20 67 72 6f 75 70 29 |on of th|e group)|
|000046e0| 20 61 72 65 20 73 74 72 | 65 63 68 74 65 64 20 74 | are str|echted t|
|000046f0| 6f 20 66 69 74 20 74 68 | 65 20 66 75 6c 6c 20 73 |o fit th|e full s|
|00004700| 70 61 63 65 20 6f 63 63 | 75 70 69 65 64 20 62 79 |pace occ|upied by|
|00004710| 0a 74 68 65 20 67 72 6f | 75 70 2e 0a 40 69 74 65 |.the gro|up..@ite|
|00004720| 6d 0a 40 63 6f 64 65 7b | 54 52 47 52 5f 43 45 4e |m.@code{|TRGR_CEN|
|00004730| 54 45 52 7d 3a 20 41 6c | 6c 20 6e 6f 6e 2d 72 65 |TER}: Al|l non-re|
|00004740| 73 69 7a 61 62 6c 65 20 | 6f 62 6a 65 63 74 73 20 |sizable |objects |
|00004750| 61 72 65 20 63 65 6e 74 | 65 72 65 64 20 69 6e 20 |are cent|ered in |
|00004760| 74 68 65 20 67 72 6f 75 | 70 2e 0a 57 69 74 68 6f |the grou|p..Witho|
|00004770| 75 74 20 74 68 69 73 20 | 66 6c 61 67 20 74 68 65 |ut this |flag the|
|00004780| 79 20 67 65 74 20 61 6c | 69 67 6e 65 64 20 74 6f |y get al|igned to|
|00004790| 20 74 68 65 20 6c 65 66 | 74 20 6f 72 20 74 6f 70 | the lef|t or top|
|000047a0| 20 62 6f 72 64 65 72 2e | 0a 40 65 6e 64 20 65 6e | border.|.@end en|
|000047b0| 75 6d 65 72 61 74 65 0a | 0a 49 74 20 69 73 20 61 |umerate.|.It is a|
|000047c0| 6c 73 6f 20 70 6f 73 73 | 69 62 6c 65 20 74 6f 20 |lso poss|ible to |
|000047d0| 6b 65 65 70 20 61 20 67 | 72 6f 75 70 20 61 74 20 |keep a g|roup at |
|000047e0| 69 74 73 20 6d 69 6e 69 | 6d 75 6d 20 73 69 7a 65 |its mini|mum size|
|000047f0| 20 61 6e 64 20 6e 6f 77 | 20 61 6c 6c 6f 77 0a 69 | and now| allow.i|
|00004800| 74 20 74 6f 20 62 65 20 | 73 74 72 65 74 63 68 65 |t to be |stretche|
|00004810| 64 20 69 6e 20 65 69 74 | 68 65 72 20 6f 72 20 62 |d in eit|her or b|
|00004820| 6f 74 68 20 64 69 72 65 | 63 74 69 6f 6e 73 2e 20 |oth dire|ctions. |
|00004830| 54 68 69 73 20 63 61 6e | 20 62 65 20 61 63 63 6f |This can| be acco|
|00004840| 6d 70 6c 69 73 68 65 64 | 0a 77 69 74 68 20 74 68 |mplished|.with th|
|00004850| 65 20 40 63 6f 64 65 7b | 54 52 47 52 5f 46 49 58 |e @code{|TRGR_FIX|
|00004860| 48 4f 52 49 5a 7d 20 61 | 6e 64 20 40 63 6f 64 65 |HORIZ} a|nd @code|
|00004870| 7b 54 52 47 52 5f 46 49 | 58 56 45 52 54 7d 20 66 |{TRGR_FI|XVERT} f|
|00004880| 6c 61 67 73 2e 0a 0a 41 | 20 67 72 6f 75 70 20 63 |lags...A| group c|
|00004890| 61 6e 20 62 65 20 63 72 | 65 61 74 65 64 20 6c 69 |an be cr|eated li|
|000048a0| 6b 65 20 61 6e 79 20 6f | 74 68 65 72 20 6f 62 6a |ke any o|ther obj|
|000048b0| 65 63 74 2e 20 49 74 20 | 74 61 6b 65 73 20 6f 74 |ect. It |takes ot|
|000048c0| 68 65 72 20 6f 62 6a 65 | 63 74 73 0a 61 73 20 69 |her obje|cts.as i|
|000048d0| 74 73 20 61 72 67 75 6d | 65 6e 74 73 2e 20 45 76 |ts argum|ents. Ev|
|000048e0| 65 72 79 20 67 72 6f 75 | 70 20 68 61 73 20 74 6f |ery grou|p has to|
|000048f0| 20 62 65 20 74 65 72 6d | 69 6e 61 74 65 64 20 77 | be term|inated w|
|00004900| 69 74 68 20 61 20 40 63 | 6f 64 65 7b 54 52 47 52 |ith a @c|ode{TRGR|
|00004910| 5f 45 6e 64 7d 0a 74 61 | 67 2e 20 41 20 74 79 70 |_End}.ta|g. A typ|
|00004920| 69 63 61 6c 20 68 6f 72 | 69 7a 6f 6e 74 61 6c 20 |ical hor|izontal |
|00004930| 67 72 6f 75 70 2c 20 77 | 68 69 63 68 20 63 6f 6e |group, w|hich con|
|00004940| 74 61 69 6e 73 20 61 20 | 43 68 65 63 6b 42 6f 78 |tains a |CheckBox|
|00004950| 2c 20 61 20 73 70 61 63 | 65 20 61 6e 64 0a 61 67 |, a spac|e and.ag|
|00004960| 61 69 6e 20 61 20 43 68 | 65 63 6b 42 6f 78 2c 20 |ain a Ch|eckBox, |
|00004970| 77 6f 75 6c 64 20 6c 6f | 6f 6b 20 6c 69 6b 65 20 |would lo|ok like |
|00004980| 74 68 69 73 3a 0a 0a 40 | 65 78 61 6d 70 6c 65 0a |this:..@|example.|
|00004990| 20 20 20 20 54 52 47 52 | 5f 48 6f 72 69 7a 2c 20 | TRGR|_Horiz, |
|000049a0| 20 20 20 20 20 54 52 47 | 52 5f 50 52 4f 50 53 48 | TRG|R_PROPSH|
|000049b0| 41 52 45 7c 54 52 47 52 | 5f 41 4c 49 47 4e 7c 54 |ARE|TRGR|_ALIGN|T|
|000049c0| 52 47 52 5f 43 45 4e 54 | 45 52 2c 0a 0a 20 20 20 |RGR_CENT|ER,.. |
|000049d0| 20 20 20 54 52 4f 42 5f | 43 68 65 63 6b 42 6f 78 | TROB_|CheckBox|
|000049e0| 2c 20 30 2c 0a 20 20 20 | 20 20 20 20 20 54 52 41 |, 0,. | TRA|
|000049f0| 54 5f 49 44 2c 20 20 20 | 20 20 31 2c 0a 0a 20 20 |T_ID, | 1,.. |
|00004a00| 20 20 20 20 54 52 4f 42 | 5f 53 70 61 63 65 2c 20 | TROB|_Space, |
|00004a10| 20 20 20 54 52 53 54 5f | 4e 4f 52 4d 41 4c 2c 0a | TRST_|NORMAL,.|
|00004a20| 0a 20 20 20 20 20 20 54 | 52 4f 42 5f 43 68 65 63 |. T|ROB_Chec|
|00004a30| 6b 42 6f 78 2c 20 30 2c | 0a 20 20 20 20 20 20 20 |kBox, 0,|. |
|00004a40| 20 54 52 41 54 5f 56 61 | 6c 75 65 2c 20 20 54 52 | TRAT_Va|lue, TR|
|00004a50| 55 45 2c 0a 20 20 20 20 | 20 20 20 20 54 52 41 54 |UE,. | TRAT|
|00004a60| 5f 49 44 2c 20 20 20 20 | 20 32 2c 0a 0a 20 20 20 |_ID, | 2,.. |
|00004a70| 20 20 20 54 52 47 52 5f | 45 6e 64 2c 20 20 20 20 | TRGR_|End, |
|00004a80| 20 20 30 0a 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 | 0.@end| example|
|00004a90| 0a 0a 53 65 65 20 74 68 | 65 20 40 63 6f 64 65 7b |..See th|e @code{|
|00004aa0| 47 72 6f 75 70 73 7d 20 | 77 69 6e 64 6f 77 20 6f |Groups} |window o|
|00004ab0| 66 20 74 68 65 20 54 72 | 69 74 6f 6e 20 64 65 6d |f the Tr|iton dem|
|00004ac0| 6f 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 66 6f |o applic|ation fo|
|00004ad0| 72 20 61 0a 6d 6f 72 65 | 20 64 65 74 61 69 6c 65 |r a.more| detaile|
|00004ae0| 64 20 65 78 61 6d 70 6c | 65 20 6f 6e 20 67 72 6f |d exampl|e on gro|
|00004af0| 75 70 73 20 61 6e 64 20 | 61 72 72 61 79 73 2e 0a |ups and |arrays..|
|00004b00| 0a 40 6e 6f 64 65 20 54 | 55 54 5f 4d 41 43 2c 20 |.@node T|UT_MAC, |
|00004b10| 54 55 54 5f 50 4f 4c 2c | 20 54 55 54 5f 4c 41 59 |TUT_POL,| TUT_LAY|
|00004b20| 2c 20 54 6f 70 0a 40 73 | 65 63 74 69 6f 6e 20 4d |, Top.@s|ection M|
|00004b30| 61 63 72 6f 73 0a 40 63 | 69 6e 64 65 78 20 4d 61 |acros.@c|index Ma|
|00004b40| 63 72 6f 73 0a 0a 54 68 | 65 20 43 20 68 65 61 64 |cros..Th|e C head|
|00004b50| 65 72 20 66 69 6c 65 20 | 40 66 69 6c 65 7b 44 65 |er file |@file{De|
|00004b60| 76 65 6c 6f 70 65 72 2f | 49 6e 63 6c 75 64 65 2f |veloper/|Include/|
|00004b70| 6c 69 62 72 61 72 69 65 | 73 2f 74 72 69 74 6f 6e |librarie|s/triton|
|00004b80| 2e 68 7d 20 63 6f 6e 74 | 61 69 6e 73 0a 6d 61 6e |.h} cont|ains.man|
|00004b90| 79 20 6d 61 63 72 6f 20 | 64 65 66 69 6e 69 74 69 |y macro |definiti|
|00004ba0| 6f 6e 73 20 77 68 69 63 | 68 20 6d 61 6b 65 20 63 |ons whic|h make c|
|00004bb0| 72 65 61 74 69 6e 67 20 | 61 20 54 72 69 74 6f 6e |reating |a Triton|
|00004bc0| 20 47 55 49 20 6d 75 63 | 68 0a 65 61 73 69 65 72 | GUI muc|h.easier|
|00004bd0| 2e 20 57 69 74 68 20 74 | 68 65 20 68 65 6c 70 20 |. With t|he help |
|00004be0| 6f 66 20 74 68 65 20 70 | 72 65 70 72 6f 63 65 73 |of the p|reproces|
|00004bf0| 73 6f 72 20 40 63 6f 64 | 65 7b 4d 61 63 32 45 7d |sor @cod|e{Mac2E}|
|00004c00| 2c 20 74 68 65 73 65 20 | 6d 61 63 72 6f 73 0a 61 |, these |macros.a|
|00004c10| 72 65 20 61 6c 73 6f 20 | 61 76 61 69 6c 61 62 6c |re also |availabl|
|00004c20| 65 20 69 6e 20 40 63 6f | 64 65 7b 41 6d 69 67 61 |e in @co|de{Amiga|
|00004c30| 45 7d 2e 20 4f 74 68 65 | 72 20 6c 61 6e 67 75 61 |E}. Othe|r langua|
|00004c40| 67 65 73 20 6f 72 20 63 | 6f 6d 70 69 6c 65 72 73 |ges or c|ompilers|
|00004c50| 20 6d 61 79 0a 73 75 70 | 70 6f 72 74 20 73 69 6d | may.sup|port sim|
|00004c60| 69 6c 61 72 20 6f 72 20 | 64 69 66 66 65 72 65 6e |ilar or |differen|
|00004c70| 74 20 6d 61 63 72 6f 73 | 20 6f 72 20 6e 6f 6e 65 |t macros| or none|
|00004c80| 20 61 74 20 61 6c 6c 2e | 20 49 66 20 6e 6f 20 6d | at all.| If no m|
|00004c90| 61 63 72 6f 73 20 61 72 | 65 0a 61 76 61 69 6c 61 |acros ar|e.availa|
|00004ca0| 62 6c 65 20 69 6e 20 79 | 6f 75 72 20 64 65 76 65 |ble in y|our deve|
|00004cb0| 6c 6f 70 6d 65 6e 74 20 | 73 79 73 74 65 6d 2c 20 |lopment |system, |
|00004cc0| 79 6f 75 20 68 61 76 65 | 20 74 6f 20 64 6f 20 69 |you have| to do i|
|00004cd0| 74 20 74 68 65 20 74 72 | 61 64 69 74 69 6f 6e 61 |t the tr|aditiona|
|00004ce0| 6c 0a 77 61 79 2e 20 49 | 66 20 79 6f 75 20 63 61 |l.way. I|f you ca|
|00004cf0| 6e 20 75 73 65 20 6d 61 | 63 72 6f 73 2c 20 75 73 |n use ma|cros, us|
|00004d00| 65 20 74 68 65 6d 2e 0a | 0a 54 68 65 20 73 74 61 |e them..|.The sta|
|00004d10| 74 69 63 20 74 61 67 6c | 69 73 74 20 64 65 66 69 |tic tagl|ist defi|
|00004d20| 6e 69 74 69 6f 6e 20 63 | 61 6e 20 62 65 20 77 72 |nition c|an be wr|
|00004d30| 69 74 74 65 6e 20 61 20 | 62 69 74 20 73 69 6d 70 |itten a |bit simp|
|00004d40| 6c 65 72 20 77 69 74 68 | 20 6d 61 63 72 6f 73 3a |ler with| macros:|
|00004d50| 0a 0a 40 65 78 61 6d 70 | 6c 65 0a 20 20 20 20 50 |..@examp|le. P|
|00004d60| 72 6f 6a 65 63 74 44 65 | 66 69 6e 69 74 69 6f 6e |rojectDe|finition|
|00004d70| 28 64 75 6d 6d 79 54 61 | 67 73 29 0a 20 20 20 20 |(dummyTa|gs). |
|00004d80| 40 7b 0a 20 20 20 20 20 | 20 2f 2a 20 49 6e 73 65 |@{. | /* Inse|
|00004d90| 72 74 20 70 72 6f 6a 65 | 63 74 20 74 61 67 73 20 |rt proje|ct tags |
|00004da0| 68 65 72 65 20 2a 2f 0a | 20 20 20 20 40 7d 3b 0a |here */.| @};.|
|00004db0| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 0a 42 75 |@end exa|mple..Bu|
|00004dc0| 74 20 74 68 65 20 6d 61 | 69 6e 20 75 73 65 20 66 |t the ma|in use f|
|00004dd0| 6f 72 20 6d 61 63 72 6f | 73 20 61 72 65 20 74 68 |or macro|s are th|
|00004de0| 65 20 74 61 67 73 20 74 | 68 65 6d 73 65 6c 76 65 |e tags t|hemselve|
|00004df0| 73 2e 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |s. For e|xample, |
|00004e00| 74 68 65 20 74 61 67 73 | 0a 66 72 6f 6d 20 74 68 |the tags|.from th|
|00004e10| 65 20 64 75 6d 6d 79 20 | 77 69 6e 64 6f 77 20 65 |e dummy |window e|
|00004e20| 78 61 6d 70 6c 65 20 28 | 73 65 65 20 40 72 65 66 |xample (|see @ref|
|00004e30| 7b 54 55 54 5f 50 52 4f | 2c 20 50 72 6f 6a 65 63 |{TUT_PRO|, Projec|
|00004e40| 74 73 2c 20 54 75 74 6f | 72 69 61 6c 20 2d 20 50 |ts, Tuto|rial - P|
|00004e50| 72 6f 6a 65 63 74 73 7d | 29 0a 77 6f 75 6c 64 20 |rojects}|).would |
|00004e60| 6c 6f 6f 6b 20 6c 69 6b | 65 20 74 68 69 73 3a 0a |look lik|e this:.|
|00004e70| 0a 40 65 78 61 6d 70 6c | 65 0a 20 20 20 20 20 20 |.@exampl|e. |
|00004e80| 57 69 6e 64 6f 77 54 69 | 74 6c 65 28 22 41 20 64 |WindowTi|tle("A d|
|00004e90| 75 6d 6d 79 20 77 69 6e | 64 6f 77 22 29 2c 0a 20 |ummy win|dow"),. |
|00004ea0| 20 20 20 20 20 57 69 6e | 64 6f 77 49 44 28 34 32 | Win|dowID(42|
|00004eb0| 29 2c 0a 20 20 20 20 20 | 20 45 6e 64 50 72 6f 6a |),. | EndProj|
|00004ec0| 65 63 74 0a 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |ect.@end| example|
|00004ed0| 0a 0a 48 61 76 65 20 61 | 20 6c 6f 6f 6b 20 61 74 |..Have a| look at|
|00004ee0| 20 74 68 65 20 6d 61 63 | 72 6f 20 64 65 66 69 6e | the mac|ro defin|
|00004ef0| 69 74 69 6f 6e 73 20 61 | 6e 64 20 74 68 65 20 73 |itions a|nd the s|
|00004f00| 75 70 70 6c 69 65 64 20 | 64 65 6d 6f 20 61 70 70 |upplied |demo app|
|00004f10| 6c 69 63 61 74 69 6f 6e | 73 0a 66 6f 72 20 6d 6f |lication|s.for mo|
|00004f20| 72 65 20 64 65 74 61 69 | 6c 65 64 20 69 6e 66 6f |re detai|led info|
|00004f30| 72 6d 61 74 69 6f 6e 20 | 61 62 6f 75 74 20 74 68 |rmation |about th|
|00004f40| 65 20 6d 61 63 72 6f 73 | 2e 0a 0a 40 6e 6f 64 65 |e macros|...@node|
|00004f50| 20 54 55 54 5f 50 4f 4c | 2c 20 54 55 54 5f 4d 45 | TUT_POL|, TUT_ME|
|00004f60| 53 2c 20 54 55 54 5f 4d | 41 43 2c 20 54 6f 70 0a |S, TUT_M|AC, Top.|
|00004f70| 40 73 65 63 74 69 6f 6e | 20 50 6f 6c 6c 69 6e 67 |@section| Polling|
|00004f80| 20 4c 6f 6f 70 0a 40 63 | 69 6e 64 65 78 20 50 6f | Loop.@c|index Po|
|00004f90| 6c 6c 69 6e 67 20 4c 6f | 6f 70 0a 40 63 69 6e 64 |lling Lo|op.@cind|
|00004fa0| 65 78 20 4c 6f 6f 70 2c | 20 50 6f 6c 6c 69 6e 67 |ex Loop,| Polling|
|00004fb0| 0a 0a 41 66 74 65 72 20 | 63 72 65 61 74 69 6e 67 |..After |creating|
|00004fc0| 20 61 20 47 55 49 20 79 | 6f 75 20 68 61 76 65 20 | a GUI y|ou have |
|00004fd0| 74 6f 20 68 61 6e 64 6c | 65 20 75 73 65 72 20 69 |to handl|e user i|
|00004fe0| 6e 70 75 74 2e 20 49 6e | 20 6f 72 64 65 72 20 74 |nput. In| order t|
|00004ff0| 6f 20 61 63 63 6f 6d 70 | 6c 69 73 68 0a 74 68 69 |o accomp|lish.thi|
|00005000| 73 20 74 61 73 6b 2c 20 | 54 72 69 74 6f 6e 20 6f |s task, |Triton o|
|00005010| 66 66 65 72 73 20 61 20 | 70 6f 6c 6c 69 6e 67 20 |ffers a |polling |
|00005020| 73 79 73 74 65 6d 20 77 | 68 69 63 68 20 72 65 73 |system w|hich res|
|00005030| 65 6d 62 6c 65 73 20 74 | 68 65 20 49 6e 74 75 69 |embles t|he Intui|
|00005040| 74 69 6f 6e 0a 49 44 43 | 4d 50 20 70 6f 6c 6c 69 |tion.IDC|MP polli|
|00005050| 6e 67 20 73 79 73 74 65 | 6d 2e 20 41 20 62 61 73 |ng syste|m. A bas|
|00005060| 69 63 20 70 6f 6c 6c 69 | 6e 67 20 6c 6f 6f 70 20 |ic polli|ng loop |
|00005070| 6c 6f 6f 6b 73 20 6c 69 | 6b 65 20 74 68 69 73 3a |looks li|ke this:|
|00005080| 0a 0a 40 65 78 61 6d 70 | 6c 65 0a 20 20 20 20 76 |..@examp|le. v|
|00005090| 6f 69 64 20 68 61 6e 64 | 6c 65 44 75 6d 6d 79 57 |oid hand|leDummyW|
|000050a0| 69 6e 64 6f 77 28 76 6f | 69 64 29 0a 20 20 20 20 |indow(vo|id). |
|000050b0| 40 7b 0a 20 20 20 20 20 | 20 42 4f 4f 4c 20 63 6c |@{. | BOOL cl|
|000050c0| 6f 73 65 4d 65 3d 46 41 | 4c 53 45 3b 0a 20 20 20 |oseMe=FA|LSE;. |
|000050d0| 20 20 20 73 74 72 75 63 | 74 20 54 52 5f 4d 65 73 | struc|t TR_Mes|
|000050e0| 73 61 67 65 20 2a 74 72 | 4d 73 67 3b 0a 0a 20 20 |sage *tr|Msg;.. |
|000050f0| 20 20 20 20 2f 2a 20 4f | 70 65 6e 20 74 68 65 20 | /* O|pen the |
|00005100| 77 69 6e 64 6f 77 2e 2e | 2e 20 2a 2f 0a 0a 20 20 |window..|. */.. |
|00005110| 20 20 20 20 77 68 69 6c | 65 28 21 63 6c 6f 73 65 | whil|e(!close|
|00005120| 4d 65 29 0a 20 20 20 20 | 20 20 40 7b 0a 20 20 20 |Me). | @{. |
|00005130| 20 20 20 20 20 54 52 5f | 57 61 69 74 28 41 70 70 | TR_|Wait(App|
|00005140| 6c 69 63 61 74 69 6f 6e | 2c 4e 55 4c 4c 29 3b 0a |lication|,NULL);.|
|00005150| 20 20 20 20 20 20 20 20 | 77 68 69 6c 65 28 74 72 | |while(tr|
|00005160| 4d 73 67 3d 54 52 5f 47 | 65 74 4d 73 67 28 41 70 |Msg=TR_G|etMsg(Ap|
|00005170| 70 6c 69 63 61 74 69 6f | 6e 29 29 0a 20 20 20 20 |plicatio|n)). |
|00005180| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 20 20 20 | @{. | |
|00005190| 20 73 77 69 74 63 68 28 | 74 72 4d 73 67 2d 3e 74 | switch(|trMsg->t|
|000051a0| 72 6d 5f 43 6c 61 73 73 | 29 0a 20 20 20 20 20 20 |rm_Class|). |
|000051b0| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 20 20 20 | @{. | |
|000051c0| 20 20 20 63 61 73 65 20 | 54 52 4d 53 5f 43 4c 4f | case |TRMS_CLO|
|000051d0| 53 45 57 49 4e 44 4f 57 | 3a 0a 20 20 20 20 20 20 |SEWINDOW|:. |
|000051e0| 20 20 20 20 20 20 20 20 | 63 6c 6f 73 65 4d 65 3d | |closeMe=|
|000051f0| 54 52 55 45 3b 0a 20 20 | 20 20 20 20 20 20 20 20 |TRUE;. | |
|00005200| 20 20 20 20 62 72 65 61 | 6b 3b 0a 0a 20 20 20 20 | brea|k;.. |
|00005210| 20 20 20 20 20 20 20 20 | 63 61 73 65 20 54 52 4d | |case TRM|
|00005220| 53 5f 41 43 54 49 4f 4e | 3a 0a 20 20 20 20 20 20 |S_ACTION|:. |
|00005230| 20 20 20 20 20 20 20 20 | 73 77 69 74 63 68 28 74 | |switch(t|
|00005240| 72 6d 73 67 2d 3e 74 72 | 6d 5f 49 44 29 0a 20 20 |rmsg->tr|m_ID). |
|00005250| 20 20 20 20 20 20 20 20 | 20 20 20 20 40 7b 0a 20 | | @{. |
|00005260| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 63 | | c|
|00005270| 61 73 65 20 49 44 5f 46 | 4f 4f 3a 0a 20 20 20 20 |ase ID_F|OO:. |
|00005280| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 2f 2a | | /*|
|00005290| 20 44 6f 20 73 6f 6d 65 | 74 68 69 6e 67 2e 2e 2e | Do some|thing...|
|000052a0| 20 2a 2f 0a 20 20 20 20 | 20 20 20 20 20 20 20 20 | */. | |
|000052b0| 20 20 20 20 20 20 62 72 | 65 61 6b 3b 0a 20 20 20 | br|eak;. |
|000052c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 63 61 73 | | cas|
|000052d0| 65 20 49 44 5f 42 41 52 | 3a 0a 20 20 20 20 20 20 |e ID_BAR|:. |
|000052e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 2f 2a 20 44 | | /* D|
|000052f0| 6f 20 73 6f 6d 65 74 68 | 69 6e 67 2e 2e 2e 20 2a |o someth|ing... *|
|00005300| 2f 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |/. | |
|00005310| 20 20 20 20 62 72 65 61 | 6b 3b 0a 20 20 20 20 20 | brea|k;. |
|00005320| 20 20 20 20 20 20 20 20 | 20 40 7d 0a 20 20 20 20 | | @}. |
|00005330| 20 20 20 20 20 20 20 20 | 20 20 62 72 65 61 6b 3b | | break;|
|00005340| 0a 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 63 61 |.. | ca|
|00005350| 73 65 20 54 52 4d 53 5f | 4e 45 57 56 41 4c 55 45 |se TRMS_|NEWVALUE|
|00005360| 3a 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |:. | |
|00005370| 73 77 69 74 63 68 28 74 | 72 4d 73 67 2d 3e 74 72 |switch(t|rMsg->tr|
|00005380| 6d 5f 49 44 29 0a 20 20 | 20 20 20 20 20 20 20 20 |m_ID). | |
|00005390| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 20 20 20 | @{. | |
|000053a0| 20 20 20 20 20 20 20 2f | 2a 20 4e 65 77 20 76 61 | /|* New va|
|000053b0| 6c 75 65 20 69 73 20 69 | 6e 20 74 72 4d 73 67 2d |lue is i|n trMsg-|
|000053c0| 3e 74 72 6d 5f 44 61 74 | 61 20 2a 2f 0a 0a 20 20 |>trm_Dat|a */.. |
|000053d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 63 61 | | ca|
|000053e0| 73 65 20 49 44 5f 4d 59 | 43 48 45 43 4b 42 4f 58 |se ID_MY|CHECKBOX|
|000053f0| 3a 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |:. | |
|00005400| 20 20 20 20 2f 2a 20 44 | 6f 20 73 6f 6d 65 74 68 | /* D|o someth|
|00005410| 69 6e 67 2e 2e 2e 20 2a | 2f 0a 20 20 20 20 20 20 |ing... *|/. |
|00005420| 20 20 20 20 20 20 20 20 | 20 20 20 20 62 72 65 61 | | brea|
|00005430| 6b 3b 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |k;. | |
|00005440| 20 20 20 63 61 73 65 20 | 49 44 5f 4d 59 53 4c 49 | case |ID_MYSLI|
|00005450| 44 45 52 3a 0a 20 20 20 | 20 20 20 20 20 20 20 20 |DER:. | |
|00005460| 20 20 20 20 20 20 20 2f | 2a 20 44 6f 20 73 6f 6d | /|* Do som|
|00005470| 65 74 68 69 6e 67 2e 2e | 2e 20 2a 2f 0a 20 20 20 |ething..|. */. |
|00005480| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 62 | | b|
|00005490| 72 65 61 6b 3b 0a 20 20 | 20 20 20 20 20 20 20 20 |reak;. | |
|000054a0| 20 20 20 20 40 7d 0a 20 | 20 20 20 20 20 20 20 20 | @}. | |
|000054b0| 20 20 20 20 20 62 72 65 | 61 6b 3b 0a 0a 20 20 20 | bre|ak;.. |
|000054c0| 20 20 20 20 20 20 20 20 | 20 63 61 73 65 20 54 52 | | case TR|
|000054d0| 4d 53 5f 45 52 52 4f 52 | 3a 0a 20 20 20 20 20 20 |MS_ERROR|:. |
|000054e0| 20 20 20 20 20 20 20 20 | 70 75 74 73 28 54 52 5f | |puts(TR_|
|000054f0| 47 65 74 45 72 72 6f 72 | 53 74 72 69 6e 67 28 74 |GetError|String(t|
|00005500| 72 4d 73 67 2d 3e 74 72 | 6d 5f 44 61 74 61 29 29 |rMsg->tr|m_Data))|
|00005510| 3b 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |;. | |
|00005520| 62 72 65 61 6b 3b 0a 20 | 20 20 20 20 20 20 20 20 |break;. | |
|00005530| 20 40 7d 0a 20 20 20 20 | 20 20 20 20 20 20 54 52 | @}. | TR|
|00005540| 5f 52 65 70 6c 79 4d 73 | 67 28 74 72 4d 73 67 29 |_ReplyMs|g(trMsg)|
|00005550| 3b 0a 20 20 20 20 20 20 | 20 20 40 7d 0a 20 20 20 |;. | @}. |
|00005560| 20 20 20 40 7d 0a 0a 20 | 20 20 20 20 20 2f 2a 20 | @}.. | /* |
|00005570| 43 6c 6f 73 65 20 74 68 | 65 20 77 69 6e 64 6f 77 |Close th|e window|
|00005580| 2e 2e 2e 20 2a 2f 0a 20 | 20 20 20 40 7d 0a 40 65 |... */. | @}.@e|
|00005590| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 0a 40 73 74 72 |nd examp|le..@str|
|000055a0| 6f 6e 67 7b 4e 6f 74 65 | 3a 7d 20 44 6f 6e 27 74 |ong{Note|:} Don't|
|000055b0| 20 66 6f 72 67 65 74 20 | 74 6f 20 72 65 70 6c 79 | forget |to reply|
|000055c0| 20 61 6c 6c 20 6d 65 73 | 73 61 67 65 73 21 0a 0a | all mes|sages!..|
|000055d0| 59 6f 75 20 63 6f 75 6c | 64 20 61 64 64 20 61 20 |You coul|d add a |
|000055e0| 40 63 6f 64 65 7b 73 77 | 69 74 63 68 28 29 7d 20 |@code{sw|itch()} |
|000055f0| 66 6f 72 20 74 68 65 20 | 70 72 6f 6a 65 63 74 20 |for the |project |
|00005600| 77 68 69 63 68 20 73 65 | 6e 74 20 74 68 65 20 6d |which se|nt the m|
|00005610| 65 73 73 61 67 65 20 69 | 66 0a 79 6f 75 20 68 61 |essage i|f.you ha|
|00005620| 76 65 20 6d 6f 72 65 20 | 74 68 61 6e 20 6f 6e 65 |ve more |than one|
|00005630| 20 70 72 6f 6a 65 63 74 | 20 6f 70 65 6e 65 64 2c | project| opened,|
|00005640| 20 62 75 74 20 61 20 62 | 65 74 74 65 72 20 77 61 | but a b|etter wa|
|00005650| 79 20 69 73 20 74 6f 20 | 75 73 65 20 75 6e 69 71 |y is to |use uniq|
|00005660| 75 65 0a 6f 62 6a 65 63 | 74 20 49 44 73 2e 20 54 |ue.objec|t IDs. T|
|00005670| 68 69 73 20 64 6f 65 73 | 20 61 6c 73 6f 20 79 69 |his does| also yi|
|00005680| 65 6c 64 20 74 68 65 20 | 61 64 76 61 6e 74 61 67 |eld the |advantag|
|00005690| 65 20 74 68 61 74 20 6d | 6f 76 69 6e 67 20 61 6e |e that m|oving an|
|000056a0| 20 6f 62 6a 65 63 74 20 | 66 72 6f 6d 0a 6f 6e 65 | object |from.one|
|000056b0| 20 77 69 6e 64 6f 77 20 | 74 6f 20 61 6e 6f 74 68 | window |to anoth|
|000056c0| 65 72 20 64 6f 65 73 20 | 6e 6f 74 20 72 65 71 75 |er does |not requ|
|000056d0| 69 72 65 20 61 6e 79 20 | 63 68 61 6e 67 65 20 69 |ire any |change i|
|000056e0| 6e 20 74 68 65 20 6d 65 | 73 73 61 67 65 20 68 61 |n the me|ssage ha|
|000056f0| 6e 64 6c 69 6e 67 2e 0a | 0a 49 74 20 69 73 20 63 |ndling..|.It is c|
|00005700| 75 72 72 65 6e 74 6c 79 | 20 6e 6f 74 20 76 65 72 |urrently| not ver|
|00005710| 79 20 77 65 6c 6c 20 64 | 6f 63 75 6d 65 6e 74 65 |y well d|ocumente|
|00005720| 64 20 77 68 69 63 68 20 | 6d 65 73 73 61 67 65 73 |d which |messages|
|00005730| 20 61 72 65 20 73 65 6e | 74 20 62 79 20 74 68 65 | are sen|t by the|
|00005740| 0a 64 69 66 66 65 72 65 | 6e 74 20 6f 62 6a 65 63 |.differe|nt objec|
|00005750| 74 73 2e 20 41 73 20 61 | 20 67 65 6e 65 72 61 6c |ts. As a| general|
|00005760| 20 72 75 6c 65 2c 20 61 | 63 74 69 76 61 74 65 61 | rule, a|ctivatea|
|00005770| 62 6c 65 20 6f 62 6a 65 | 63 74 73 20 73 65 6e 64 |ble obje|cts send|
|00005780| 20 40 63 6f 64 65 7b 54 | 52 4d 53 5f 41 43 54 49 | @code{T|RMS_ACTI|
|00005790| 4f 4e 7d 0a 61 6e 64 20 | 6f 62 6a 65 63 74 73 20 |ON}.and |objects |
|000057a0| 77 68 69 63 68 20 68 61 | 76 65 20 61 20 40 63 6f |which ha|ve a @co|
|000057b0| 64 65 7b 54 52 41 54 5f | 56 61 6c 75 65 7d 20 6f |de{TRAT_|Value} o|
|000057c0| 72 20 61 20 73 69 6d 69 | 6c 61 72 20 6d 6f 64 69 |r a simi|lar modi|
|000057d0| 66 69 61 62 6c 65 20 61 | 74 74 72 69 62 75 74 65 |fiable a|ttribute|
|000057e0| 2c 0a 73 65 6e 64 20 40 | 63 6f 64 65 7b 54 52 4d |,.send @|code{TRM|
|000057f0| 53 5f 4e 45 57 56 41 4c | 55 45 7d 2e 0a 0a 48 65 |S_NEWVAL|UE}...He|
|00005800| 72 65 20 69 73 20 61 20 | 6d 6f 72 65 20 64 65 74 |re is a |more det|
|00005810| 61 69 6c 65 64 20 64 65 | 73 63 72 69 70 74 69 6f |ailed de|scriptio|
|00005820| 6e 20 6f 66 20 74 68 65 | 20 6d 65 73 73 61 67 65 |n of the| message|
|00005830| 20 74 79 70 65 73 3a 0a | 0a 40 69 74 65 6d 69 7a | types:.|.@itemiz|
|00005840| 65 20 40 62 75 6c 6c 65 | 74 0a 40 69 74 65 6d 0a |e @bulle|t.@item.|
|00005850| 40 63 6f 64 65 7b 54 52 | 4d 53 5f 43 4c 4f 53 45 |@code{TR|MS_CLOSE|
|00005860| 57 49 4e 44 4f 57 7d 3a | 20 54 68 65 20 75 73 65 |WINDOW}:| The use|
|00005870| 72 20 68 61 73 20 70 72 | 65 73 73 65 64 20 74 68 |r has pr|essed th|
|00005880| 65 20 63 6c 6f 73 65 20 | 67 61 64 67 65 74 20 6f |e close |gadget o|
|00005890| 72 20 74 68 65 20 40 63 | 6f 64 65 7b 45 73 63 7d |r the @c|ode{Esc}|
|000058a0| 20 6b 65 79 0a 28 69 66 | 20 69 74 20 68 61 73 6e | key.(if| it hasn|
|000058b0| 27 74 20 62 65 65 6e 20 | 64 69 73 61 62 6c 65 64 |'t been |disabled|
|000058c0| 20 77 69 74 68 20 40 63 | 6f 64 65 7b 54 52 57 46 | with @c|ode{TRWF|
|000058d0| 5f 4e 4f 45 53 43 43 4c | 4f 53 45 7d 29 2e 0a 40 |_NOESCCL|OSE})..@|
|000058e0| 69 74 65 6d 0a 40 63 6f | 64 65 7b 54 52 4d 53 5f |item.@co|de{TRMS_|
|000058f0| 45 52 52 4f 52 7d 3a 20 | 41 6e 20 65 72 72 6f 72 |ERROR}: |An error|
|00005900| 20 6f 63 63 75 72 65 64 | 2e 20 40 63 6f 64 65 7b | occured|. @code{|
|00005910| 54 52 5f 4d 65 73 73 61 | 67 65 2e 74 72 6d 5f 44 |TR_Messa|ge.trm_D|
|00005920| 61 74 61 7d 20 63 6f 6e | 74 61 69 6e 73 20 74 68 |ata} con|tains th|
|00005930| 65 20 65 72 72 6f 72 0a | 63 6f 64 65 2e 20 59 6f |e error.|code. Yo|
|00005940| 75 20 63 61 6e 20 75 73 | 65 20 40 63 6f 64 65 7b |u can us|e @code{|
|00005950| 54 52 5f 47 65 74 45 72 | 72 6f 72 53 74 72 69 6e |TR_GetEr|rorStrin|
|00005960| 67 28 29 7d 20 74 6f 20 | 67 65 6e 65 72 61 74 65 |g()} to |generate|
|00005970| 20 61 20 75 73 65 72 2d | 72 65 61 64 61 62 6c 65 | a user-|readable|
|00005980| 20 65 72 72 6f 72 0a 6d | 65 73 73 61 67 65 20 66 | error.m|essage f|
|00005990| 72 6f 6d 20 74 68 69 73 | 20 65 72 72 6f 72 20 63 |rom this| error c|
|000059a0| 6f 64 65 2e 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |ode..@it|em.@code|
|000059b0| 7b 54 52 4d 53 5f 4e 45 | 57 56 41 4c 55 45 7d 3a |{TRMS_NE|WVALUE}:|
|000059c0| 20 41 6e 20 6f 62 6a 65 | 63 74 27 73 20 61 74 74 | An obje|ct's att|
|000059d0| 72 69 62 75 74 65 20 68 | 61 73 20 63 68 61 6e 67 |ribute h|as chang|
|000059e0| 65 64 2e 20 40 63 6f 64 | 65 7b 54 52 5f 4d 65 73 |ed. @cod|e{TR_Mes|
|000059f0| 73 61 67 65 2e 74 72 6d | 5f 44 61 74 61 7d 20 63 |sage.trm|_Data} c|
|00005a00| 6f 6e 74 61 69 6e 73 0a | 74 68 65 20 6e 65 77 20 |ontains.|the new |
|00005a10| 76 61 6c 75 65 20 66 6f | 72 20 74 68 65 20 61 74 |value fo|r the at|
|00005a20| 74 72 69 62 75 74 65 2e | 0a 40 69 74 65 6d 0a 40 |tribute.|.@item.@|
|00005a30| 63 6f 64 65 7b 54 52 4d | 53 5f 41 43 54 49 4f 4e |code{TRM|S_ACTION|
|00005a40| 7d 3a 20 41 6e 20 6f 62 | 6a 65 63 74 20 68 61 73 |}: An ob|ject has|
|00005a50| 20 62 65 65 6e 20 61 63 | 74 69 76 61 74 65 64 20 | been ac|tivated |
|00005a60| 73 6f 6d 65 68 6f 77 20 | 28 65 2e 67 2e 20 61 20 |somehow |(e.g. a |
|00005a70| 62 75 74 74 6f 6e 20 68 | 61 73 20 62 65 65 6e 20 |button h|as been |
|00005a80| 70 72 65 73 73 65 64 0a | 6f 72 20 69 74 73 20 6b |pressed.|or its k|
|00005a90| 65 79 62 6f 61 72 64 20 | 73 68 6f 72 74 63 75 74 |eyboard |shortcut|
|00005aa0| 20 77 61 73 20 75 73 65 | 64 20 69 6e 73 74 65 61 | was use|d instea|
|00005ab0| 64 29 2e 0a 40 69 74 65 | 6d 0a 40 63 6f 64 65 7b |d)..@ite|m.@code{|
|00005ac0| 54 52 4d 53 5f 49 43 4f | 4e 44 52 4f 50 50 45 44 |TRMS_ICO|NDROPPED|
|00005ad0| 7d 3a 20 41 6e 20 69 63 | 6f 6e 20 68 61 73 20 62 |}: An ic|on has b|
|00005ae0| 65 65 6e 20 64 72 6f 70 | 70 65 64 20 6f 76 65 72 |een drop|ped over|
|00005af0| 20 61 20 77 69 6e 64 6f | 77 2e 0a 59 6f 75 20 77 | a windo|w..You w|
|00005b00| 69 6c 6c 20 67 65 74 20 | 74 68 69 73 20 6d 65 73 |ill get |this mes|
|00005b10| 73 61 67 65 20 6f 6e 6c | 79 20 69 66 20 61 6e 20 |sage onl|y if an |
|00005b20| 6f 62 6a 65 63 74 20 69 | 6e 20 79 6f 75 72 0a 77 |object i|n your.w|
|00005b30| 69 6e 64 6f 77 20 72 65 | 61 63 74 73 20 6f 6e 20 |indow re|acts on |
|00005b40| 64 72 6f 70 70 65 64 20 | 69 63 6f 6e 73 20 6f 72 |dropped |icons or|
|00005b50| 20 79 6f 75 20 61 73 6b | 20 64 69 72 65 63 74 6c | you ask| directl|
|00005b60| 79 20 66 6f 72 20 69 74 | 20 62 79 0a 73 70 65 63 |y for it| by.spec|
|00005b70| 69 66 79 69 6e 67 20 74 | 68 65 20 70 72 6f 6a 65 |ifying t|he proje|
|00005b80| 63 74 20 66 6c 61 67 20 | 40 63 6f 64 65 7b 54 52 |ct flag |@code{TR|
|00005b90| 57 46 5f 41 50 50 57 49 | 4e 44 4f 57 7d 2e 20 4f |WF_APPWI|NDOW}. O|
|00005ba0| 74 68 65 72 77 69 73 65 | 0a 57 6f 72 6b 62 65 6e |therwise|.Workben|
|00005bb0| 63 68 20 77 69 6c 6c 20 | 6e 6f 74 20 61 6c 6c 6f |ch will |not allo|
|00005bc0| 77 20 79 6f 75 20 74 6f | 20 64 72 6f 70 20 69 63 |w you to| drop ic|
|00005bd0| 6f 6e 73 20 6f 76 65 72 | 20 61 20 54 72 69 74 6f |ons over| a Trito|
|00005be0| 6e 20 77 69 6e 64 6f 77 | 2e 0a 40 63 6f 64 65 7b |n window|..@code{|
|00005bf0| 54 52 5f 4d 65 73 73 61 | 67 65 2e 74 72 6d 5f 49 |TR_Messa|ge.trm_I|
|00005c00| 44 7d 20 63 6f 6e 74 61 | 69 6e 73 20 74 68 65 20 |D} conta|ins the |
|00005c10| 49 44 20 6f 66 20 74 68 | 65 20 6f 62 6a 65 63 74 |ID of th|e object|
|00005c20| 20 6f 76 65 72 20 77 68 | 69 63 68 20 74 68 65 0a | over wh|ich the.|
|00005c30| 69 63 6f 6e 20 77 61 73 | 20 64 72 6f 70 70 65 64 |icon was| dropped|
|00005c40| 20 6f 72 20 30 20 69 66 | 20 69 74 20 77 61 73 20 | or 0 if| it was |
|00005c50| 64 72 6f 70 70 65 64 20 | 6f 76 65 72 20 61 6e 20 |dropped |over an |
|00005c60| 6f 62 6a 65 63 74 20 77 | 69 74 68 6f 75 74 20 61 |object w|ithout a|
|00005c70| 6e 20 49 44 2e 0a 40 63 | 6f 64 65 7b 54 52 5f 4d |n ID..@c|ode{TR_M|
|00005c80| 65 73 73 61 67 65 2e 74 | 72 6d 5f 44 61 74 61 7d |essage.t|rm_Data}|
|00005c90| 20 63 6f 6e 74 61 69 6e | 73 20 61 20 70 6f 69 6e | contain|s a poin|
|00005ca0| 74 65 72 20 74 6f 20 74 | 68 65 20 40 63 6f 64 65 |ter to t|he @code|
|00005cb0| 7b 73 74 72 75 63 74 20 | 41 70 70 4d 65 73 73 61 |{struct |AppMessa|
|00005cc0| 67 65 7d 0a 77 68 69 63 | 68 20 77 61 73 20 73 65 |ge}.whic|h was se|
|00005cd0| 6e 74 20 62 79 20 57 6f | 72 6b 62 65 6e 63 68 2e |nt by Wo|rkbench.|
|00005ce0| 0a 40 69 74 65 6d 0a 40 | 63 6f 64 65 7b 54 52 4d |.@item.@|code{TRM|
|00005cf0| 53 5f 4b 45 59 50 52 45 | 53 53 45 44 7d 3a 20 41 |S_KEYPRE|SSED}: A|
|00005d00| 20 6b 65 79 20 68 61 73 | 20 62 65 65 6e 20 70 72 | key has| been pr|
|00005d10| 65 73 73 65 64 20 61 6e | 64 20 54 72 69 74 6f 6e |essed an|d Triton|
|00005d20| 20 77 61 73 20 75 6e 61 | 62 6c 65 20 74 6f 0a 69 | was una|ble to.i|
|00005d30| 64 65 6e 74 69 66 79 20 | 69 74 20 28 65 2e 67 2e |dentify |it (e.g.|
|00005d40| 20 61 73 20 61 20 6b 65 | 79 62 6f 61 72 64 20 73 | as a ke|yboard s|
|00005d50| 68 6f 72 74 63 75 74 29 | 2e 0a 40 63 6f 64 65 7b |hortcut)|..@code{|
|00005d60| 54 52 5f 4d 65 73 73 61 | 67 65 2e 74 72 6d 5f 44 |TR_Messa|ge.trm_D|
|00005d70| 61 74 61 7d 20 63 6f 6e | 74 61 69 6e 73 20 74 68 |ata} con|tains th|
|00005d80| 65 20 41 53 43 49 49 20 | 63 6f 64 65 20 28 69 66 |e ASCII |code (if|
|00005d90| 20 61 76 61 69 6c 61 62 | 6c 65 2c 0a 6f 74 68 65 | availab|le,.othe|
|00005da0| 72 77 69 73 65 20 30 29 | 2c 0a 40 63 6f 64 65 7b |rwise 0)|,.@code{|
|00005db0| 54 52 5f 4d 65 73 73 61 | 67 65 2e 74 72 6d 5f 43 |TR_Messa|ge.trm_C|
|00005dc0| 6f 64 65 7d 20 63 6f 6e | 74 61 69 6e 73 20 74 68 |ode} con|tains th|
|00005dd0| 65 20 52 61 77 4b 65 79 | 20 63 6f 64 65 20 61 6e |e RawKey| code an|
|00005de0| 64 20 40 63 6f 64 65 7b | 54 52 5f 4d 65 73 73 61 |d @code{|TR_Messa|
|00005df0| 67 65 2e 74 72 6d 5f 51 | 75 61 6c 69 66 69 65 72 |ge.trm_Q|ualifier|
|00005e00| 7d 0a 74 68 65 20 71 75 | 61 6c 69 66 69 65 72 20 |}.the qu|alifier |
|00005e10| 62 69 74 73 2e 0a 40 69 | 74 65 6d 0a 40 63 6f 64 |bits..@i|tem.@cod|
|00005e20| 65 7b 54 52 4d 53 5f 48 | 45 4c 50 7d 3a 20 54 68 |e{TRMS_H|ELP}: Th|
|00005e30| 65 20 75 73 65 72 20 72 | 65 71 75 65 73 74 73 20 |e user r|equests |
|00005e40| 68 65 6c 70 20 66 6f 72 | 20 74 68 65 20 6f 62 6a |help for| the obj|
|00005e50| 65 63 74 20 73 70 65 63 | 69 66 69 65 64 20 62 79 |ect spec|ified by|
|00005e60| 20 40 63 6f 64 65 7b 54 | 52 5f 4d 65 73 73 61 67 | @code{T|R_Messag|
|00005e70| 65 2e 74 72 6d 5f 49 44 | 7d 0a 6f 72 20 66 6f 72 |e.trm_ID|}.or for|
|00005e80| 20 74 68 65 20 77 68 6f | 6c 65 20 77 69 6e 64 6f | the who|le windo|
|00005e90| 77 20 69 66 20 74 68 65 | 20 49 44 20 69 73 20 30 |w if the| ID is 0|
|00005ea0| 2e 0a 40 65 6e 64 20 69 | 74 65 6d 69 7a 65 0a 0a |..@end i|temize..|
|00005eb0| 41 20 64 65 73 63 72 69 | 70 74 69 6f 6e 20 6f 66 |A descri|ption of|
|00005ec0| 20 61 6c 6c 20 66 69 65 | 6c 64 73 20 6f 66 20 74 | all fie|lds of t|
|00005ed0| 68 65 20 40 63 6f 64 65 | 7b 54 52 5f 4d 65 73 73 |he @code|{TR_Mess|
|00005ee0| 61 67 65 7d 20 73 74 72 | 75 63 74 75 72 65 20 63 |age} str|ucture c|
|00005ef0| 61 6e 20 62 65 20 66 6f | 75 6e 64 20 69 6e 0a 74 |an be fo|und in.t|
|00005f00| 68 65 20 43 20 68 65 61 | 64 65 72 20 66 69 6c 65 |he C hea|der file|
|00005f10| 20 40 66 69 6c 65 7b 44 | 65 76 65 6c 6f 70 65 72 | @file{D|eveloper|
|00005f20| 2f 49 6e 63 6c 75 64 65 | 2f 6c 69 62 72 61 72 69 |/Include|/librari|
|00005f30| 65 73 2f 74 72 69 74 6f | 6e 2e 68 7d 2e 0a 0a 40 |es/trito|n.h}...@|
|00005f40| 6e 6f 64 65 20 54 55 54 | 5f 4d 45 53 2c 20 54 55 |node TUT|_MES, TU|
|00005f50| 54 5f 48 45 4c 2c 20 54 | 55 54 5f 50 4f 4c 2c 20 |T_HEL, T|UT_POL, |
|00005f60| 54 6f 70 0a 40 73 65 63 | 74 69 6f 6e 20 4d 65 73 |Top.@sec|tion Mes|
|00005f70| 73 61 67 65 73 0a 40 63 | 69 6e 64 65 78 20 53 65 |sages.@c|index Se|
|00005f80| 74 0a 40 63 69 6e 64 65 | 78 20 47 65 74 0a 40 63 |t.@cinde|x Get.@c|
|00005f90| 69 6e 64 65 78 20 4d 65 | 73 73 61 67 65 0a 40 63 |index Me|ssage.@c|
|00005fa0| 69 6e 64 65 78 20 41 74 | 74 72 69 62 75 74 65 0a |index At|tribute.|
|00005fb0| 40 63 69 6e 64 65 78 20 | 51 75 65 72 79 0a 40 63 |@cindex |Query.@c|
|00005fc0| 69 6e 64 65 78 20 4d 6f | 64 69 66 79 0a 0a 53 6f |index Mo|dify..So|
|00005fd0| 6d 65 74 69 6d 65 73 20 | 79 6f 75 20 6d 61 79 20 |metimes |you may |
|00005fe0| 77 69 73 68 20 74 6f 20 | 71 75 65 72 79 20 61 6e |wish to |query an|
|00005ff0| 20 6f 62 6a 65 63 74 27 | 73 20 61 74 74 72 69 62 | object'|s attrib|
|00006000| 75 74 65 20 64 69 72 65 | 63 74 6c 79 0a 77 69 74 |ute dire|ctly.wit|
|00006010| 68 6f 75 74 20 77 61 69 | 74 69 6e 67 20 69 6e 20 |hout wai|ting in |
|00006020| 61 20 70 6f 6c 6c 69 6e | 67 20 6c 6f 6f 70 20 61 |a pollin|g loop a|
|00006030| 6e 64 20 74 68 65 6e 20 | 73 74 6f 72 69 6e 67 20 |nd then |storing |
|00006040| 69 74 73 20 76 61 6c 75 | 65 20 73 6f 6d 65 77 68 |its valu|e somewh|
|00006050| 65 72 65 0a 65 6c 73 65 | 2e 20 54 68 69 73 20 69 |ere.else|. This i|
|00006060| 73 20 65 73 70 65 63 69 | 61 6c 6c 79 20 75 73 65 |s especi|ally use|
|00006070| 66 75 6c 20 66 6f 72 20 | 73 74 72 69 6e 67 20 67 |ful for |string g|
|00006080| 61 64 67 65 74 73 2e 20 | 59 6f 75 20 73 68 6f 75 |adgets. |You shou|
|00006090| 6c 64 0a 40 65 6d 70 68 | 7b 6e 6f 74 7d 20 72 65 |ld.@emph|{not} re|
|000060a0| 61 64 20 74 68 65 69 72 | 20 63 6f 6e 74 65 6e 74 |ad their| content|
|000060b0| 73 20 77 68 65 6e 20 79 | 6f 75 20 72 65 63 65 69 |s when y|ou recei|
|000060c0| 76 65 20 61 20 40 63 6f | 64 65 7b 54 52 4d 53 5f |ve a @co|de{TRMS_|
|000060d0| 4e 45 57 56 41 4c 55 45 | 7d 0a 6d 65 73 73 61 67 |NEWVALUE|}.messag|
|000060e0| 65 2c 20 62 65 63 61 75 | 73 65 20 69 74 20 69 73 |e, becau|se it is|
|000060f0| 20 70 6f 73 73 69 62 6c | 65 20 74 6f 20 65 78 69 | possibl|e to exi|
|00006100| 74 20 61 20 73 74 72 69 | 6e 67 20 67 61 64 67 65 |t a stri|ng gadge|
|00006110| 74 20 77 69 74 68 6f 75 | 74 0a 74 72 69 67 67 65 |t withou|t.trigge|
|00006120| 72 69 6e 67 20 73 75 63 | 68 20 61 20 6d 65 73 73 |ring suc|h a mess|
|00006130| 61 67 65 2e 20 49 6e 73 | 74 65 61 64 20 79 6f 75 |age. Ins|tead you|
|00006140| 20 68 61 76 65 20 74 6f | 20 72 65 61 64 20 74 68 | have to| read th|
|00006150| 65 20 63 6f 6e 74 65 6e | 74 73 0a 64 69 72 65 63 |e conten|ts.direc|
|00006160| 74 6c 79 20 62 65 66 6f | 72 65 20 79 6f 75 20 6e |tly befo|re you n|
|00006170| 65 65 64 20 74 68 65 6d | 2e 0a 0a 41 74 74 72 69 |eed them|...Attri|
|00006180| 62 75 74 65 73 20 63 61 | 6e 20 62 65 20 72 65 61 |butes ca|n be rea|
|00006190| 64 20 77 69 74 68 20 74 | 68 65 20 40 63 6f 64 65 |d with t|he @code|
|000061a0| 7b 54 52 5f 47 65 74 41 | 74 74 72 69 62 75 74 65 |{TR_GetA|ttribute|
|000061b0| 28 29 7d 20 66 75 6e 63 | 74 69 6f 6e 2c 0a 77 68 |()} func|tion,.wh|
|000061c0| 69 63 68 20 77 69 6c 6c | 20 72 65 74 75 72 6e 20 |ich will| return |
|000061d0| 74 68 65 20 76 61 6c 75 | 65 20 6f 66 20 61 6e 20 |the valu|e of an |
|000061e0| 6f 62 6a 65 63 74 27 73 | 20 6f 72 20 70 72 6f 6a |object's| or proj|
|000061f0| 65 63 74 27 73 20 61 74 | 74 72 69 62 75 74 65 2e |ect's at|tribute.|
|00006200| 0a 53 70 65 63 69 66 79 | 20 74 68 65 20 6f 62 6a |.Specify| the obj|
|00006210| 65 63 74 27 73 20 49 44 | 20 6f 72 20 30 20 66 6f |ect's ID| or 0 fo|
|00006220| 72 20 61 20 70 72 6f 6a | 65 63 74 20 61 74 74 72 |r a proj|ect attr|
|00006230| 69 62 75 74 65 2e 20 59 | 6f 75 20 63 61 6e 20 67 |ibute. Y|ou can g|
|00006240| 65 74 0a 74 68 65 20 64 | 65 66 61 75 6c 74 20 61 |et.the d|efault a|
|00006250| 74 74 72 69 62 75 74 65 | 20 6f 66 20 61 6e 20 6f |ttribute| of an o|
|00006260| 62 6a 65 63 74 20 62 79 | 20 73 65 74 74 69 6e 67 |bject by| setting|
|00006270| 20 40 63 6f 64 65 7b 41 | 74 74 72 69 62 75 74 65 | @code{A|ttribute|
|00006280| 7d 20 74 6f 0a 30 2e 20 | 4f 74 68 65 72 77 69 73 |} to.0. |Otherwis|
|00006290| 65 20 73 65 74 20 69 74 | 20 74 6f 20 61 6e 20 61 |e set it| to an a|
|000062a0| 74 74 72 69 62 75 74 65 | 20 74 61 67 2e 20 43 68 |ttribute| tag. Ch|
|000062b0| 65 63 6b 61 62 6c 65 20 | 6d 65 6e 75 20 69 74 65 |eckable |menu ite|
|000062c0| 6d 73 20 73 75 70 70 6f | 72 74 0a 74 68 65 20 40 |ms suppo|rt.the @|
|000062d0| 63 6f 64 65 7b 54 52 41 | 54 5f 56 61 6c 75 65 7d |code{TRA|T_Value}|
|000062e0| 20 61 74 74 72 69 62 75 | 74 65 20 77 68 69 63 68 | attribu|te which|
|000062f0| 20 69 73 20 73 65 74 20 | 74 6f 20 30 20 69 66 20 | is set |to 0 if |
|00006300| 74 68 65 20 6d 65 6e 75 | 20 69 74 65 6d 20 69 73 |the menu| item is|
|00006310| 0a 6e 6f 74 20 63 68 65 | 63 6b 65 64 20 61 6e 64 |.not che|cked and|
|00006320| 20 61 20 6e 6f 6e 2d 30 | 20 76 61 6c 75 65 20 69 | a non-0| value i|
|00006330| 66 20 69 74 20 69 73 20 | 63 68 65 63 6b 65 64 2e |f it is |checked.|
|00006340| 0a 0a 53 65 74 74 69 6e | 67 20 61 20 6e 65 77 20 |..Settin|g a new |
|00006350| 61 74 74 72 69 62 75 74 | 65 20 77 6f 72 6b 73 20 |attribut|e works |
|00006360| 74 68 65 20 73 61 6d 65 | 20 77 61 79 20 77 69 74 |the same| way wit|
|00006370| 68 20 74 68 65 20 66 75 | 6e 63 74 69 6f 6e 0a 40 |h the fu|nction.@|
|00006380| 63 6f 64 65 7b 54 52 5f | 53 65 74 41 74 74 72 69 |code{TR_|SetAttri|
|00006390| 62 75 74 65 28 29 7d 2e | 20 41 67 61 69 6e 20 79 |bute()}.| Again y|
|000063a0| 6f 75 20 6d 61 79 20 61 | 6c 73 6f 20 6d 6f 64 69 |ou may a|lso modi|
|000063b0| 66 79 20 70 72 6f 6a 65 | 63 74 20 61 74 74 72 69 |fy proje|ct attri|
|000063c0| 62 75 74 65 73 2e 0a 53 | 65 65 20 74 68 65 20 61 |butes..S|ee the a|
|000063d0| 75 74 6f 64 6f 63 20 63 | 6c 69 70 20 66 6f 72 20 |utodoc c|lip for |
|000063e0| 61 20 6c 69 73 74 20 6f | 66 20 74 68 65 6d 2e 20 |a list o|f them. |
|000063f0| 41 66 74 65 72 20 73 65 | 74 74 69 6e 67 20 61 20 |After se|tting a |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
