home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / gui / triton / developer / docsource / tritondev.texi < prev   
Texinfo Document  |  1995-06-28  |  30.5 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).

ConfidenceProgramDetectionMatch TypeSupport
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| 31 2e 33 0a 40 73 70 20 | 34 0a 40 63 65 6e 74 65 |1.3.@sp |4.@cente|
|00000130| 72 20 40 74 69 74 6c 65 | 66 6f 6e 74 7b 44 65 76 |r @title|font{Dev|
|00000140| 65 6c 6f 70 65 72 20 44 | 6f 63 75 6d 65 6e 74 61 |eloper D|ocumenta|
|00000150| 74 69 6f 6e 7d 0a 40 73 | 70 20 34 0a 40 63 65 6e |tion}.@s|p 4.@cen|
|00000160| 74 65 72 20 40 63 6f 70 | 79 72 69 67 68 74 7b 7d |ter @cop|yright{}|
|00000170| 20 31 39 39 33 2d 31 39 | 39 35 20 62 79 20 53 74 | 1993-19|95 by St|
|00000180| 65 66 61 6e 20 5a 65 69 | 67 65 72 2e 0a 40 63 65 |efan Zei|ger..@ce|
|00000190| 6e 74 65 72 20 41 6c 6c | 20 72 69 67 68 74 73 20 |nter All| rights |
|000001a0| 72 65 73 65 72 76 65 64 | 2e 0a 40 65 6e 64 20 74 |reserved|..@end t|
|000001b0| 69 74 6c 65 70 61 67 65 | 0a 0a 40 6e 6f 64 65 20 |itlepage|..@node |
|000001c0| 54 6f 70 2c 20 49 4e 54 | 5f 4f 56 45 2c 20 28 64 |Top, INT|_OVE, (d|
|000001d0| 69 72 29 2c 20 28 64 69 | 72 29 0a 40 69 66 69 6e |ir), (di|r).@ifin|
|000001e0| 66 6f 0a 0a 40 63 65 6e | 74 65 72 20 2a 2a 2a 2a |fo..@cen|ter ****|
|000001f0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|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 0a 0a 40 63 65 6e |********|**..@cen|
|00000220| 74 65 72 20 54 72 69 74 | 6f 6e 0a 0a 40 63 65 6e |ter Trit|on..@cen|
|00000230| 74 65 72 20 52 65 6c 65 | 61 73 65 20 31 2e 33 0a |ter Rele|ase 1.3.|
|00000240| 0a 40 63 65 6e 74 65 72 | 20 44 65 76 65 6c 6f 70 |.@center| Develop|
|00000250| 65 72 20 44 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |er Docum|entation|
|00000260| 0a 0a 40 63 65 6e 74 65 | 72 20 28 63 29 20 31 39 |..@cente|r (c) 19|
|00000270| 39 33 2d 31 39 39 35 20 | 53 74 65 66 61 6e 20 5a |93-1995 |Stefan Z|
|00000280| 65 69 67 65 72 0a 0a 40 | 63 65 6e 74 65 72 20 2a |eiger..@|center *|
|00000290| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000002a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000002b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 0a 40 |********|*****..@|
|000002c0| 65 6e 64 20 69 66 69 6e | 66 6f 0a 0a 40 6d 65 6e |end ifin|fo..@men|
|000002d0| 75 0a 0a 49 6e 74 72 6f | 64 75 63 74 69 6f 6e 0a |u..Intro|duction.|
|000002e0| 0a 2a 20 4f 76 65 72 76 | 69 65 77 20 20 20 20 20 |.* Overv|iew |
|000002f0| 20 20 20 3a 49 4e 54 5f | 4f 56 45 2e 20 20 20 20 | :INT_|OVE. |
|00000300| 20 20 20 50 72 6f 67 72 | 61 6d 6d 69 6e 67 20 77 | Progr|amming w|
|00000310| 69 74 68 20 54 72 69 74 | 6f 6e 0a 2a 20 4f 4f 50 |ith Trit|on.* OOP|
|00000320| 20 49 6e 74 65 72 6e 61 | 6c 73 20 20 20 3a 49 4e | Interna|ls :IN|
|00000330| 54 5f 4f 4f 50 2e 20 20 | 20 20 20 20 20 54 68 65 |T_OOP. | The|
|00000340| 20 69 6e 74 65 72 6e 61 | 6c 20 77 6f 72 6b 69 6e | interna|l workin|
|00000350| 67 20 6f 66 20 54 72 69 | 74 6f 6e 0a 2a 20 43 6c |g of Tri|ton.* Cl|
|00000360| 61 73 73 20 54 72 65 65 | 20 20 20 20 20 20 3a 49 |ass Tree| :I|
|00000370| 4e 54 5f 43 4c 41 2e 20 | 20 20 20 20 20 20 41 76 |NT_CLA. | Av|
|00000380| 61 69 6c 61 62 6c 65 20 | 63 6c 61 73 73 65 73 0a |ailable |classes.|
|00000390| 2a 20 41 75 74 6f 64 6f | 63 73 20 20 20 20 20 20 |* Autodo|cs |
|000003a0| 20 20 3a 49 4e 54 5f 41 | 55 54 2e 20 20 20 20 20 | :INT_A|UT. |
|000003b0| 20 20 4e 6f 74 65 73 20 | 6f 6e 20 74 68 65 20 61 | Notes |on the a|
|000003c0| 75 74 6f 64 6f 63 73 0a | 0a 54 75 74 6f 72 69 61 |utodocs.|.Tutoria|
|000003d0| 6c 20 2d 20 53 74 65 70 | 20 62 79 20 53 74 65 70 |l - Step| by Step|
|000003e0| 0a 0a 2a 20 41 70 70 6c | 69 63 61 74 69 6f 6e 73 |..* Appl|ications|
|000003f0| 20 20 20 20 3a 54 55 54 | 5f 41 50 50 2e 20 20 20 | :TUT|_APP. |
|00000400| 20 20 20 20 54 68 65 20 | 6b 65 79 20 74 6f 20 54 | The |key to T|
|00000410| 72 69 74 6f 6e 0a 2a 20 | 50 72 6f 6a 65 63 74 73 |riton.* |Projects|
|00000420| 20 20 20 20 20 20 20 20 | 3a 54 55 54 5f 50 52 4f | |:TUT_PRO|
|00000430| 2e 20 20 20 20 20 20 20 | 54 72 69 74 6f 6e 20 47 |. |Triton G|
|00000440| 55 49 20 77 69 6e 64 6f | 77 73 0a 2a 20 4d 65 6e |UI windo|ws.* Men|
|00000450| 75 73 20 20 20 20 20 20 | 20 20 20 20 20 3a 54 55 |us | :TU|
|00000460| 54 5f 4d 45 4e 2e 20 20 | 20 20 20 20 20 4d 65 6e |T_MEN. | Men|
|00000470| 75 73 0a 2a 20 4f 62 6a | 65 63 74 73 20 20 20 20 |us.* Obj|ects |
|00000480| 20 20 20 20 20 3a 54 55 | 54 5f 4f 42 4a 2e 20 20 | :TU|T_OBJ. |
|00000490| 20 20 20 20 20 54 72 69 | 74 6f 6e 20 6f 62 6a 65 | Tri|ton obje|
|000004a0| 63 74 73 0a 2a 20 4c 61 | 79 6f 75 74 20 20 20 20 |cts.* La|yout |
|000004b0| 20 20 20 20 20 20 3a 54 | 55 54 5f 4c 41 59 2e 20 | :T|UT_LAY. |
|000004c0| 20 20 20 20 20 20 54 68 | 65 20 6c 61 79 6f 75 74 | Th|e layout|
|000004d0| 20 65 6e 67 69 6e 65 0a | 2a 20 4d 61 63 72 6f 73 | engine.|* Macros|
|000004e0| 20 20 20 20 20 20 20 20 | 20 20 3a 54 55 54 5f 4d | | :TUT_M|
|000004f0| 41 43 2e 20 20 20 20 20 | 20 20 55 73 69 6e 67 20 |AC. | Using |
|00000500| 74 68 65 20 54 72 69 74 | 6f 6e 20 47 55 49 20 6d |the Trit|on GUI m|
|00000510| 61 63 72 6f 73 0a 2a 20 | 50 6f 6c 6c 69 6e 67 20 |acros.* |Polling |
|00000520| 4c 6f 6f 70 20 20 20 20 | 3a 54 55 54 5f 50 4f 4c |Loop |:TUT_POL|
|00000530| 2e 20 20 20 20 20 20 20 | 48 61 6e 64 6c 69 6e 67 |. |Handling|
|00000540| 20 47 55 49 20 65 76 65 | 6e 74 73 0a 2a 20 4d 65 | GUI eve|nts.* Me|
|00000550| 73 73 61 67 65 73 20 20 | 20 20 20 20 20 20 3a 54 |ssages | :T|
|00000560| 55 54 5f 4d 45 53 2e 20 | 20 20 20 20 20 20 53 65 |UT_MES. | Se|
|00000570| 6e 64 69 6e 67 20 6d 65 | 73 73 61 67 65 73 0a 2a |nding me|ssages.*|
|00000580| 20 48 65 6c 70 20 20 20 | 20 20 20 20 20 20 20 20 | Help | |
|00000590| 20 3a 54 55 54 5f 48 45 | 4c 2e 20 20 20 20 20 20 | :TUT_HE|L. |
|000005a0| 20 50 72 6f 76 69 64 69 | 6e 67 20 68 65 6c 70 0a | Providi|ng help.|
|000005b0| 2a 20 52 65 71 75 65 73 | 74 65 72 73 20 20 20 20 |* Reques|ters |
|000005c0| 20 20 3a 54 55 54 5f 52 | 45 51 2e 20 20 20 20 20 | :TUT_R|EQ. |
|000005d0| 20 20 54 72 69 74 6f 6e | 20 72 65 71 75 65 73 74 | Triton| request|
|000005e0| 65 72 73 0a 0a 53 74 79 | 6c 65 20 47 75 69 64 65 |ers..Sty|le Guide|
|000005f0| 0a 0a 2a 20 47 75 69 64 | 65 6c 69 6e 65 73 20 20 |..* Guid|elines |
|00000600| 20 20 20 20 3a 53 54 59 | 5f 4f 56 45 2e 20 20 20 | :STY|_OVE. |
|00000610| 20 20 20 20 47 75 69 64 | 65 6c 69 6e 65 73 20 66 | Guid|elines f|
|00000620| 6f 72 20 54 72 69 74 6f | 6e 20 47 55 49 73 0a 0a |or Trito|n GUIs..|
|00000630| 4f 64 64 73 20 26 20 45 | 6e 64 73 0a 0a 2a 20 46 |Odds & E|nds..* F|
|00000640| 41 51 20 20 20 20 20 20 | 20 20 20 20 20 20 20 3a |AQ | :|
|00000650| 4f 44 44 5f 46 41 51 2e | 20 20 20 20 20 20 20 46 |ODD_FAQ.| F|
|00000660| 72 65 71 75 65 6e 74 6c | 79 20 41 73 6b 65 64 20 |requentl|y Asked |
|00000670| 51 75 65 73 74 69 6f 6e | 73 0a 0a 2a 20 49 6e 64 |Question|s..* Ind|
|00000680| 65 78 20 20 20 20 20 20 | 20 20 20 20 20 3a 49 6e |ex | :In|
|00000690| 64 65 78 2e 0a 0a 40 65 | 6e 64 20 6d 65 6e 75 0a |dex...@e|nd menu.|
|000006a0| 0a 40 65 78 61 6d 70 6c | 65 0a 40 2a 0a 40 65 6e |.@exampl|e.@*.@en|
|000006b0| 64 20 65 78 61 6d 70 6c | 65 0a 0a 40 69 66 69 6e |d exampl|e..@ifin|
|000006c0| 66 6f 0a 4e 6f 74 65 20 | 74 68 61 74 20 61 6c 6c |fo.Note |that all|
|000006d0| 20 70 61 67 65 73 20 63 | 61 6e 20 62 65 20 72 65 | pages c|an be re|
|000006e0| 61 63 68 65 64 20 64 69 | 72 65 63 74 6c 79 20 66 |ached di|rectly f|
|000006f0| 72 6f 6d 20 74 68 69 73 | 20 6d 65 6e 75 2c 0a 73 |rom this| menu,.s|
|00000700| 6f 20 74 68 61 74 20 79 | 6f 75 20 6d 61 79 20 63 |o that y|ou may c|
|00000710| 6f 6e 76 65 6e 69 65 6e | 74 6c 79 20 62 72 6f 77 |onvenien|tly brow|
|00000720| 73 65 20 74 68 72 6f 75 | 67 68 20 61 6c 6c 20 69 |se throu|gh all i|
|00000730| 74 65 6d 73 20 69 6e 20 | 74 68 69 73 0a 6d 61 69 |tems in |this.mai|
|00000740| 6e 20 6d 65 6e 75 20 69 | 6e 20 6f 72 64 65 72 20 |n menu i|n order |
|00000750| 74 6f 20 72 65 61 64 20 | 74 68 65 20 65 6e 74 69 |to read |the enti|
|00000760| 72 65 20 64 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |re docum|entation|
|00000770| 2e 0a 40 65 6e 64 20 69 | 66 69 6e 66 6f 0a 0a 40 |..@end i|finfo..@|
|00000780| 6e 6f 64 65 20 49 4e 54 | 5f 4f 56 45 2c 20 49 4e |node INT|_OVE, IN|
|00000790| 54 5f 4f 4f 50 2c 20 54 | 6f 70 2c 20 54 6f 70 0a |T_OOP, T|op, Top.|
|000007a0| 40 63 68 61 70 74 65 72 | 20 49 6e 74 72 6f 64 75 |@chapter| Introdu|
|000007b0| 63 74 69 6f 6e 0a 40 63 | 69 6e 64 65 78 20 49 6e |ction.@c|index In|
|000007c0| 74 72 6f 64 75 63 74 69 | 6f 6e 0a 40 73 65 63 74 |troducti|on.@sect|
|000007d0| 69 6f 6e 20 4f 76 65 72 | 76 69 65 77 0a 40 63 69 |ion Over|view.@ci|
|000007e0| 6e 64 65 78 20 4f 76 65 | 72 76 69 65 77 0a 0a 54 |ndex Ove|rview..T|
|000007f0| 68 65 20 54 72 69 74 6f | 6e 20 47 55 49 20 63 72 |he Trito|n GUI cr|
|00000800| 65 61 74 69 6f 6e 20 73 | 79 73 74 65 6d 20 6f 66 |eation s|ystem of|
|00000810| 66 65 72 73 20 61 6e 20 | 65 61 73 79 20 77 61 79 |fers an |easy way|
|00000820| 20 74 6f 20 63 72 65 61 | 74 65 20 67 6f 6f 64 20 | to crea|te good |
|00000830| 6c 6f 6f 6b 69 6e 67 0a | 47 55 49 73 20 66 6f 72 |looking.|GUIs for|
|00000840| 20 79 6f 75 72 20 61 70 | 70 6c 69 63 61 74 69 6f | your ap|plicatio|
|00000850| 6e 73 2e 20 49 74 20 63 | 61 6e 20 62 65 20 75 73 |ns. It c|an be us|
|00000860| 65 64 20 77 69 74 68 20 | 61 20 76 61 72 69 65 74 |ed with |a variet|
|00000870| 79 20 6f 66 0a 70 72 6f | 67 72 61 6d 6d 69 6e 67 |y of.pro|gramming|
|00000880| 20 6c 61 6e 67 75 61 67 | 65 73 2e 20 43 75 72 72 | languag|es. Curr|
|00000890| 65 6e 74 6c 79 20 73 75 | 70 70 6f 72 74 65 64 20 |ently su|pported |
|000008a0| 61 72 65 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |are the |followin|
|000008b0| 67 20 6c 61 6e 67 75 61 | 67 65 73 0a 61 6e 64 20 |g langua|ges.and |
|000008c0| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 73 79 73 74 |developm|ent syst|
|000008d0| 65 6d 73 3a 0a 0a 40 69 | 74 65 6d 69 7a 65 20 40 |ems:..@i|temize @|
|000008e0| 62 75 6c 6c 65 74 0a 40 | 69 74 65 6d 0a 43 20 28 |bullet.@|item.C (|
|000008f0| 53 41 53 2f 43 20 36 2e | 35 30 2b 2c 20 47 43 43 |SAS/C 6.|50+, GCC|
|00000900| 20 28 74 65 73 74 65 64 | 20 77 69 74 68 20 32 2e | (tested| with 2.|
|00000910| 35 2e 38 20 61 6e 64 20 | 32 2e 36 2e 30 29 2c 20 |5.8 and |2.6.0), |
|00000920| 44 49 43 45 29 0a 40 69 | 74 65 6d 0a 4f 62 65 72 |DICE).@i|tem.Ober|
|00000930| 6f 6e 20 28 41 6d 69 67 | 61 4f 62 65 72 6f 6e 29 |on (Amig|aOberon)|
|00000940| 0a 40 69 74 65 6d 0a 4d | 6f 64 75 6c 61 2d 32 20 |.@item.M|odula-2 |
|00000950| 28 4d 32 41 6d 69 67 61 | 29 0a 40 69 74 65 6d 0a |(M2Amiga|).@item.|
|00000960| 45 20 28 41 6d 69 67 61 | 45 29 0a 40 69 74 65 6d |E (Amiga|E).@item|
|00000970| 0a 41 73 73 65 6d 62 6c | 65 72 0a 40 69 74 65 6d |.Assembl|er.@item|
|00000980| 0a 42 61 73 69 63 20 28 | 42 6c 69 74 7a 42 61 73 |.Basic (|BlitzBas|
|00000990| 69 63 29 0a 40 69 74 65 | 6d 0a 50 61 73 63 61 6c |ic).@ite|m.Pascal|
|000009a0| 20 28 4b 69 63 6b 50 61 | 73 63 61 6c 2c 20 4d 61 | (KickPa|scal, Ma|
|000009b0| 78 6f 6e 50 61 73 63 61 | 6c 29 0a 0a 4e 6f 74 65 |xonPasca|l)..Note|
|000009c0| 20 74 68 61 74 20 74 68 | 65 20 50 61 73 63 61 6c | that th|e Pascal|
|000009d0| 20 69 6e 74 65 72 66 61 | 63 65 73 0a 61 72 65 20 | interfa|ces.are |
|000009e0| 6e 6f 74 20 79 65 74 20 | 69 6e 63 6c 75 64 65 64 |not yet |included|
|000009f0| 20 69 6e 20 74 68 69 73 | 20 72 65 6c 65 61 73 65 | in this| release|
|00000a00| 20 6f 66 20 74 68 65 20 | 54 72 69 74 6f 6e 20 64 | of the |Triton d|
|00000a10| 65 76 65 6c 6f 70 65 72 | 0a 70 61 63 6b 61 67 65 |eveloper|.package|
|00000a20| 2e 20 50 6c 65 61 73 65 | 20 63 6f 6e 74 61 63 74 |. Please| contact|
|00000a30| 20 74 68 65 20 61 75 74 | 68 6f 72 20 28 53 6f 74 | the aut|hor (Sot|
|00000a40| 69 72 69 6f 73 20 50 61 | 70 70 61 73 20 3c 73 6f |irios Pa|ppas <so|
|00000a50| 74 74 6f 40 40 74 72 6b | 70 6f 6f 6c 2e 72 68 65 |tto@@trk|pool.rhe|
|00000a60| 69 6e 2d 72 75 68 72 2e | 64 65 3e 29 20 64 69 72 |in-ruhr.|de>) dir|
|00000a70| 65 63 74 6c 79 2e 0a 40 | 65 6e 64 20 69 74 65 6d |ectly..@|end item|
|00000a80| 69 7a 65 0a 0a 28 49 66 | 20 79 6f 75 20 63 72 65 |ize..(If| you cre|
|00000a90| 61 74 65 20 61 20 54 72 | 69 74 6f 6e 20 73 75 70 |ate a Tr|iton sup|
|00000aa0| 70 6f 72 74 20 73 79 73 | 74 65 6d 20 66 6f 72 20 |port sys|tem for |
|00000ab0| 61 6e 79 20 6f 74 68 65 | 72 20 6c 61 6e 67 75 61 |any othe|r langua|
|00000ac0| 67 65 20 6f 72 0a 64 65 | 76 65 6c 6f 70 6d 65 6e |ge or.de|velopmen|
|00000ad0| 74 20 73 79 73 74 65 6d | 20 61 6e 64 20 61 72 65 |t system| and are|
|00000ae0| 20 77 69 6c 6c 69 6e 67 | 20 74 6f 20 6d 61 69 6e | willing| to main|
|00000af0| 74 61 69 6e 20 69 74 20 | 66 6f 72 20 66 75 74 75 |tain it |for futu|
|00000b00| 72 65 0a 75 70 64 61 74 | 65 73 2c 20 70 6c 65 61 |re.updat|es, plea|
|00000b10| 73 65 20 63 6f 6e 74 61 | 63 74 20 6d 65 20 66 6f |se conta|ct me fo|
|00000b20| 72 20 69 6e 63 6c 75 73 | 69 6f 6e 20 69 6e 74 6f |r inclus|ion into|
|00000b30| 20 74 68 65 20 6d 61 69 | 6e 20 54 72 69 74 6f 6e | the mai|n Triton|
|00000b40| 0a 44 65 76 65 6c 6f 70 | 65 72 20 64 69 73 74 72 |.Develop|er distr|
|00000b50| 69 62 75 74 69 6f 6e 2e | 29 0a 0a 54 68 69 73 20 |ibution.|)..This |
|00000b60| 64 6f 63 75 6d 65 6e 74 | 20 64 65 73 63 72 69 62 |document| describ|
|00000b70| 65 73 20 68 6f 77 20 74 | 6f 20 75 73 65 20 54 72 |es how t|o use Tr|
|00000b80| 69 74 6f 6e 20 69 6e 20 | 79 6f 75 72 20 6f 77 6e |iton in |your own|
|00000b90| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 0a 62 79 | applica|tions.by|
|00000ba0| 20 70 72 6f 76 69 64 69 | 6e 67 20 79 6f 75 20 77 | providi|ng you w|
|00000bb0| 69 74 68 20 73 6f 6d 65 | 20 6f 76 65 72 76 69 65 |ith some| overvie|
|00000bc0| 77 20 74 6f 70 69 63 73 | 20 61 6e 64 20 61 20 73 |w topics| and a s|
|00000bd0| 74 65 70 20 62 79 20 73 | 74 65 70 0a 69 6e 74 72 |tep by s|tep.intr|
|00000be0| 6f 64 75 63 74 69 6f 6e | 2e 20 49 74 20 64 6f 65 |oduction|. It doe|
|00000bf0| 73 20 40 73 74 72 6f 6e | 67 7b 6e 6f 74 7d 20 64 |s @stron|g{not} d|
|00000c00| 65 73 63 72 69 62 65 20 | 69 6e 20 64 65 74 61 69 |escribe |in detai|
|00000c10| 6c 20 74 68 65 20 66 75 | 6e 63 74 69 6f 6e 73 2c |l the fu|nctions,|
|00000c20| 0a 73 74 72 75 63 74 75 | 72 65 73 2c 20 74 61 67 |.structu|res, tag|
|00000c30| 73 2c 20 65 74 63 40 2e | 20 77 68 69 63 68 20 61 |s, etc@.| which a|
|00000c40| 72 65 20 75 73 65 64 2c | 20 73 6f 20 79 6f 75 20 |re used,| so you |
|00000c50| 73 68 6f 75 6c 64 20 61 | 6c 77 61 79 73 20 6c 6f |should a|lways lo|
|00000c60| 6f 6b 0a 74 68 65 6d 20 | 75 70 20 69 6e 20 74 68 |ok.them |up in th|
|00000c70| 65 20 61 75 74 6f 64 6f | 63 73 20 66 69 6c 65 20 |e autodo|cs file |
|00000c80| 28 73 65 65 20 40 72 65 | 66 7b 49 4e 54 5f 41 55 |(see @re|f{INT_AU|
|00000c90| 54 2c 20 41 75 74 6f 64 | 6f 63 73 2c 20 49 6e 74 |T, Autod|ocs, Int|
|00000ca0| 72 6f 64 75 63 74 69 6f | 6e 20 2d 20 41 75 74 6f |roductio|n - Auto|
|00000cb0| 64 6f 63 73 7d 29 0a 61 | 6e 64 20 74 68 65 20 43 |docs}).a|nd the C|
|00000cc0| 20 68 65 61 64 65 72 20 | 66 69 6c 65 20 40 66 69 | header |file @fi|
|00000cd0| 6c 65 7b 44 65 76 65 6c | 6f 70 65 72 2f 49 6e 63 |le{Devel|oper/Inc|
|00000ce0| 6c 75 64 65 2f 6c 69 62 | 72 61 72 69 65 73 2f 74 |lude/lib|raries/t|
|00000cf0| 72 69 74 6f 6e 2e 68 7d | 2e 0a 0a 54 68 65 20 65 |riton.h}|...The e|
|00000d00| 78 61 6d 70 6c 65 73 20 | 69 6e 20 74 68 69 73 20 |xamples |in this |
|00000d10| 64 6f 63 75 6d 65 6e 74 | 20 61 73 73 75 6d 65 20 |document| assume |
|00000d20| 74 68 61 74 20 79 6f 75 | 27 72 65 20 75 73 69 6e |that you|'re usin|
|00000d30| 67 20 74 68 65 20 43 20 | 73 75 70 70 6f 72 74 0a |g the C |support.|
|00000d40| 66 69 6c 65 73 20 77 69 | 74 68 20 74 68 65 20 53 |files wi|th the S|
|00000d50| 41 53 2f 43 20 63 6f 6d | 70 69 6c 65 72 2e 20 54 |AS/C com|piler. T|
|00000d60| 68 65 72 65 20 6d 61 79 | 20 62 65 20 64 69 66 66 |here may| be diff|
|00000d70| 65 72 65 6e 63 65 73 20 | 69 6e 20 6f 74 68 65 72 |erences |in other|
|00000d80| 0a 6c 61 6e 67 75 61 67 | 65 73 20 6f 72 20 65 76 |.languag|es or ev|
|00000d90| 65 6e 20 77 69 74 68 20 | 6f 74 68 65 72 20 43 20 |en with |other C |
|00000da0| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 73 79 73 74 |developm|ent syst|
|00000db0| 65 6d 73 2e 0a 0a 40 6e | 6f 64 65 20 49 4e 54 5f |ems...@n|ode INT_|
|00000dc0| 4f 4f 50 2c 20 49 4e 54 | 5f 43 4c 41 2c 20 49 4e |OOP, INT|_CLA, IN|
|00000dd0| 54 5f 4f 56 45 2c 20 54 | 6f 70 0a 40 73 65 63 74 |T_OVE, T|op.@sect|
|00000de0| 69 6f 6e 20 4f 4f 50 20 | 49 6e 74 65 72 6e 61 6c |ion OOP |Internal|
|00000df0| 73 0a 40 63 69 6e 64 65 | 78 20 4f 4f 50 20 49 6e |s.@cinde|x OOP In|
|00000e00| 74 65 72 6e 61 6c 73 0a | 0a 41 6c 74 68 6f 75 67 |ternals.|.Althoug|
|00000e10| 68 20 54 72 69 74 6f 6e | 20 6f 66 66 65 72 73 20 |h Triton| offers |
|00000e20| 61 20 6d 6f 73 74 6c 79 | 20 70 72 6f 63 65 64 75 |a mostly| procedu|
|00000e30| 72 61 6c 20 41 50 49 2c | 20 69 74 20 69 73 20 62 |ral API,| it is b|
|00000e40| 61 73 65 64 20 6f 6e 20 | 61 6e 0a 6f 62 6a 65 63 |ased on |an.objec|
|00000e50| 74 2d 6f 72 69 65 6e 74 | 65 64 20 73 79 73 74 65 |t-orient|ed syste|
|00000e60| 6d 2e 20 41 73 20 61 20 | 54 72 69 74 6f 6e 20 75 |m. As a |Triton u|
|00000e70| 73 65 72 20 79 6f 75 20 | 77 69 6c 6c 20 6e 65 76 |ser you |will nev|
|00000e80| 65 72 20 73 65 65 20 54 | 72 69 74 6f 6e 0a 6f 62 |er see T|riton.ob|
|00000e90| 6a 65 63 74 73 20 64 69 | 72 65 63 74 6c 79 2c 20 |jects di|rectly, |
|00000ea0| 62 75 74 20 69 6e 73 74 | 65 61 64 20 72 65 66 65 |but inst|ead refe|
|00000eb0| 72 65 6e 63 65 20 74 68 | 65 6d 20 74 68 72 6f 75 |rence th|em throu|
|00000ec0| 67 68 20 49 44 73 2e 0a | 0a 40 6e 6f 64 65 20 49 |gh IDs..|.@node I|
|00000ed0| 4e 54 5f 43 4c 41 2c 20 | 49 4e 54 5f 41 55 54 2c |NT_CLA, |INT_AUT,|
|00000ee0| 20 49 4e 54 5f 4f 4f 50 | 2c 20 54 6f 70 0a 40 73 | INT_OOP|, Top.@s|
|00000ef0| 65 63 74 69 6f 6e 20 43 | 6c 61 73 73 20 54 72 65 |ection C|lass Tre|
|00000f00| 65 0a 40 63 69 6e 64 65 | 78 20 43 6c 61 73 73 20 |e.@cinde|x Class |
|00000f10| 54 72 65 65 0a 0a 54 68 | 65 20 66 6f 6c 6c 6f 77 |Tree..Th|e follow|
|00000f20| 69 6e 67 20 63 6c 61 73 | 73 65 73 20 61 72 65 20 |ing clas|ses are |
|00000f30| 61 76 61 69 6c 61 62 6c | 65 20 69 6e 20 54 72 69 |availabl|e in Tri|
|00000f40| 74 6f 6e 3a 0a 0a 40 65 | 78 61 6d 70 6c 65 0a 20 |ton:..@e|xample. |
|00000f50| 20 20 20 4f 62 6a 65 63 | 74 20 20 20 20 20 20 20 | Objec|t |
|00000f60| 20 20 20 20 20 20 20 20 | 20 20 20 41 62 73 74 72 | | Abstr|
|00000f70| 61 63 74 20 72 6f 6f 74 | 20 63 6c 61 73 73 0a 20 |act root| class. |
|00000f80| 20 20 20 60 2d 2d 20 44 | 69 73 70 6c 61 79 4f 62 | `-- D|isplayOb|
|00000f90| 6a 65 63 74 20 20 20 20 | 20 20 20 41 62 73 74 72 |ject | Abstr|
|00000fa0| 61 63 74 20 63 6c 61 73 | 73 20 66 6f 72 20 77 69 |act clas|s for wi|
|00000fb0| 6e 64 6f 77 20 63 6f 6e | 74 65 6e 74 73 0a 20 20 |ndow con|tents. |
|00000fc0| 20 20 20 20 20 20 2b 2d | 2d 20 42 75 74 74 6f 6e | +-|- Button|
|00000fd0| 20 20 20 20 20 20 20 20 | 20 20 42 4f 4f 50 53 49 | | BOOPSI|
|00000fe0| 20 62 75 74 74 6f 6e 20 | 67 61 64 67 65 74 0a 20 | button |gadget. |
|00000ff0| 20 20 20 20 20 20 20 2b | 2d 2d 20 43 68 65 63 6b | +|-- Check|
|00001000| 42 6f 78 20 20 20 20 20 | 20 20 20 47 61 64 54 6f |Box | GadTo|
|00001010| 6f 6c 73 20 43 68 65 63 | 6b 42 6f 78 0a 20 20 20 |ols Chec|kBox. |
|00001020| 20 20 20 20 20 2b 2d 2d | 20 43 79 63 6c 65 20 20 | +--| Cycle |
|00001030| 20 20 20 20 20 20 20 20 | 20 47 61 64 54 6f 6f 6c | | GadTool|
|00001040| 73 20 43 79 63 6c 65 20 | 61 6e 64 20 4d 58 20 67 |s Cycle |and MX g|
|00001050| 61 64 67 65 74 0a 20 20 | 20 20 20 20 20 20 2b 2d |adget. | +-|
|00001060| 2d 20 44 72 6f 70 42 6f | 78 20 20 20 20 20 20 20 |- DropBo|x |
|00001070| 20 20 41 70 70 49 63 6f | 6e 20 64 72 6f 70 70 69 | AppIco|n droppi|
|00001080| 6e 67 20 62 6f 78 0a 20 | 20 20 20 20 20 20 20 2b |ng box. | +|
|00001090| 2d 2d 20 46 72 61 6d 65 | 42 6f 78 20 20 20 20 20 |-- Frame|Box |
|000010a0| 20 20 20 46 72 61 6d 69 | 6e 67 20 6f 72 20 67 72 | Frami|ng or gr|
|000010b0| 6f 75 70 69 6e 67 20 62 | 6f 78 0a 20 20 20 20 20 |ouping b|ox. |
|000010c0| 20 20 20 2b 2d 2d 20 47 | 72 6f 75 70 20 20 20 20 | +-- G|roup |
|000010d0| 20 20 20 20 20 20 20 54 | 72 69 74 6f 6e 27 73 20 | T|riton's |
|000010e0| 6c 61 79 6f 75 74 20 65 | 6e 67 69 6e 65 0a 20 20 |layout e|ngine. |
|000010f0| 20 20 20 20 20 20 2b 2d | 2d 20 49 6d 61 67 65 20 | +-|- Image |
|00001100| 20 20 20 20 20 20 20 20 | 20 20 49 6d 61 67 65 0a | | Image.|
|00001110| 20 20 20 20 20 20 20 20 | 2b 2d 2d 20 4c 69 6e 65 | |+-- Line|
|00001120| 20 20 20 20 20 20 20 20 | 20 20 20 20 33 44 20 6c | | 3D l|
|00001130| 69 6e 65 0a 20 20 20 20 | 20 20 20 20 2b 2d 2d 20 |ine. | +-- |
|00001140| 4c 69 73 74 76 69 65 77 | 20 20 20 20 20 20 20 20 |Listview| |
|00001150| 47 61 64 54 6f 6f 6c 73 | 20 4c 69 73 74 76 69 65 |GadTools| Listvie|
|00001160| 77 0a 20 20 20 20 20 20 | 20 20 2b 2d 2d 20 50 61 |w. | +-- Pa|
|00001170| 6c 65 74 74 65 20 20 20 | 20 20 20 20 20 20 47 61 |lette | Ga|
|00001180| 64 54 6f 6f 6c 73 20 50 | 61 6c 65 74 74 65 20 67 |dTools P|alette g|
|00001190| 61 64 67 65 74 0a 20 20 | 20 20 20 20 20 20 2b 2d |adget. | +-|
|000011a0| 2d 20 50 72 6f 67 72 65 | 73 73 20 20 20 20 20 20 |- Progre|ss |
|000011b0| 20 20 50 72 6f 67 72 65 | 73 73 20 69 6e 64 69 63 | Progre|ss indic|
|000011c0| 61 74 6f 72 0a 20 20 20 | 20 20 20 20 20 2b 2d 2d |ator. | +--|
|000011d0| 20 53 63 72 6f 6c 6c 65 | 72 20 20 20 20 20 20 20 | Scrolle|r |
|000011e0| 20 47 61 64 54 6f 6f 6c | 73 20 53 63 72 6f 6c 6c | GadTool|s Scroll|
|000011f0| 65 72 0a 20 20 20 20 20 | 20 20 20 2b 2d 2d 20 53 |er. | +-- S|
|00001200| 6c 69 64 65 72 20 20 20 | 20 20 20 20 20 20 20 47 |lider | G|
|00001210| 61 64 54 6f 6f 6c 73 20 | 53 6c 69 64 65 72 0a 20 |adTools |Slider. |
|00001220| 20 20 20 20 20 20 20 2b | 2d 2d 20 53 70 61 63 65 | +|-- Space|
|00001230| 20 20 20 20 20 20 20 20 | 20 20 20 45 6d 70 74 79 | | Empty|
|00001240| 20 73 70 61 63 65 0a 20 | 20 20 20 20 20 20 20 2b | space. | +|
|00001250| 2d 2d 20 53 74 72 69 6e | 67 20 20 20 20 20 20 20 |-- Strin|g |
|00001260| 20 20 20 47 61 64 54 6f | 6f 6c 73 20 53 74 72 69 | GadTo|ols Stri|
|00001270| 6e 67 20 67 61 64 67 65 | 74 0a 20 20 20 20 20 20 |ng gadge|t. |
|00001280| 20 20 60 2d 2d 20 54 65 | 78 74 20 20 20 20 20 20 | `-- Te|xt |
|00001290| 20 20 20 20 20 20 54 65 | 78 74 0a 40 65 6e 64 20 | Te|xt.@end |
|000012a0| 65 78 61 6d 70 6c 65 0a | 0a 44 65 73 63 72 69 70 |example.|.Descrip|
|000012b0| 74 69 6f 6e 73 20 66 6f | 72 20 61 6c 6c 20 63 6c |tions fo|r all cl|
|000012c0| 61 73 73 65 73 20 63 61 | 6e 20 62 65 20 66 6f 75 |asses ca|n be fou|
|000012d0| 6e 64 20 69 6e 20 74 68 | 65 20 54 72 69 74 6f 6e |nd in th|e Triton|
|000012e0| 20 61 75 74 6f 64 6f 63 | 73 0a 28 73 65 65 20 40 | autodoc|s.(see @|
|000012f0| 72 65 66 7b 49 4e 54 5f | 41 55 54 2c 20 41 75 74 |ref{INT_|AUT, Aut|
|00001300| 6f 64 6f 63 73 2c 20 49 | 6e 74 72 6f 64 75 63 74 |odocs, I|ntroduct|
|00001310| 69 6f 6e 20 2d 20 41 75 | 74 6f 64 6f 63 73 7d 29 |ion - Au|todocs})|
|00001320| 0a 75 6e 64 65 72 20 40 | 63 6f 64 65 7b 74 72 69 |.under @|code{tri|
|00001330| 74 6f 6e 2e 6c 69 62 72 | 61 72 79 2f 63 6c 61 73 |ton.libr|ary/clas|
|00001340| 73 5f 3c 63 6c 61 73 73 | 6e 61 6d 65 3e 7d 2e 0a |s_<class|name>}..|
|00001350| 0a 40 6e 6f 64 65 20 49 | 4e 54 5f 41 55 54 2c 20 |.@node I|NT_AUT, |
|00001360| 54 55 54 5f 41 50 50 2c | 20 49 4e 54 5f 43 4c 41 |TUT_APP,| INT_CLA|
|00001370| 2c 20 54 6f 70 0a 40 73 | 65 63 74 69 6f 6e 20 41 |, Top.@s|ection A|
|00001380| 75 74 6f 64 6f 63 73 0a | 40 63 69 6e 64 65 78 20 |utodocs.|@cindex |
|00001390| 41 75 74 6f 64 6f 63 73 | 0a 0a 44 6f 63 75 6d 65 |Autodocs|..Docume|
|000013a0| 6e 74 61 74 69 6f 6e 20 | 6f 6e 20 61 6c 6c 20 54 |ntation |on all T|
|000013b0| 72 69 74 6f 6e 20 63 6c | 61 73 73 65 73 20 61 6e |riton cl|asses an|
|000013c0| 64 20 40 66 69 6c 65 7b | 74 72 69 74 6f 6e 2e 6c |d @file{|triton.l|
|000013d0| 69 62 72 61 72 79 7d 20 | 66 75 6e 63 74 69 6f 6e |ibrary} |function|
|000013e0| 73 20 63 61 6e 20 62 65 | 0a 66 6f 75 6e 64 20 69 |s can be|.found i|
|000013f0| 6e 20 74 68 65 20 54 72 | 69 74 6f 6e 20 61 75 74 |n the Tr|iton aut|
|00001400| 6f 64 6f 63 73 20 66 69 | 6c 65 20 40 66 69 6c 65 |odocs fi|le @file|
|00001410| 7b 44 65 76 65 6c 6f 70 | 65 72 2f 41 75 74 6f 64 |{Develop|er/Autod|
|00001420| 6f 63 73 2f 74 72 69 74 | 6f 6e 2e 64 6f 63 7d 2e |ocs/trit|on.doc}.|
|00001430| 20 54 68 65 0a 66 75 6e | 63 74 69 6f 6e 20 64 65 | The.fun|ction de|
|00001440| 73 63 72 69 70 74 69 6f | 6e 73 20 66 6f 6c 6c 6f |scriptio|ns follo|
|00001450| 77 20 74 68 65 20 75 73 | 75 61 6c 20 73 79 6e 74 |w the us|ual synt|
|00001460| 61 78 20 61 73 20 75 73 | 65 64 20 69 6e 20 74 68 |ax as us|ed in th|
|00001470| 65 20 41 6d 69 67 61 4f | 53 20 61 75 74 6f 64 6f |e AmigaO|S autodo|
|00001480| 63 73 2e 0a 54 68 65 20 | 54 72 69 74 6f 6e 20 63 |cs..The |Triton c|
|00001490| 6c 61 73 73 65 73 20 61 | 72 65 20 6c 69 73 74 65 |lasses a|re liste|
|000014a0| 64 20 77 69 74 68 20 74 | 68 65 20 70 72 65 66 69 |d with t|he prefi|
|000014b0| 78 20 40 63 6f 64 65 7b | 74 72 69 74 6f 6e 2e 6c |x @code{|triton.l|
|000014c0| 69 62 72 61 72 79 2f 63 | 6c 61 73 73 5f 7d 20 61 |ibrary/c|lass_} a|
|000014d0| 6e 64 0a 61 72 65 20 64 | 65 73 63 72 69 62 65 64 |nd.are d|escribed|
|000014e0| 20 75 73 69 6e 67 20 74 | 68 65 20 66 6f 6c 6c 6f | using t|he follo|
|000014f0| 77 69 6e 67 20 6b 65 79 | 77 6f 72 64 73 3a 0a 0a |wing key|words:..|
|00001500| 40 69 74 65 6d 69 7a 65 | 20 40 62 75 6c 6c 65 74 |@itemize| @bullet|
|00001510| 0a 40 69 74 65 6d 20 40 | 63 6f 64 65 7b 4e 41 4d |.@item @|code{NAM|
|00001520| 45 7d 0a 0a 54 68 65 20 | 6e 61 6d 65 20 6f 66 20 |E}..The |name of |
|00001530| 74 68 65 20 63 6c 61 73 | 73 20 61 6e 64 20 61 20 |the clas|s and a |
|00001540| 73 68 6f 72 74 20 64 65 | 73 63 72 69 70 74 69 6f |short de|scriptio|
|00001550| 6e 2e 0a 40 69 74 65 6d | 20 40 63 6f 64 65 7b 53 |n..@item| @code{S|
|00001560| 55 50 45 52 43 4c 41 53 | 53 7d 0a 0a 54 68 65 20 |UPERCLAS|S}..The |
|00001570| 73 75 70 65 72 63 6c 61 | 73 73 2e 20 49 66 20 74 |supercla|ss. If t|
|00001580| 68 65 20 63 6f 6d 6d 65 | 6e 74 20 40 63 6f 64 65 |he comme|nt @code|
|00001590| 7b 28 6e 6f 20 61 74 74 | 72 69 62 75 74 65 73 20 |{(no att|ributes |
|000015a0| 69 6e 68 65 72 69 74 65 | 64 29 7d 20 69 73 20 61 |inherite|d)} is a|
|000015b0| 64 64 65 64 2c 0a 61 6c | 6c 20 61 74 74 72 69 62 |dded,.al|l attrib|
|000015c0| 75 74 65 73 20 28 73 65 | 65 20 62 65 6c 6f 77 29 |utes (se|e below)|
|000015d0| 20 61 72 65 20 64 65 73 | 63 72 69 62 65 64 20 69 | are des|cribed i|
|000015e0| 6e 20 74 68 69 73 20 61 | 75 74 6f 64 6f 63 20 63 |n this a|utodoc c|
|000015f0| 6c 69 70 2e 20 4f 74 68 | 65 72 77 69 73 65 0a 61 |lip. Oth|erwise.a|
|00001600| 6c 6c 20 61 74 74 72 69 | 62 75 74 65 73 20 6f 66 |ll attri|butes of|
|00001610| 20 74 68 65 20 73 75 70 | 65 72 63 6c 61 73 73 20 | the sup|erclass |
|00001620| 61 72 65 20 69 6e 68 65 | 72 69 74 65 64 2e 0a 40 |are inhe|rited..@|
|00001630| 69 74 65 6d 20 40 63 6f | 64 65 7b 53 59 4e 4f 50 |item @co|de{SYNOP|
|00001640| 53 49 53 7d 0a 0a 54 68 | 65 20 74 61 67 73 20 77 |SIS}..Th|e tags w|
|00001650| 68 69 63 68 20 69 6e 76 | 6f 6b 65 20 74 68 65 20 |hich inv|oke the |
|00001660| 63 72 65 61 74 69 6f 6e | 20 6f 66 20 61 6e 20 69 |creation| of an i|
|00001670| 6e 73 74 61 6e 63 65 20 | 6f 66 20 74 68 65 20 63 |nstance |of the c|
|00001680| 6c 61 73 73 2e 0a 40 69 | 74 65 6d 20 40 63 6f 64 |lass..@i|tem @cod|
|00001690| 65 7b 41 54 54 52 49 42 | 55 54 45 53 7d 0a 0a 54 |e{ATTRIB|UTES}..T|
|000016a0| 68 65 20 61 74 74 72 69 | 62 75 74 65 73 20 77 68 |he attri|butes wh|
|000016b0| 69 63 68 20 61 72 65 20 | 63 72 65 61 74 65 64 20 |ich are |created |
|000016c0| 66 6f 72 20 65 76 65 72 | 79 20 69 6e 73 74 61 6e |for ever|y instan|
|000016d0| 63 65 20 6f 66 20 74 68 | 65 20 63 6c 61 73 73 2e |ce of th|e class.|
|000016e0| 20 41 6c 6c 0a 61 74 74 | 72 69 62 75 74 65 73 20 | All.att|ributes |
|000016f0| 61 72 65 20 6c 69 73 74 | 65 64 20 77 69 74 68 20 |are list|ed with |
|00001700| 74 68 65 69 72 20 74 61 | 67 20 6e 61 6d 65 73 2c |their ta|g names,|
|00001710| 20 65 78 63 65 70 74 20 | 66 6f 72 20 74 68 65 20 | except |for the |
|00001720| 64 65 66 61 75 6c 74 0a | 61 74 74 72 69 62 75 74 |default.|attribut|
|00001730| 65 20 77 68 69 63 68 20 | 69 73 20 6c 69 73 74 65 |e which |is liste|
|00001740| 64 20 61 73 20 40 63 6f | 64 65 7b 3c 44 65 66 61 |d as @co|de{<Defa|
|00001750| 75 6c 74 3e 7d 2e 20 53 | 65 65 20 61 62 6f 76 65 |ult>}. S|ee above|
|00001760| 20 66 6f 72 20 73 75 70 | 65 72 63 6c 61 73 73 0a | for sup|erclass.|
|00001770| 61 74 74 72 69 62 75 74 | 65 73 2e 0a 40 69 74 65 |attribut|es..@ite|
|00001780| 6d 20 40 63 6f 64 65 7b | 4d 45 53 53 41 47 45 53 |m @code{|MESSAGES|
|00001790| 7d 0a 0a 54 68 69 73 20 | 73 65 63 74 69 6f 6e 20 |}..This |section |
|000017a0| 64 65 73 63 72 69 62 65 | 73 20 61 6c 6c 20 6d 65 |describe|s all me|
|000017b0| 73 73 61 67 65 73 20 77 | 68 69 63 68 20 6f 62 6a |ssages w|hich obj|
|000017c0| 65 63 74 73 20 6f 66 20 | 74 68 69 73 20 63 6c 61 |ects of |this cla|
|000017d0| 73 73 20 61 72 65 20 63 | 75 72 72 65 6e 74 6c 79 |ss are c|urrently|
|000017e0| 0a 61 62 6c 65 20 74 6f | 20 73 65 6e 64 2e 20 49 |.able to| send. I|
|000017f0| 66 20 6e 6f 20 6d 65 73 | 73 61 67 65 73 20 61 72 |f no mes|sages ar|
|00001800| 65 20 64 65 73 63 72 69 | 62 65 64 2c 20 74 68 69 |e descri|bed, thi|
|00001810| 73 20 64 6f 65 73 6e 27 | 74 20 6d 65 61 6e 20 74 |s doesn'|t mean t|
|00001820| 68 61 74 20 6e 6f 6e 65 | 20 61 72 65 0a 73 65 6e |hat none| are.sen|
|00001830| 74 2e 20 4e 6f 74 20 61 | 6c 6c 20 63 6c 61 73 73 |t. Not a|ll class|
|00001840| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 73 20 68 61 | descrip|tions ha|
|00001850| 76 65 20 74 68 69 73 20 | 73 65 63 74 69 6f 6e 20 |ve this |section |
|00001860| 79 65 74 2e 0a 40 65 6e | 64 20 69 74 65 6d 69 7a |yet..@en|d itemiz|
|00001870| 65 0a 0a 40 6e 6f 64 65 | 20 54 55 54 5f 41 50 50 |e..@node| TUT_APP|
|00001880| 2c 20 54 55 54 5f 50 52 | 4f 2c 20 49 4e 54 5f 41 |, TUT_PR|O, INT_A|
|00001890| 55 54 2c 20 54 6f 70 0a | 40 63 68 61 70 74 65 72 |UT, Top.|@chapter|
|000018a0| 20 54 75 74 6f 72 69 61 | 6c 0a 40 63 69 6e 64 65 | Tutoria|l.@cinde|
|000018b0| 78 20 54 75 74 6f 72 69 | 61 6c 0a 40 73 65 63 74 |x Tutori|al.@sect|
|000018c0| 69 6f 6e 20 41 70 70 6c | 69 63 61 74 69 6f 6e 73 |ion Appl|ications|
|000018d0| 0a 40 63 69 6e 64 65 78 | 20 41 70 70 6c 69 63 61 |.@cindex| Applica|
|000018e0| 74 69 6f 6e 73 0a 0a 49 | 6e 20 6f 72 64 65 72 20 |tions..I|n order |
|000018f0| 74 6f 20 75 73 65 20 40 | 66 69 6c 65 7b 74 72 69 |to use @|file{tri|
|00001900| 74 6f 6e 2e 6c 69 62 72 | 61 72 79 7d 20 79 6f 75 |ton.libr|ary} you|
|00001910| 20 6d 75 73 74 20 66 69 | 72 73 74 20 6f 66 20 61 | must fi|rst of a|
|00001920| 6c 6c 20 6f 70 65 6e 20 | 69 74 2c 20 6c 69 6b 65 |ll open |it, like|
|00001930| 20 61 6e 79 20 6f 74 68 | 65 72 0a 73 68 61 72 65 | any oth|er.share|
|00001940| 64 20 6c 69 62 72 61 72 | 79 2c 20 61 73 20 64 65 |d librar|y, as de|
|00001950| 73 63 72 69 62 65 64 20 | 69 6e 20 74 68 65 20 40 |scribed |in the @|
|00001960| 63 6f 64 65 7b 41 6d 69 | 67 61 20 52 4f 4d 20 4b |code{Ami|ga ROM K|
|00001970| 65 72 6e 65 6c 20 52 65 | 66 65 72 65 6e 63 65 20 |ernel Re|ference |
|00001980| 4d 61 6e 75 61 6c 7d 2c | 0a 76 6f 6c 75 6d 65 20 |Manual},|.volume |
|00001990| 40 63 6f 64 65 7b 4c 69 | 62 72 61 72 69 65 73 7d |@code{Li|braries}|
|000019a0| 2e 20 42 65 66 6f 72 65 | 20 71 75 69 74 74 69 6e |. Before| quittin|
|000019b0| 67 2c 20 79 6f 75 20 68 | 61 76 65 20 74 6f 20 63 |g, you h|ave to c|
|000019c0| 6c 6f 73 65 20 69 74 20 | 61 67 61 69 6e 2e 20 53 |lose it |again. S|
|000019d0| 69 6e 63 65 0a 72 65 6c | 65 61 73 65 20 31 2e 31 |ince.rel|ease 1.1|
|000019e0| 20 40 66 69 6c 65 7b 74 | 72 69 74 6f 6e 2e 6c 69 | @file{t|riton.li|
|000019f0| 62 72 61 72 79 7d 20 69 | 73 20 61 20 73 69 6e 67 |brary} i|s a sing|
|00001a00| 6c 65 2d 62 61 73 65 20 | 6c 69 62 72 61 72 79 2c |le-base |library,|
|00001a10| 20 73 6f 20 79 6f 75 20 | 63 61 6e 20 73 68 61 72 | so you |can shar|
|00001a20| 65 20 6f 6e 65 0a 69 6e | 73 74 61 6e 63 65 20 6f |e one.in|stance o|
|00001a30| 66 20 40 66 69 6c 65 7b | 74 72 69 74 6f 6e 2e 6c |f @file{|triton.l|
|00001a40| 69 62 72 61 72 79 7d 20 | 62 65 74 77 65 65 6e 20 |ibrary} |between |
|00001a50| 73 65 76 65 72 61 6c 20 | 74 61 73 6b 73 2e 20 54 |several |tasks. T|
|00001a60| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 63 6f 64 |he follo|wing cod|
|00001a70| 65 20 6d 61 6b 65 73 20 | 73 75 72 65 0a 74 68 61 |e makes |sure.tha|
|00001a80| 74 20 79 6f 75 20 63 61 | 6e 20 75 73 65 20 66 75 |t you ca|n use fu|
|00001a90| 6e 63 74 69 6f 6e 73 20 | 66 72 6f 6d 20 40 66 69 |nctions |from @fi|
|00001aa0| 6c 65 7b 74 72 69 74 6f | 6e 2e 6c 69 62 72 61 72 |le{trito|n.librar|
|00001ab0| 79 7d 20 72 65 6c 65 61 | 73 65 20 31 2e 32 20 6f |y} relea|se 1.2 o|
|00001ac0| 72 20 68 69 67 68 65 72 | 3a 0a 0a 40 65 78 61 6d |r higher|:..@exam|
|00001ad0| 70 6c 65 0a 20 20 20 20 | 23 69 6e 63 6c 75 64 65 |ple. |#include|
|00001ae0| 20 3c 6c 69 62 72 61 72 | 69 65 73 2f 74 72 69 74 | <librar|ies/trit|
|00001af0| 6f 6e 2e 68 3e 0a 20 20 | 20 20 23 69 6e 63 6c 75 |on.h>. | #inclu|
|00001b00| 64 65 20 3c 63 6c 69 62 | 2f 74 72 69 74 6f 6e 5f |de <clib|/triton_|
|00001b10| 70 72 6f 74 6f 73 2e 68 | 3e 0a 20 20 20 20 23 69 |protos.h|>. #i|
|00001b20| 6e 63 6c 75 64 65 20 3c | 70 72 61 67 6d 61 73 2f |nclude <|pragmas/|
|00001b30| 74 72 69 74 6f 6e 5f 70 | 72 61 67 6d 61 73 2e 68 |triton_p|ragmas.h|
|00001b40| 3e 0a 0a 20 20 20 20 73 | 74 72 75 63 74 20 4c 69 |>.. s|truct Li|
|00001b50| 62 72 61 72 79 20 2a 54 | 72 69 74 6f 6e 42 61 73 |brary *T|ritonBas|
|00001b60| 65 3b 0a 0a 20 20 20 20 | 69 6e 74 20 6d 61 69 6e |e;.. |int main|
|00001b70| 28 76 6f 69 64 29 0a 20 | 20 20 20 40 7b 0a 20 20 |(void). | @{. |
|00001b80| 20 20 20 20 69 66 28 54 | 72 69 74 6f 6e 42 61 73 | if(T|ritonBas|
|00001b90| 65 3d 4f 70 65 6e 4c 69 | 62 72 61 72 79 28 54 52 |e=OpenLi|brary(TR|
|00001ba0| 49 54 4f 4e 4e 41 4d 45 | 2c 54 52 49 54 4f 4e 31 |ITONNAME|,TRITON1|
|00001bb0| 32 56 45 52 53 49 4f 4e | 29 29 0a 20 20 20 20 20 |2VERSION|)). |
|00001bc0| 20 40 7b 0a 20 20 20 20 | 20 20 20 20 2f 2a 20 55 | @{. | /* U|
|00001bd0| 73 65 20 66 75 6e 63 74 | 69 6f 6e 73 20 66 72 6f |se funct|ions fro|
|00001be0| 6d 20 74 72 69 74 6f 6e | 2e 6c 69 62 72 61 72 79 |m triton|.library|
|00001bf0| 2e 2e 2e 20 2a 2f 0a 20 | 20 20 20 20 20 20 20 43 |... */. | C|
|00001c00| 6c 6f 73 65 4c 69 62 72 | 61 72 79 28 54 72 69 74 |loseLibr|ary(Trit|
|00001c10| 6f 6e 42 61 73 65 29 3b | 0a 20 20 20 20 20 20 40 |onBase);|. @|
|00001c20| 7d 0a 20 20 20 20 20 20 | 65 6c 73 65 0a 20 20 20 |}. |else. |
|00001c30| 20 20 20 40 7b 0a 20 20 | 20 20 20 20 20 20 2f 2a | @{. | /*|
|00001c40| 20 52 65 61 63 74 20 6f | 6e 20 74 68 65 20 65 72 | React o|n the er|
|00001c50| 72 6f 72 2e 2e 2e 20 2a | 2f 0a 20 20 20 20 20 20 |ror... *|/. |
|00001c60| 40 7d 0a 20 20 20 20 20 | 20 72 65 74 75 72 6e 20 |@}. | return |
|00001c70| 30 3b 0a 20 20 20 20 40 | 7d 0a 40 65 6e 64 20 65 |0;. @|}.@end e|
|00001c80| 78 61 6d 70 6c 65 0a 0a | 41 6c 6c 20 54 72 69 74 |xample..|All Trit|
|00001c90| 6f 6e 20 70 72 6f 67 72 | 61 6d 73 20 61 72 65 20 |on progr|ams are |
|00001ca0| 62 61 73 65 64 20 6f 6e | 20 61 20 54 72 69 74 6f |based on| a Trito|
|00001cb0| 6e 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 73 74 |n applic|ation st|
|00001cc0| 72 75 63 74 75 72 65 20 | 28 73 74 72 75 63 74 20 |ructure |(struct |
|00001cd0| 54 52 5f 41 70 70 29 2e | 0a 54 68 69 73 20 73 74 |TR_App).|.This st|
|00001ce0| 72 75 63 74 75 72 65 20 | 69 73 20 74 68 65 20 63 |ructure |is the c|
|00001cf0| 6f 6e 6e 65 63 74 69 6f | 6e 20 77 68 69 63 68 20 |onnectio|n which |
|00001d00| 6b 65 65 70 73 20 61 6c | 6c 20 54 72 69 74 6f 6e |keeps al|l Triton|
|00001d10| 20 70 61 72 74 73 20 6f | 66 20 79 6f 75 72 20 61 | parts o|f your a|
|00001d20| 70 70 6c 69 63 61 74 69 | 6f 6e 0a 74 6f 67 65 74 |pplicati|on.toget|
|00001d30| 68 65 72 2e 20 42 65 66 | 6f 72 65 20 75 73 69 6e |her. Bef|ore usin|
|00001d40| 67 20 61 6e 79 20 6f 74 | 68 65 72 20 54 72 69 74 |g any ot|her Trit|
|00001d50| 6f 6e 20 66 75 6e 63 74 | 69 6f 6e 73 2c 20 79 6f |on funct|ions, yo|
|00001d60| 75 20 68 61 76 65 20 74 | 6f 20 63 72 65 61 74 65 |u have t|o create|
|00001d70| 20 61 20 54 72 69 74 6f | 6e 0a 61 70 70 6c 69 63 | a Trito|n.applic|
|00001d80| 61 74 69 6f 6e 2c 20 61 | 6e 64 20 79 6f 75 20 6d |ation, a|nd you m|
|00001d90| 75 73 74 20 64 65 6c 65 | 74 65 20 69 74 20 61 67 |ust dele|te it ag|
|00001da0| 61 69 6e 20 62 65 66 6f | 72 65 20 79 6f 75 72 20 |ain befo|re your |
|00001db0| 70 72 6f 67 72 61 6d 20 | 71 75 69 74 73 20 28 61 |program |quits (a|
|00001dc0| 6e 64 20 62 65 66 6f 72 | 65 0a 79 6f 75 20 63 6c |nd befor|e.you cl|
|00001dd0| 6f 73 65 20 40 66 69 6c | 65 7b 74 72 69 74 6f 6e |ose @fil|e{triton|
|00001de0| 2e 6c 69 62 72 61 72 79 | 7d 20 6f 66 20 63 6f 75 |.library|} of cou|
|00001df0| 72 73 65 29 2e 20 41 6e | 79 20 54 72 69 74 6f 6e |rse). An|y Triton|
|00001e00| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 6d 75 73 | applica|tion mus|
|00001e10| 74 20 68 61 76 65 20 61 | 74 0a 6c 65 61 73 74 20 |t have a|t.least |
|00001e20| 61 20 73 68 6f 72 74 20 | 6e 61 6d 65 2c 20 77 68 |a short |name, wh|
|00001e30| 69 63 68 20 69 73 20 75 | 73 65 64 20 62 79 20 54 |ich is u|sed by T|
|00001e40| 72 69 74 6f 6e 20 74 6f | 20 69 64 65 6e 74 69 66 |riton to| identif|
|00001e50| 79 20 74 68 65 20 61 70 | 70 6c 69 63 61 74 69 6f |y the ap|plicatio|
|00001e60| 6e 2e 20 41 6c 6c 20 6f | 74 68 65 72 0a 74 61 67 |n. All o|ther.tag|
|00001e70| 73 20 61 72 65 20 6f 70 | 74 69 6f 6e 61 6c 2e 20 |s are op|tional. |
|00001e80| 41 20 74 79 70 69 63 61 | 6c 20 63 6f 64 65 20 73 |A typica|l code s|
|00001e90| 65 67 6d 65 6e 74 20 63 | 6f 75 6c 64 20 6c 6f 6f |egment c|ould loo|
|00001ea0| 6b 20 6c 69 6b 65 20 74 | 68 69 73 3a 0a 0a 40 65 |k like t|his:..@e|
|00001eb0| 78 61 6d 70 6c 65 0a 20 | 20 20 20 73 74 72 75 63 |xample. | struc|
|00001ec0| 74 20 54 52 5f 41 70 70 | 20 2a 6d 79 41 70 70 3b |t TR_App| *myApp;|
|00001ed0| 0a 0a 20 20 20 20 69 66 | 28 6d 79 41 70 70 3d 54 |.. if|(myApp=T|
|00001ee0| 52 5f 43 72 65 61 74 65 | 41 70 70 54 61 67 73 28 |R_Create|AppTags(|
|00001ef0| 0a 20 20 20 20 20 20 54 | 52 43 41 5f 4e 61 6d 65 |. T|RCA_Name|
|00001f00| 2c 20 20 20 20 22 4d 79 | 41 70 70 22 2c 0a 20 20 |, "My|App",. |
|00001f10| 20 20 20 20 54 52 43 41 | 5f 52 65 6c 65 61 73 65 | TRCA|_Release|
|00001f20| 2c 20 22 31 2e 30 22 2c | 0a 20 20 20 20 20 20 54 |, "1.0",|. T|
|00001f30| 52 43 41 5f 56 65 72 73 | 69 6f 6e 2c 20 22 34 32 |RCA_Vers|ion, "42|
|00001f40| 2e 31 31 33 22 2c 0a 20 | 20 20 20 20 20 54 52 43 |.113",. | TRC|
|00001f50| 41 5f 44 61 74 65 2c 20 | 20 20 20 22 33 2e 31 31 |A_Date, | "3.11|
|00001f60| 2e 39 34 22 2c 0a 20 20 | 20 20 20 20 54 41 47 5f |.94",. | TAG_|
|00001f70| 45 4e 44 29 29 0a 20 20 | 20 20 40 7b 0a 20 20 20 |END)). | @{. |
|00001f80| 20 20 20 2f 2a 20 55 73 | 65 20 6d 79 41 70 70 20 | /* Us|e myApp |
|00001f90| 66 6f 72 20 6f 74 68 65 | 72 20 54 72 69 74 6f 6e |for othe|r Triton|
|00001fa0| 20 66 75 6e 63 74 69 6f | 6e 73 2e 2e 2e 20 2a 2f | functio|ns... */|
|00001fb0| 0a 20 20 20 20 20 20 54 | 52 5f 44 65 6c 65 74 65 |. T|R_Delete|
|00001fc0| 41 70 70 28 6d 79 41 70 | 70 29 3b 0a 20 20 20 20 |App(myAp|p);. |
|00001fd0| 40 7d 0a 20 20 20 20 65 | 6c 73 65 0a 20 20 20 20 |@}. e|lse. |
|00001fe0| 40 7b 0a 20 20 20 20 20 | 20 2f 2a 20 52 65 61 63 |@{. | /* Reac|
|00001ff0| 74 20 6f 6e 20 74 68 65 | 20 65 72 72 6f 72 2e 2e |t on the| error..|
|00002000| 2e 20 2a 2f 0a 20 20 20 | 20 40 7d 0a 40 65 6e 64 |. */. | @}.@end|
|00002010| 20 65 78 61 6d 70 6c 65 | 0a 0a 54 68 65 20 6c 69 | example|..The li|
|00002020| 6e 6b 65 72 20 6c 69 62 | 72 61 72 79 20 40 66 69 |nker lib|rary @fi|
|00002030| 6c 65 7b 74 72 69 74 6f | 6e 2e 6c 69 62 7d 20 6f |le{trito|n.lib} o|
|00002040| 66 66 65 72 73 20 61 6e | 20 65 61 73 69 65 72 20 |ffers an| easier |
|00002050| 77 61 79 20 74 6f 20 6f | 70 65 6e 20 40 66 69 6c |way to o|pen @fil|
|00002060| 65 7b 74 72 69 74 6f 6e | 2e 6c 69 62 72 61 72 79 |e{triton|.library|
|00002070| 7d 0a 61 6e 64 20 63 72 | 65 61 74 65 20 61 20 54 |}.and cr|eate a T|
|00002080| 72 69 74 6f 6e 20 61 70 | 70 6c 69 63 61 74 69 6f |riton ap|plicatio|
|00002090| 6e 20 73 74 72 75 63 74 | 75 72 65 2e 20 54 68 65 |n struct|ure. The|
|000020a0| 20 74 77 6f 20 65 78 61 | 6d 70 6c 65 73 20 66 72 | two exa|mples fr|
|000020b0| 6f 6d 20 61 62 6f 76 65 | 20 63 61 6e 20 62 65 20 |om above| can be |
|000020c0| 63 6f 6d 62 69 6e 65 64 | 0a 69 6e 74 6f 20 74 68 |combined|.into th|
|000020d0| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 73 68 6f 72 |e follow|ing shor|
|000020e0| 74 20 76 65 72 73 69 6f | 6e 3a 0a 0a 40 65 78 61 |t versio|n:..@exa|
|000020f0| 6d 70 6c 65 0a 20 20 20 | 20 23 69 6e 63 6c 75 64 |mple. | #includ|
|00002100| 65 20 3c 6c 69 62 72 61 | 72 69 65 73 2f 74 72 69 |e <libra|ries/tri|
|00002110| 74 6f 6e 2e 68 3e 0a 20 | 20 20 20 23 69 6e 63 6c |ton.h>. | #incl|
|00002120| 75 64 65 20 3c 70 72 6f | 74 6f 2f 74 72 69 74 6f |ude <pro|to/trito|
|00002130| 6e 2e 68 3e 0a 0a 20 20 | 20 20 69 6e 74 20 6d 61 |n.h>.. | int ma|
|00002140| 69 6e 28 76 6f 69 64 29 | 0a 20 20 20 20 40 7b 0a |in(void)|. @{.|
|00002150| 20 20 20 20 20 20 69 66 | 28 54 52 5f 4f 70 65 6e | if|(TR_Open|
|00002160| 54 72 69 74 6f 6e 28 54 | 52 49 54 4f 4e 31 32 56 |Triton(T|RITON12V|
|00002170| 45 52 53 49 4f 4e 2c 0a | 20 20 20 20 20 20 20 20 |ERSION,.| |
|00002180| 54 52 43 41 5f 4e 61 6d | 65 2c 20 20 20 20 22 4d |TRCA_Nam|e, "M|
|00002190| 79 41 70 70 22 2c 0a 20 | 20 20 20 20 20 20 20 54 |yApp",. | T|
|000021a0| 52 43 41 5f 52 65 6c 65 | 61 73 65 2c 20 22 31 2e |RCA_Rele|ase, "1.|
|000021b0| 30 22 2c 0a 20 20 20 20 | 20 20 20 20 54 52 43 41 |0",. | TRCA|
|000021c0| 5f 56 65 72 73 69 6f 6e | 2c 20 22 34 32 2e 31 31 |_Version|, "42.11|
|000021d0| 33 22 2c 0a 20 20 20 20 | 20 20 20 20 54 52 43 41 |3",. | TRCA|
|000021e0| 5f 44 61 74 65 2c 20 20 | 20 20 22 33 2e 31 31 2e |_Date, | "3.11.|
|000021f0| 39 34 22 2c 0a 20 20 20 | 20 20 20 20 20 54 41 47 |94",. | TAG|
|00002200| 5f 45 4e 44 29 29 0a 20 | 20 20 20 20 20 40 7b 0a |_END)). | @{.|
|00002210| 20 20 20 20 20 20 20 20 | 2f 2a 20 54 68 65 20 6f | |/* The o|
|00002220| 70 65 6e 65 64 20 61 70 | 70 6c 69 63 61 74 69 6f |pened ap|plicatio|
|00002230| 6e 20 69 73 20 63 61 6c | 6c 65 64 20 27 41 70 70 |n is cal|led 'App|
|00002240| 6c 69 63 61 74 69 6f 6e | 27 20 2a 2f 0a 20 20 20 |lication|' */. |
|00002250| 20 20 20 20 20 54 52 5f | 43 6c 6f 73 65 54 72 69 | TR_|CloseTri|
|00002260| 74 6f 6e 28 29 3b 0a 20 | 20 20 20 20 20 40 7d 0a |ton();. | @}.|
|00002270| 20 20 20 20 20 20 65 6c | 73 65 0a 20 20 20 20 20 | el|se. |
|00002280| 20 40 7b 0a 20 20 20 20 | 20 20 20 20 2f 2a 20 52 | @{. | /* R|
|00002290| 65 61 63 74 20 6f 6e 20 | 74 68 65 20 65 72 72 6f |eact on |the erro|
|000022a0| 72 2e 2e 2e 20 2a 2f 0a | 20 20 20 20 20 20 40 7d |r... */.| @}|
|000022b0| 0a 20 20 20 20 20 20 72 | 65 74 75 72 6e 20 30 3b |. r|eturn 0;|
|000022c0| 0a 20 20 20 20 40 7d 0a | 40 65 6e 64 20 65 78 61 |. @}.|@end exa|
|000022d0| 6d 70 6c 65 0a 0a 40 6e | 6f 64 65 20 54 55 54 5f |mple..@n|ode TUT_|
|000022e0| 50 52 4f 2c 20 54 55 54 | 5f 4d 45 4e 2c 20 54 55 |PRO, TUT|_MEN, TU|
|000022f0| 54 5f 41 50 50 2c 20 54 | 6f 70 0a 40 73 65 63 74 |T_APP, T|op.@sect|
|00002300| 69 6f 6e 20 50 72 6f 6a | 65 63 74 73 0a 40 63 69 |ion Proj|ects.@ci|
|00002310| 6e 64 65 78 20 50 72 6f | 6a 65 63 74 73 0a 0a 41 |ndex Pro|jects..A|
|00002320| 20 54 72 69 74 6f 6e 20 | 50 72 6f 6a 65 63 74 20 | Triton |Project |
|00002330| 69 73 20 74 68 65 20 6e | 65 78 74 20 73 6d 61 6c |is the n|ext smal|
|00002340| 6c 65 72 20 65 6e 74 69 | 74 79 20 6f 66 20 61 20 |ler enti|ty of a |
|00002350| 54 72 69 74 6f 6e 20 47 | 55 49 2e 20 43 75 72 72 |Triton G|UI. Curr|
|00002360| 65 6e 74 6c 79 0a 61 20 | 70 72 6f 6a 65 63 74 20 |ently.a |project |
|00002370| 63 6f 6e 74 61 69 6e 73 | 20 65 78 61 63 74 6c 79 |contains| exactly|
|00002380| 20 6f 6e 65 20 49 6e 74 | 75 69 74 69 6f 6e 20 77 | one Int|uition w|
|00002390| 69 6e 64 6f 77 2c 20 62 | 75 74 20 69 6e 20 66 75 |indow, b|ut in fu|
|000023a0| 74 75 72 65 20 76 65 72 | 73 69 6f 6e 73 0a 6f 66 |ture ver|sions.of|
|000023b0| 20 54 72 69 74 6f 6e 20 | 69 74 20 63 6f 75 6c 64 | Triton |it could|
|000023c0| 20 62 65 20 70 6f 73 73 | 69 62 6c 65 20 74 6f 20 | be poss|ible to |
|000023d0| 61 74 74 61 63 68 20 6d | 6f 72 65 20 77 69 6e 64 |attach m|ore wind|
|000023e0| 6f 77 73 20 74 6f 20 61 | 20 70 72 6f 6a 65 63 74 |ows to a| project|
|000023f0| 2e 0a 55 70 6f 6e 20 6f | 70 65 6e 69 6e 67 20 61 |..Upon o|pening a|
|00002400| 20 70 72 6f 6a 65 63 74 | 2c 20 79 6f 75 20 68 61 | project|, you ha|
|00002410| 76 65 20 74 6f 20 73 70 | 65 63 69 66 79 20 61 6c |ve to sp|ecify al|
|00002420| 6c 20 6f 62 6a 65 63 74 | 73 20 77 68 69 63 68 20 |l object|s which |
|00002430| 61 72 65 20 74 6f 0a 62 | 65 20 64 69 73 70 6c 61 |are to.b|e displa|
|00002440| 79 65 64 20 69 6e 20 74 | 68 65 20 77 69 6e 64 6f |yed in t|he windo|
|00002450| 77 2c 20 74 68 65 20 77 | 69 6e 64 6f 77 27 73 20 |w, the w|indow's |
|00002460| 6d 65 6e 75 20 61 6e 64 | 20 73 6f 6d 65 20 74 61 |menu and| some ta|
|00002470| 67 73 20 64 65 73 63 72 | 69 62 69 6e 67 0a 77 69 |gs descr|ibing.wi|
|00002480| 6e 64 6f 77 20 70 72 6f | 70 65 72 74 69 65 73 2e |ndow pro|perties.|
|00002490| 0a 0a 41 74 20 66 69 72 | 73 74 20 79 6f 75 20 68 |..At fir|st you h|
|000024a0| 61 76 65 20 74 6f 20 73 | 70 65 63 69 66 79 20 74 |ave to s|pecify t|
|000024b0| 68 65 20 77 69 6e 64 6f | 77 20 70 72 6f 70 65 72 |he windo|w proper|
|000024c0| 74 69 65 73 2c 20 74 68 | 65 6e 20 74 68 65 20 6d |ties, th|en the m|
|000024d0| 65 6e 75 73 20 61 6e 64 | 0a 66 69 6e 61 6c 6c 79 |enus and|.finally|
|000024e0| 20 6f 6e 65 20 28 21 29 | 20 6f 62 6a 65 63 74 2e | one (!)| object.|
|000024f0| 20 4e 6f 72 6d 61 6c 6c | 79 20 74 68 69 73 20 6f | Normall|y this o|
|00002500| 62 6a 65 63 74 20 77 69 | 6c 6c 20 62 65 20 61 20 |bject wi|ll be a |
|00002510| 67 72 6f 75 70 20 77 68 | 69 63 68 20 63 6f 6e 74 |group wh|ich cont|
|00002520| 61 69 6e 73 0a 6f 74 68 | 65 72 20 6f 62 6a 65 63 |ains.oth|er objec|
|00002530| 74 73 20 6f 72 20 67 72 | 6f 75 70 73 2e 0a 0a 4e |ts or gr|oups...N|
|00002540| 6f 74 65 20 74 68 61 74 | 20 61 6c 6c 20 74 61 67 |ote that| all tag|
|00002550| 73 20 61 72 65 20 6f 70 | 74 69 6f 6e 61 6c 2e 20 |s are op|tional. |
|00002560| 59 6f 75 20 6d 61 79 20 | 6a 75 73 74 20 61 73 20 |You may |just as |
|00002570| 77 65 6c 6c 0a 6f 70 65 | 6e 20 61 20 77 69 6e 64 |well.ope|n a wind|
|00002580| 6f 77 20 77 69 74 68 6f | 75 74 20 61 6e 79 20 74 |ow witho|ut any t|
|00002590| 61 67 73 2e 20 54 68 69 | 73 20 77 69 6c 6c 20 72 |ags. Thi|s will r|
|000025a0| 65 73 75 6c 74 20 69 6e | 20 61 20 73 6d 61 6c 6c |esult in| a small|
|000025b0| 20 77 69 6e 64 6f 77 2c | 20 63 6f 6e 73 69 73 74 | window,| consist|
|000025c0| 69 6e 67 0a 6f 6e 6c 79 | 20 6f 66 20 74 68 65 20 |ing.only| of the |
|000025d0| 63 6c 6f 73 65 20 61 6e | 64 20 64 65 70 74 68 20 |close an|d depth |
|000025e0| 67 61 64 67 65 74 20 61 | 6e 64 20 61 20 73 6d 61 |gadget a|nd a sma|
|000025f0| 6c 6c 20 64 72 61 67 67 | 69 6e 67 20 62 61 72 2c |ll dragg|ing bar,|
|00002600| 20 62 65 69 6e 67 20 6f | 70 65 6e 65 64 0a 6f 6e | being o|pened.on|
|00002610| 20 74 68 65 20 64 65 66 | 61 75 6c 74 20 70 75 62 | the def|ault pub|
|00002620| 6c 69 63 20 73 63 72 65 | 65 6e 27 73 20 74 69 74 |lic scre|en's tit|
|00002630| 6c 65 20 62 61 72 2e 0a | 0a 41 73 20 77 69 74 68 |le bar..|.As with|
|00002640| 20 6e 61 6d 69 6e 67 20 | 54 72 69 74 6f 6e 20 61 | naming |Triton a|
|00002650| 70 70 6c 69 63 61 74 69 | 6f 6e 73 2c 0a 79 6f 75 |pplicati|ons,.you|
|00002660| 20 73 68 6f 75 6c 64 20 | 67 69 76 65 20 65 61 63 | should |give eac|
|00002670| 68 20 70 72 6f 6a 65 63 | 74 20 61 74 20 6c 65 61 |h projec|t at lea|
|00002680| 73 74 20 61 20 75 6e 69 | 71 75 65 20 49 44 20 77 |st a uni|que ID w|
|00002690| 68 69 63 68 20 69 73 20 | 75 73 65 64 20 62 79 20 |hich is |used by |
|000026a0| 54 72 69 74 6f 6e 0a 65 | 2e 67 2e 20 66 6f 72 20 |Triton.e|.g. for |
|000026b0| 72 65 6d 65 6d 62 65 72 | 69 6e 67 20 74 68 65 20 |remember|ing the |
|000026c0| 77 69 6e 64 6f 77 20 64 | 69 6d 65 6e 73 69 6f 6e |window d|imension|
|000026d0| 73 2e 0a 0a 4f 70 65 6e | 69 6e 67 20 61 6e 64 20 |s...Open|ing and |
|000026e0| 63 6c 6f 73 69 6e 67 20 | 61 0a 70 72 6f 6a 65 63 |closing |a.projec|
|000026f0| 74 20 77 69 74 68 6f 75 | 74 20 61 6e 79 20 6f 62 |t withou|t any ob|
|00002700| 6a 65 63 74 73 20 61 6e | 64 20 6d 65 6e 75 73 20 |jects an|d menus |
|00002710| 63 6f 75 6c 64 20 6c 6f | 6f 6b 20 6c 69 6b 65 20 |could lo|ok like |
|00002720| 74 68 69 73 3a 0a 0a 40 | 65 78 61 6d 70 6c 65 0a |this:..@|example.|
|00002730| 20 20 20 20 73 74 72 75 | 63 74 20 54 61 67 49 74 | stru|ct TagIt|
|00002740| 65 6d 20 64 75 6d 6d 79 | 54 61 67 73 3d 0a 20 20 |em dummy|Tags=. |
|00002750| 20 20 40 7b 0a 20 20 20 | 20 20 20 54 52 57 49 5f | @{. | TRWI_|
|00002760| 54 69 74 6c 65 2c 20 28 | 55 4c 4f 4e 47 29 20 22 |Title, (|ULONG) "|
|00002770| 41 20 64 75 6d 6d 79 20 | 77 69 6e 64 6f 77 22 2c |A dummy |window",|
|00002780| 0a 20 20 20 20 20 20 54 | 52 57 49 5f 49 44 2c 20 |. T|RWI_ID, |
|00002790| 20 20 20 20 20 20 20 20 | 20 20 20 34 32 2c 0a 20 | | 42,. |
|000027a0| 20 20 20 20 20 54 41 47 | 5f 45 4e 44 0a 20 20 20 | TAG|_END. |
|000027b0| 20 40 7d 3b 0a 0a 20 20 | 20 20 76 6f 69 64 20 64 | @};.. | void d|
|000027c0| 75 6d 6d 79 46 75 6e 63 | 74 69 6f 6e 28 76 6f 69 |ummyFunc|tion(voi|
|000027d0| 64 29 0a 20 20 20 20 40 | 7b 0a 20 20 20 20 20 20 |d). @|{. |
|000027e0| 73 74 72 75 63 74 20 54 | 52 5f 50 72 6f 6a 65 63 |struct T|R_Projec|
|000027f0| 74 20 2a 64 75 6d 6d 79 | 50 72 6f 6a 65 63 74 3b |t *dummy|Project;|
|00002800| 0a 0a 20 20 20 20 20 20 | 69 66 28 64 75 6d 6d 79 |.. |if(dummy|
|00002810| 50 72 6f 6a 65 63 74 3d | 54 52 5f 4f 70 65 6e 50 |Project=|TR_OpenP|
|00002820| 72 6f 6a 65 63 74 28 41 | 70 70 6c 69 63 61 74 69 |roject(A|pplicati|
|00002830| 6f 6e 2c 64 75 6d 6d 79 | 54 61 67 73 29 29 0a 20 |on,dummy|Tags)). |
|00002840| 20 20 20 20 20 40 7b 0a | 20 20 20 20 20 20 20 20 | @{.| |
|00002850| 2f 2a 20 4f 70 65 6e 65 | 64 20 73 75 63 63 65 73 |/* Opene|d succes|
|00002860| 73 66 75 6c 6c 79 20 2a | 2f 0a 20 20 20 20 20 20 |sfully *|/. |
|00002870| 20 20 54 52 5f 43 6c 6f | 73 65 50 72 6f 6a 65 63 | TR_Clo|seProjec|
|00002880| 74 28 64 75 6d 6d 79 50 | 72 6f 6a 65 63 74 29 3b |t(dummyP|roject);|
|00002890| 0a 20 20 20 20 20 20 40 | 7d 0a 20 20 20 20 20 20 |. @|}. |
|000028a0| 65 6c 73 65 0a 20 20 20 | 20 20 20 40 7b 0a 20 20 |else. | @{. |
|000028b0| 20 20 20 20 20 20 2f 2a | 20 52 65 61 63 74 20 6f | /*| React o|
|000028c0| 6e 20 74 68 65 20 65 72 | 72 6f 72 2e 2e 2e 20 2a |n the er|ror... *|
|000028d0| 2f 0a 20 20 20 20 20 20 | 40 7d 0a 20 20 20 20 40 |/. |@}. @|
|000028e0| 7d 0a 40 65 6e 64 20 65 | 78 61 6d 70 6c 65 0a 0a |}.@end e|xample..|
|000028f0| 4f 66 20 63 6f 75 72 73 | 65 20 74 68 69 73 20 77 |Of cours|e this w|
|00002900| 61 79 20 6f 66 20 6f 70 | 65 6e 69 6e 67 20 61 20 |ay of op|ening a |
|00002910| 70 72 6f 6a 65 63 74 20 | 76 69 61 20 61 20 73 74 |project |via a st|
|00002920| 61 74 69 63 20 54 61 67 | 49 74 65 6d 20 6c 69 73 |atic Tag|Item lis|
|00002930| 74 20 64 6f 65 73 6e 27 | 74 0a 61 6c 6c 6f 77 20 |t doesn'|t.allow |
|00002940| 74 6f 20 69 6e 73 65 72 | 74 20 6f 62 6a 65 63 74 |to inser|t object|
|00002950| 20 70 61 72 61 6d 65 74 | 65 72 73 20 6f 72 20 6c | paramet|ers or l|
|00002960| 6f 63 61 6c 69 7a 65 64 | 20 73 74 72 69 6e 67 73 |ocalized| strings|
|00002970| 2e 20 53 69 6e 63 65 20 | 79 6f 75 20 6e 65 65 64 |. Since |you need|
|00002980| 20 74 68 65 73 65 0a 66 | 65 61 74 75 72 65 73 20 | these.f|eatures |
|00002990| 6d 6f 73 74 20 74 69 6d | 65 73 2c 20 79 6f 75 20 |most tim|es, you |
|000029a0| 73 68 6f 75 6c 64 20 69 | 6e 73 74 65 61 64 20 75 |should i|nstead u|
|000029b0| 73 65 20 61 20 64 79 6e | 61 6d 69 63 61 6c 20 54 |se a dyn|amical T|
|000029c0| 61 67 4c 69 73 74 20 77 | 68 69 63 68 20 69 73 20 |agList w|hich is |
|000029d0| 62 75 69 6c 74 0a 6f 6e | 20 74 68 65 20 73 74 61 |built.on| the sta|
|000029e0| 63 6b 20 61 74 20 72 75 | 6e 74 69 6d 65 2e 20 42 |ck at ru|ntime. B|
|000029f0| 65 20 73 75 72 65 20 74 | 6f 20 73 65 74 20 61 20 |e sure t|o set a |
|00002a00| 6c 61 72 67 65 20 65 6e | 6f 75 67 68 20 73 74 61 |large en|ough sta|
|00002a10| 63 6b 21 20 53 6f 6d 65 | 20 64 65 76 65 6c 6f 70 |ck! Some| develop|
|00002a20| 6d 65 6e 74 0a 73 79 73 | 74 65 6d 73 20 6f 66 66 |ment.sys|tems off|
|00002a30| 65 72 20 61 6e 20 61 75 | 74 6f 6d 61 74 69 63 20 |er an au|tomatic |
|00002a40| 73 74 61 63 6b 20 73 65 | 74 74 69 6e 67 20 69 6e |stack se|tting in|
|00002a50| 20 74 68 65 69 72 20 73 | 74 61 72 74 75 70 20 63 | their s|tartup c|
|00002a60| 6f 64 65 2c 20 77 68 69 | 63 68 20 63 6f 6d 65 73 |ode, whi|ch comes|
|00002a70| 0a 68 61 6e 64 79 20 69 | 6e 20 74 68 6f 73 65 20 |.handy i|n those |
|00002a80| 73 69 74 75 61 74 69 6f | 6e 73 2e 20 50 6c 65 61 |situatio|ns. Plea|
|00002a90| 73 65 20 64 6f 20 6e 6f | 74 20 72 65 6c 79 20 6f |se do no|t rely o|
|00002aa0| 6e 20 74 68 65 20 75 73 | 65 72 20 74 6f 20 73 65 |n the us|er to se|
|00002ab0| 74 20 74 68 65 20 73 74 | 61 63 6b 21 0a 0a 41 6e |t the st|ack!..An|
|00002ac0| 64 20 6e 6f 77 20 62 61 | 63 6b 20 74 6f 20 6f 75 |d now ba|ck to ou|
|00002ad0| 72 20 63 6f 64 65 2c 20 | 74 68 69 73 20 74 69 6d |r code, |this tim|
|00002ae0| 65 20 77 69 74 68 20 61 | 20 64 79 6e 61 6d 69 63 |e with a| dynamic|
|00002af0| 20 6c 69 73 74 2e 20 49 | 6d 61 67 69 6e 65 20 61 | list. I|magine a|
|00002b00| 20 66 75 6e 63 74 69 6f | 6e 0a 40 63 6f 64 65 7b | functio|n.@code{|
|00002b10| 53 54 52 50 54 52 20 47 | 65 74 4c 6f 63 53 74 72 |STRPTR G|etLocStr|
|00002b20| 28 69 6e 74 20 6e 75 6d | 29 7d 20 77 68 69 63 68 |(int num|)} which|
|00002b30| 20 67 69 76 65 73 20 79 | 6f 75 20 61 20 6c 6f 63 | gives y|ou a loc|
|00002b40| 61 6c 69 7a 65 64 20 73 | 74 72 69 6e 67 2e 0a 0a |alized s|tring...|
|00002b50| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 76 6f 69 |@example|. voi|
|00002b60| 64 20 64 75 6d 6d 79 46 | 75 6e 63 74 69 6f 6e 28 |d dummyF|unction(|
|00002b70| 76 6f 69 64 29 0a 20 20 | 20 20 40 7b 0a 20 20 20 |void). | @{. |
|00002b80| 20 20 20 73 74 72 75 63 | 74 20 54 52 5f 50 72 6f | struc|t TR_Pro|
|00002b90| 6a 65 63 74 20 2a 64 75 | 6d 6d 79 50 72 6f 6a 65 |ject *du|mmyProje|
|00002ba0| 63 74 3b 0a 0a 20 20 20 | 20 20 20 69 66 28 64 75 |ct;.. | if(du|
|00002bb0| 6d 6d 79 50 72 6f 6a 65 | 63 74 3d 54 52 5f 4f 70 |mmyProje|ct=TR_Op|
|00002bc0| 65 6e 50 72 6f 6a 65 63 | 74 54 61 67 73 28 41 70 |enProjec|tTags(Ap|
|00002bd0| 70 6c 69 63 61 74 69 6f | 6e 2c 0a 20 20 20 20 20 |plicatio|n,. |
|00002be0| 20 20 20 54 52 57 49 5f | 54 69 74 6c 65 2c 20 28 | TRWI_|Title, (|
|00002bf0| 55 4c 4f 4e 47 29 20 47 | 65 74 4c 6f 63 53 74 72 |ULONG) G|etLocStr|
|00002c00| 28 4d 53 47 5f 57 49 4e | 54 49 54 4c 45 5f 44 55 |(MSG_WIN|TITLE_DU|
|00002c10| 4d 4d 59 29 2c 0a 20 20 | 20 20 20 20 20 20 54 52 |MMY),. | TR|
|00002c20| 57 49 5f 49 44 2c 20 20 | 20 20 20 20 20 20 20 20 |WI_ID, | |
|00002c30| 20 20 34 32 2c 0a 20 20 | 20 20 20 20 20 20 54 41 | 42,. | TA|
|00002c40| 47 5f 45 4e 44 29 29 0a | 20 20 20 20 20 20 40 7b |G_END)).| @{|
|00002c50| 0a 20 20 20 20 20 20 20 | 20 2f 2a 20 4f 70 65 6e |. | /* Open|
|00002c60| 65 64 20 73 75 63 63 65 | 73 73 66 75 6c 6c 79 20 |ed succe|ssfully |
|00002c70| 2a 2f 0a 20 20 20 20 20 | 20 20 20 54 52 5f 43 6c |*/. | TR_Cl|
|00002c80| 6f 73 65 50 72 6f 6a 65 | 63 74 28 64 75 6d 6d 79 |oseProje|ct(dummy|
|00002c90| 50 72 6f 6a 65 63 74 29 | 3b 0a 20 20 20 20 20 20 |Project)|;. |
|00002ca0| 40 7d 0a 20 20 20 20 20 | 20 65 6c 73 65 0a 20 20 |@}. | else. |
|00002cb0| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 20 20 2f | @{. | /|
|00002cc0| 2a 20 52 65 61 63 74 20 | 6f 6e 20 74 68 65 20 65 |* React |on the e|
|00002cd0| 72 72 6f 72 2e 2e 2e 20 | 2a 2f 0a 20 20 20 20 20 |rror... |*/. |
|00002ce0| 20 40 7d 0a 20 20 20 20 | 40 7d 0a 40 65 6e 64 20 | @}. |@}.@end |
|00002cf0| 65 78 61 6d 70 6c 65 0a | 0a 54 68 65 20 49 44 20 |example.|.The ID |
|00002d00| 34 32 20 69 6e 20 74 68 | 65 20 61 62 6f 76 65 20 |42 in th|e above |
|00002d10| 65 78 61 6d 70 6c 65 73 | 20 68 61 73 20 62 65 65 |examples| has bee|
|00002d20| 6e 20 63 68 6f 73 65 6e | 20 72 61 6e 64 6f 6d 6c |n chosen| randoml|
|00002d30| 79 2e 20 54 68 69 73 20 | 69 73 20 6e 6f 0a 70 72 |y. This |is no.pr|
|00002d40| 6f 62 6c 65 6d 20 61 73 | 20 6c 6f 6e 67 20 61 73 |oblem as| long as|
|00002d50| 20 79 6f 75 20 73 74 69 | 63 6b 20 74 6f 20 74 68 | you sti|ck to th|
|00002d60| 69 73 20 49 44 20 69 6e | 20 66 75 74 75 72 65 20 |is ID in| future |
|00002d70| 75 70 64 61 74 65 73 20 | 6f 66 20 79 6f 75 72 20 |updates |of your |
|00002d80| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 0a 4f 74 68 |applicat|ion..Oth|
|00002d90| 65 72 77 69 73 65 20 74 | 68 65 20 77 69 6e 64 6f |erwise t|he windo|
|00002da0| 77 20 64 69 6d 65 6e 73 | 69 6f 6e 73 20 77 6f 75 |w dimens|ions wou|
|00002db0| 6c 64 20 62 65 20 77 72 | 6f 6e 67 20 61 6e 64 20 |ld be wr|ong and |
|00002dc0| 74 68 65 20 75 73 65 72 | 20 77 6f 75 6c 64 20 68 |the user| would h|
|00002dd0| 61 76 65 20 74 6f 0a 61 | 64 6a 75 73 74 20 74 68 |ave to.a|djust th|
|00002de0| 65 6d 20 61 67 61 69 6e | 2e 0a 0a 49 6e 20 6f 72 |em again|...In or|
|00002df0| 64 65 72 20 74 6f 20 6e | 6f 74 20 75 73 65 20 49 |der to n|ot use I|
|00002e00| 44 73 20 74 77 69 63 65 | 2c 20 69 74 20 63 61 6e |Ds twice|, it can|
|00002e10| 20 62 65 20 75 73 65 66 | 75 6c 20 74 6f 20 65 6e | be usef|ul to en|
|00002e20| 75 6d 65 72 61 74 65 20 | 74 68 65 6d 3a 0a 0a 40 |umerate |them:..@|
|00002e30| 65 78 61 6d 70 6c 65 0a | 20 20 20 20 65 6e 75 6d |example.| enum|
|00002e40| 20 77 69 6e 64 6f 77 49 | 44 73 20 40 7b 57 49 4e | windowI|Ds @{WIN|
|00002e50| 49 44 5f 44 55 4d 4d 59 | 3d 31 2c 20 57 49 4e 49 |ID_DUMMY|=1, WINI|
|00002e60| 44 5f 46 4f 4f 2c 20 57 | 49 4e 49 44 5f 42 41 52 |D_FOO, W|INID_BAR|
|00002e70| 40 7d 3b 0a 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |@};.@end| example|
|00002e80| 0a 0a 4e 6f 74 65 20 74 | 68 61 74 20 77 69 6e 64 |..Note t|hat wind|
|00002e90| 6f 77 20 49 44 73 20 6d | 75 73 74 20 62 65 20 64 |ow IDs m|ust be d|
|00002ea0| 69 66 66 65 72 65 6e 74 | 20 66 72 6f 6d 20 30 2e |ifferent| from 0.|
|00002eb0| 20 30 20 69 73 20 65 71 | 75 61 6c 20 74 6f 0a 6e | 0 is eq|ual to.n|
|00002ec0| 6f 20 49 44 20 61 74 20 | 61 6c 6c 2e 0a 0a 53 65 |o ID at |all...Se|
|00002ed0| 65 20 74 68 65 20 61 75 | 74 6f 64 6f 63 20 63 6c |e the au|todoc cl|
|00002ee0| 69 70 20 40 63 6f 64 65 | 7b 74 72 69 74 6f 6e 2e |ip @code|{triton.|
|00002ef0| 6c 69 62 72 61 72 79 2f | 54 52 5f 4f 70 65 6e 50 |library/|TR_OpenP|
|00002f00| 72 6f 6a 65 63 74 28 29 | 7d 20 66 6f 72 20 64 65 |roject()|} for de|
|00002f10| 74 61 69 6c 73 0a 61 62 | 6f 75 74 20 74 68 65 20 |tails.ab|out the |
|00002f20| 73 75 70 70 6f 72 74 65 | 64 20 74 61 67 73 2e 0a |supporte|d tags..|
|00002f30| 0a 40 6e 6f 64 65 20 54 | 55 54 5f 4d 45 4e 2c 20 |.@node T|UT_MEN, |
|00002f40| 54 55 54 5f 4f 42 4a 2c | 20 54 55 54 5f 50 52 4f |TUT_OBJ,| TUT_PRO|
|00002f50| 2c 20 54 6f 70 0a 40 73 | 65 63 74 69 6f 6e 20 4d |, Top.@s|ection M|
|00002f60| 65 6e 75 73 0a 40 63 69 | 6e 64 65 78 20 4d 65 6e |enus.@ci|ndex Men|
|00002f70| 75 73 0a 0a 41 6e 79 20 | 70 72 6f 6a 65 63 74 20 |us..Any |project |
|00002f80| 64 65 66 69 6e 69 74 6f | 6e 20 6d 61 79 20 63 6f |definito|n may co|
|00002f90| 6e 74 61 69 6e 20 6d 65 | 6e 75 73 2e 20 54 68 65 |ntain me|nus. The|
|00002fa0| 20 6d 65 6e 75 20 74 61 | 67 73 20 6d 75 73 74 20 | menu ta|gs must |
|00002fb0| 66 6f 6c 6c 6f 77 0a 74 | 68 65 20 77 69 6e 64 6f |follow.t|he windo|
|00002fc0| 77 20 74 61 67 73 20 69 | 6d 6d 65 64 69 61 74 65 |w tags i|mmediate|
|00002fd0| 6c 79 2c 20 62 65 66 6f | 72 65 20 74 68 65 20 6f |ly, befo|re the o|
|00002fe0| 62 6a 65 63 74 20 74 61 | 67 73 2e 20 49 66 20 61 |bject ta|gs. If a|
|00002ff0| 20 6d 65 6e 75 20 68 61 | 73 0a 67 6f 74 20 61 6e | menu ha|s.got an|
|00003000| 20 6f 62 6a 65 63 74 20 | 49 44 2c 20 74 68 65 20 | object |ID, the |
|00003010| 54 52 41 54 5f 49 44 20 | 74 61 67 20 6d 75 73 74 |TRAT_ID |tag must|
|00003020| 20 62 65 20 74 68 65 20 | 6c 61 73 74 20 6f 6e 65 | be the |last one|
|00003030| 20 69 6e 20 74 68 65 20 | 6d 65 6e 75 0a 64 65 66 | in the |menu.def|
|00003040| 69 6e 69 74 69 6f 6e 2e | 20 4f 62 6a 65 63 74 20 |inition.| Object |
|00003050| 49 44 73 20 61 72 65 20 | 6d 6f 72 65 20 74 68 61 |IDs are |more tha|
|00003060| 6e 20 50 72 6f 6a 65 63 | 74 20 49 44 73 2e 20 50 |n Projec|t IDs. P|
|00003070| 72 6f 6a 65 63 74 20 49 | 44 73 20 61 72 65 0a 75 |roject I|Ds are.u|
|00003080| 73 65 64 20 6f 6e 6c 79 | 20 69 6e 74 65 72 6e 61 |sed only| interna|
|00003090| 6c 6c 79 20 62 79 20 54 | 72 69 74 6f 6e 2e 20 41 |lly by T|riton. A|
|000030a0| 73 20 61 6e 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |s an app|lication|
|000030b0| 20 70 72 6f 67 72 61 6d | 6d 65 72 2c 20 79 6f 75 | program|mer, you|
|000030c0| 0a 68 61 76 65 20 74 6f | 20 72 65 66 65 72 65 6e |.have to| referen|
|000030d0| 63 65 20 50 72 6f 6a 65 | 63 74 73 20 62 79 20 61 |ce Proje|cts by a|
|000030e0| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 74 68 65 69 | pointer| to thei|
|000030f0| 72 20 40 63 6f 64 65 7b | 73 74 72 75 63 74 20 54 |r @code{|struct T|
|00003100| 52 5f 50 72 6f 6a 65 63 | 74 7d 2e 0a 4f 62 6a 65 |R_Projec|t}..Obje|
|00003110| 63 74 73 20 69 6e 73 74 | 65 61 64 20 61 72 65 20 |cts inst|ead are |
|00003120| 6e 6f 74 20 72 65 66 65 | 72 65 6e 63 65 64 20 74 |not refe|renced t|
|00003130| 68 72 6f 75 67 68 20 70 | 6f 69 6e 74 65 72 73 2c |hrough p|ointers,|
|00003140| 20 62 75 74 20 6f 6e 6c | 79 20 74 68 72 6f 75 67 | but onl|y throug|
|00003150| 68 0a 6f 62 6a 65 63 74 | 20 49 44 73 2e 20 54 68 |h.object| IDs. Th|
|00003160| 65 20 73 61 6d 65 20 69 | 73 20 74 72 75 65 20 66 |e same i|s true f|
|00003170| 6f 72 20 6d 65 6e 75 73 | 2c 20 77 68 69 63 68 20 |or menus|, which |
|00003180| 75 73 65 20 6f 72 64 69 | 6e 61 72 79 20 6f 62 6a |use ordi|nary obj|
|00003190| 65 63 74 20 49 44 73 2e | 0a 0a 41 20 74 79 70 69 |ect IDs.|..A typi|
|000031a0| 63 61 6c 20 6d 65 6e 75 | 20 64 65 66 69 6e 74 69 |cal menu| definti|
|000031b0| 6f 6e 20 63 6f 75 6c 64 | 20 6c 6f 6f 6b 20 6c 69 |on could| look li|
|000031c0| 6b 65 20 74 68 69 73 3a | 0a 0a 40 65 78 61 6d 70 |ke this:|..@examp|
|000031d0| 6c 65 0a 20 20 20 20 54 | 52 5f 4f 70 65 6e 50 72 |le. T|R_OpenPr|
|000031e0| 6f 6a 65 63 74 54 61 67 | 73 28 2e 2e 2e 0a 20 20 |ojectTag|s(.... |
|000031f0| 20 20 20 20 54 52 4d 4e | 5f 54 69 74 6c 65 2c 20 | TRMN|_Title, |
|00003200| 20 20 28 55 4c 4f 4e 47 | 29 20 22 50 72 6f 6a 65 | (ULONG|) "Proje|
|00003210| 63 74 22 2c 0a 20 20 20 | 20 20 20 20 20 54 52 4d |ct",. | TRM|
|00003220| 4e 5f 49 74 65 6d 2c 20 | 20 28 55 4c 4f 4e 47 29 |N_Item, | (ULONG)|
|00003230| 20 22 3f 5f 41 62 6f 75 | 74 22 2c 20 20 20 20 20 | "?_Abou|t", |
|00003240| 20 20 54 52 41 54 5f 49 | 44 2c 20 31 2c 0a 20 20 | TRAT_I|D, 1,. |
|00003250| 20 20 20 20 20 20 54 52 | 4d 4e 5f 49 74 65 6d 2c | TR|MN_Item,|
|00003260| 20 20 28 55 4c 4f 4e 47 | 29 20 54 52 4d 4e 5f 42 | (ULONG|) TRMN_B|
|00003270| 41 52 4c 41 42 45 4c 2c | 20 20 20 54 52 41 54 5f |ARLABEL,| TRAT_|
|00003280| 49 44 2c 20 32 2c 0a 20 | 20 20 20 20 20 20 20 54 |ID, 2,. | T|
|00003290| 52 4d 4e 5f 49 74 65 6d | 2c 20 20 28 55 4c 4f 4e |RMN_Item|, (ULON|
|000032a0| 47 29 20 22 51 5f 51 75 | 69 74 22 2c 20 20 20 20 |G) "Q_Qu|it", |
|000032b0| 20 20 20 20 54 52 41 54 | 5f 49 44 2c 20 33 2c 0a | TRAT|_ID, 3,.|
|000032c0| 20 20 20 20 20 20 2e 2e | 2e 29 3b 0a 40 65 6e 64 | ..|.);.@end|
|000032d0| 20 65 78 61 6d 70 6c 65 | 0a 0a 54 68 65 20 74 69 | example|..The ti|
|000032e0| 74 6c 65 20 6f 66 20 61 | 20 6d 65 6e 75 20 69 74 |tle of a| menu it|
|000032f0| 65 6d 20 6f 72 20 73 75 | 62 2d 69 74 65 6d 20 63 |em or su|b-item c|
|00003300| 61 6e 20 62 65 20 40 63 | 6f 64 65 7b 54 52 4d 53 |an be @c|ode{TRMS|
|00003310| 5f 42 41 52 4c 41 42 45 | 4c 7d 0a 74 6f 20 69 6e |_BARLABE|L}.to in|
|00003320| 73 65 72 74 20 61 20 73 | 74 61 6e 64 61 72 64 20 |sert a s|tandard |
|00003330| 73 65 70 61 72 61 74 6f | 72 20 62 61 72 2e 20 4b |separato|r bar. K|
|00003340| 65 79 62 6f 61 72 64 20 | 73 68 6f 72 74 63 75 74 |eyboard |shortcut|
|00003350| 73 20 63 61 6e 20 62 65 | 0a 73 70 65 63 69 66 69 |s can be|.specifi|
|00003360| 65 64 20 62 79 20 62 65 | 67 69 6e 6e 69 6e 67 20 |ed by be|ginning |
|00003370| 74 68 65 20 6d 65 6e 75 | 20 6c 61 62 65 6c 20 77 |the menu| label w|
|00003380| 69 74 68 20 74 68 65 20 | 73 68 6f 72 74 63 75 74 |ith the |shortcut|
|00003390| 20 6b 65 79 0a 66 6f 6c | 6c 6f 77 65 64 20 62 79 | key.fol|lowed by|
|000033a0| 20 61 6e 20 75 6e 64 65 | 72 73 63 6f 72 65 20 63 | an unde|rscore c|
|000033b0| 68 61 72 61 63 74 65 72 | 20 61 6e 64 20 74 68 65 |haracter| and the|
|000033c0| 20 72 65 61 6c 20 6d 65 | 6e 75 20 6c 61 62 65 6c | real me|nu label|
|000033d0| 2e 0a 54 68 65 73 65 20 | 73 69 6d 70 6c 65 20 73 |..These |simple s|
|000033e0| 68 6f 72 74 63 75 74 73 | 20 28 77 69 74 68 20 74 |hortcuts| (with t|
|000033f0| 68 65 20 72 69 67 68 74 | 20 41 6d 69 67 61 20 6b |he right| Amiga k|
|00003400| 65 79 29 20 61 72 65 20 | 70 72 6f 63 65 73 73 65 |ey) are |processe|
|00003410| 64 0a 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 2e |d.automa|tically.|
|00003420| 20 59 6f 75 20 63 61 6e | 20 63 72 65 61 74 65 20 | You can| create |
|00003430| 61 20 73 6f 2d 63 61 6c | 6c 65 64 20 27 65 78 74 |a so-cal|led 'ext|
|00003440| 65 6e 64 65 64 20 73 68 | 6f 72 74 63 75 74 27 0a |ended sh|ortcut'.|
|00003450| 62 79 20 73 74 61 72 74 | 69 6e 67 20 61 20 6c 61 |by start|ing a la|
|00003460| 62 65 6c 20 77 69 74 68 | 20 61 6e 20 75 6e 64 65 |bel with| an unde|
|00003470| 72 73 63 6f 72 65 20 63 | 68 61 72 61 63 74 65 72 |rscore c|haracter|
|00003480| 2c 20 74 68 65 6e 20 74 | 68 65 0a 74 65 78 74 20 |, then t|he.text |
|00003490| 66 6f 72 20 74 68 65 20 | 73 68 6f 72 74 63 75 74 |for the |shortcut|
|000034a0| 2c 20 61 6e 6f 74 68 65 | 72 20 75 6e 64 65 72 73 |, anothe|r unders|
|000034b0| 63 6f 72 65 20 61 6e 64 | 20 74 68 65 20 6d 65 6e |core and| the men|
|000034c0| 75 20 6c 61 62 65 6c 2e | 0a 54 68 65 73 65 20 65 |u label.|.These e|
|000034d0| 78 74 65 6e 64 65 64 20 | 73 68 6f 72 74 63 75 74 |xtended |shortcut|
|000034e0| 73 20 61 72 65 20 6f 6e | 6c 79 20 64 69 73 70 6c |s are on|ly displ|
|000034f0| 61 79 65 64 20 77 69 74 | 68 20 41 6d 69 67 61 4f |ayed wit|h AmigaO|
|00003500| 53 20 33 2e 30 0a 6f 72 | 20 68 69 67 68 65 72 20 |S 3.0.or| higher |
|00003510| 61 6e 64 20 74 68 65 79 | 20 61 72 65 20 6e 6f 74 |and they| are not|
|00003520| 20 6d 61 6e 61 67 65 64 | 20 61 75 74 6f 6d 61 74 | managed| automat|
|00003530| 69 63 61 6c 6c 79 2e 20 | 59 6f 75 20 68 61 76 65 |ically. |You have|
|00003540| 20 74 6f 0a 6c 69 73 74 | 65 6e 20 74 6f 20 69 6e | to.list|en to in|
|00003550| 63 6f 6d 69 6e 67 20 6b | 65 79 62 6f 61 72 64 20 |coming k|eyboard |
|00003560| 65 76 65 6e 74 73 20 69 | 6e 20 6f 72 64 65 72 20 |events i|n order |
|00003570| 74 6f 20 68 61 6e 64 6c | 65 0a 74 68 65 73 65 20 |to handl|e.these |
|00003580| 73 68 6f 72 74 63 75 74 | 73 20 79 6f 75 72 73 65 |shortcut|s yourse|
|00003590| 6c 66 2e 0a 0a 53 65 65 | 20 74 68 65 20 40 63 6f |lf...See| the @co|
|000035a0| 64 65 7b 4d 65 6e 75 73 | 7d 20 77 69 6e 64 6f 77 |de{Menus|} window|
|000035b0| 20 6f 66 20 74 68 65 20 | 54 72 69 74 6f 6e 20 64 | of the |Triton d|
|000035c0| 65 6d 6f 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |emo appl|ication |
|000035d0| 66 6f 72 20 61 0a 6d 6f | 72 65 20 64 65 74 61 69 |for a.mo|re detai|
|000035e0| 6c 65 64 20 65 78 61 6d | 70 6c 65 20 6f 6e 20 6d |led exam|ple on m|
|000035f0| 65 6e 75 73 2e 0a 0a 40 | 6e 6f 64 65 20 54 55 54 |enus...@|node TUT|
|00003600| 5f 4f 42 4a 2c 20 54 55 | 54 5f 4c 41 59 2c 20 54 |_OBJ, TU|T_LAY, T|
|00003610| 55 54 5f 4d 45 4e 2c 20 | 54 6f 70 0a 40 73 65 63 |UT_MEN, |Top.@sec|
|00003620| 74 69 6f 6e 20 4f 62 6a | 65 63 74 73 0a 40 63 69 |tion Obj|ects.@ci|
|00003630| 6e 64 65 78 20 4f 62 6a | 65 63 74 73 0a 0a 54 68 |ndex Obj|ects..Th|
|00003640| 65 20 68 65 61 72 74 20 | 6f 66 20 65 76 65 72 79 |e heart |of every|
|00003650| 20 54 72 69 74 6f 6e 20 | 47 55 49 20 61 72 65 20 | Triton |GUI are |
|00003660| 74 68 65 20 6f 62 6a 65 | 63 74 73 2e 20 43 75 72 |the obje|cts. Cur|
|00003670| 72 65 6e 74 6c 79 20 6f | 6e 6c 79 20 69 6e 73 74 |rently o|nly inst|
|00003680| 61 6e 63 65 73 0a 6f 66 | 20 73 75 62 63 6c 61 73 |ances.of| subclas|
|00003690| 73 65 73 20 6f 66 20 74 | 68 65 20 40 63 6f 64 65 |ses of t|he @code|
|000036a0| 7b 44 69 73 70 6c 61 79 | 4f 62 6a 65 63 74 7d 20 |{Display|Object} |
|000036b0| 63 6c 61 73 73 20 63 61 | 6e 20 62 65 20 63 72 65 |class ca|n be cre|
|000036c0| 61 74 65 64 2e 0a 40 78 | 72 65 66 7b 49 4e 54 5f |ated..@x|ref{INT_|
|000036d0| 43 4c 41 2c 20 43 6c 61 | 73 73 20 54 72 65 65 2c |CLA, Cla|ss Tree,|
|000036e0| 20 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 20 2d 20 | Introdu|ction - |
|000036f0| 43 6c 61 73 73 20 54 72 | 65 65 7d 2c 20 66 6f 72 |Class Tr|ee}, for|
|00003700| 20 61 20 73 68 6f 72 74 | 20 6c 69 73 74 0a 6f 66 | a short| list.of|
|00003710| 20 61 6c 6c 20 63 6c 61 | 73 73 65 73 2e 20 44 65 | all cla|sses. De|
|00003720| 74 61 69 6c 65 64 20 64 | 65 73 63 72 69 70 74 69 |tailed d|escripti|
|00003730| 6f 6e 73 20 63 61 6e 20 | 62 65 20 66 6f 75 6e 64 |ons can |be found|
|00003740| 20 69 6e 20 74 68 65 20 | 61 75 74 6f 64 6f 63 73 | in the |autodocs|
|00003750| 2e 0a 0a 4f 62 6a 65 63 | 74 73 20 61 72 65 20 63 |...Objec|ts are c|
|00003760| 72 65 61 74 65 64 20 62 | 79 20 69 6e 73 65 72 74 |reated b|y insert|
|00003770| 69 6e 67 20 61 6e 20 6f | 62 6a 65 63 74 20 74 61 |ing an o|bject ta|
|00003780| 67 20 69 6e 74 6f 20 61 | 20 70 72 6f 6a 65 63 74 |g into a| project|
|00003790| 20 64 65 66 69 6e 69 74 | 69 6f 6e 2e 0a 46 6f 72 | definit|ion..For|
|000037a0| 20 65 78 61 6d 70 6c 65 | 2c 20 61 20 63 68 65 63 | example|, a chec|
|000037b0| 6b 65 64 20 43 68 65 63 | 6b 42 6f 78 20 6f 62 6a |ked Chec|kBox obj|
|000037c0| 65 63 74 20 77 69 74 68 | 20 61 6e 20 49 44 20 6f |ect with| an ID o|
|000037d0| 66 20 39 39 20 63 61 6e | 20 62 65 20 63 72 65 61 |f 99 can| be crea|
|000037e0| 74 65 64 0a 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ted.the |followin|
|000037f0| 67 20 77 61 79 3a 0a 0a | 40 65 78 61 6d 70 6c 65 |g way:..|@example|
|00003800| 0a 20 20 20 20 54 52 4f | 42 5f 43 68 65 63 6b 42 |. TRO|B_CheckB|
|00003810| 6f 78 2c 20 20 20 4e 55 | 4c 4c 2c 0a 20 20 20 20 |ox, NU|LL,. |
|00003820| 20 20 54 52 41 54 5f 56 | 61 6c 75 65 2c 20 20 20 | TRAT_V|alue, |
|00003830| 20 28 55 4c 4f 4e 47 29 | 20 54 52 55 45 2c 0a 20 | (ULONG)| TRUE,. |
|00003840| 20 20 20 20 20 54 52 41 | 54 5f 49 44 2c 20 20 20 | TRA|T_ID, |
|00003850| 20 20 20 20 39 39 2c 0a | 40 65 6e 64 20 65 78 61 | 99,.|@end exa|
|00003860| 6d 70 6c 65 0a 0a 41 6c | 6c 20 61 76 61 69 6c 61 |mple..Al|l availa|
|00003870| 62 6c 65 20 74 61 67 73 | 20 61 72 65 20 6c 69 73 |ble tags| are lis|
|00003880| 74 65 64 20 69 6e 20 74 | 68 65 20 61 75 74 6f 64 |ted in t|he autod|
|00003890| 6f 63 73 2e 20 54 68 65 | 20 40 63 6f 64 65 7b 3c |ocs. The| @code{<|
|000038a0| 44 65 66 61 75 6c 74 3e | 7d 20 74 61 67 27 73 0a |Default>|} tag's.|
|000038b0| 76 61 6c 75 65 20 68 61 | 73 20 74 6f 20 62 65 20 |value ha|s to be |
|000038c0| 69 6e 73 65 72 74 65 64 | 20 64 69 72 65 63 74 6c |inserted| directl|
|000038d0| 79 20 69 6e 20 74 68 65 | 20 40 63 6f 64 65 7b 54 |y in the| @code{T|
|000038e0| 52 4f 42 5f 3c 43 6c 61 | 73 73 3e 7d 20 74 61 67 |ROB_<Cla|ss>} tag|
|000038f0| 20 61 73 20 69 74 73 0a | 64 61 74 61 2e 20 41 6c | as its.|data. Al|
|00003900| 6c 20 6f 74 68 65 72 20 | 74 61 67 73 20 61 72 65 |l other |tags are|
|00003910| 20 69 6e 73 65 72 74 65 | 64 20 6e 6f 72 6d 61 6c | inserte|d normal|
|00003920| 6c 79 20 61 66 74 65 72 | 20 74 68 65 20 69 6e 69 |ly after| the ini|
|00003930| 74 69 61 6c 20 63 6c 61 | 73 73 20 74 61 67 2e 0a |tial cla|ss tag..|
|00003940| 0a 40 63 69 6e 64 65 78 | 20 4e 6f 74 69 66 69 63 |.@cindex| Notific|
|00003950| 61 74 69 6f 6e 0a 40 63 | 69 6e 64 65 78 20 4c 69 |ation.@c|index Li|
|00003960| 6e 6b 69 6e 67 0a 40 73 | 74 72 6f 6e 67 7b 4e 6f |nking.@s|trong{No|
|00003970| 74 65 3a 7d 20 49 74 20 | 69 73 20 75 73 65 66 75 |te:} It |is usefu|
|00003980| 6c 20 74 6f 20 40 63 6f | 64 65 7b 65 6e 75 6d 7d |l to @co|de{enum}|
|00003990| 65 72 61 74 65 20 6f 62 | 6a 65 63 74 20 49 44 73 |erate ob|ject IDs|
|000039a0| 20 6a 75 73 74 20 6c 69 | 6b 65 0a 70 72 6f 6a 65 | just li|ke.proje|
|000039b0| 63 74 20 49 44 73 2e 20 | 42 75 74 20 69 6e 20 63 |ct IDs. |But in c|
|000039c0| 6f 6e 74 72 61 73 74 20 | 74 6f 20 70 72 6f 6a 65 |ontrast |to proje|
|000039d0| 63 74 20 49 44 73 2c 20 | 6f 62 6a 65 63 74 20 49 |ct IDs, |object I|
|000039e0| 44 73 20 6d 61 79 20 62 | 65 20 75 73 65 64 0a 6d |Ds may b|e used.m|
|000039f0| 6f 72 65 20 74 68 61 6e | 20 6f 6e 63 65 2e 20 49 |ore than| once. I|
|00003a00| 66 20 79 6f 75 20 75 73 | 65 20 61 6e 20 6f 62 6a |f you us|e an obj|
|00003a10| 65 63 74 20 49 44 20 73 | 65 76 65 72 61 6c 20 74 |ect ID s|everal t|
|00003a20| 69 6d 65 73 20 77 69 74 | 68 69 6e 20 74 68 65 20 |imes wit|hin the |
|00003a30| 73 61 6d 65 0a 70 72 6f | 6a 65 63 74 2c 20 74 68 |same.pro|ject, th|
|00003a40| 65 20 6f 62 6a 65 63 74 | 73 20 77 69 74 68 20 74 |e object|s with t|
|00003a50| 68 61 74 20 49 44 20 77 | 69 6c 6c 20 62 65 20 6c |hat ID w|ill be l|
|00003a60| 69 6e 6b 65 64 20 74 6f | 67 65 74 68 65 72 20 61 |inked to|gether a|
|00003a70| 6e 64 20 77 68 65 6e 65 | 76 65 72 0a 61 6e 20 61 |nd whene|ver.an a|
|00003a80| 74 74 72 69 62 75 74 65 | 20 28 6f 6e 6c 79 20 73 |ttribute| (only s|
|00003a90| 65 6c 65 63 74 65 64 20 | 61 74 74 72 69 62 75 74 |elected |attribut|
|00003aa0| 65 73 2c 20 6e 6f 74 61 | 62 6c 79 20 40 63 6f 64 |es, nota|bly @cod|
|00003ab0| 65 7b 54 52 41 54 5f 56 | 61 6c 75 65 7d 21 29 20 |e{TRAT_V|alue}!) |
|00003ac0| 6f 66 0a 6f 6e 65 20 6f | 62 6a 65 63 74 20 63 68 |of.one o|bject ch|
|00003ad0| 61 6e 67 65 73 2c 20 74 | 68 69 73 20 63 68 61 6e |anges, t|his chan|
|00003ae0| 67 65 20 77 69 6c 6c 20 | 62 65 20 62 72 6f 61 64 |ge will |be broad|
|00003af0| 63 61 73 74 20 74 6f 20 | 61 6c 6c 20 6f 74 68 65 |cast to |all othe|
|00003b00| 72 20 6f 62 6a 65 63 74 | 73 0a 77 69 74 68 20 74 |r object|s.with t|
|00003b10| 68 61 74 20 49 44 20 61 | 73 20 69 66 20 79 6f 75 |hat ID a|s if you|
|00003b20| 20 68 61 64 20 6e 6f 74 | 69 66 69 65 64 20 74 68 | had not|ified th|
|00003b30| 65 6d 20 79 6f 75 72 73 | 65 6c 66 20 77 69 74 68 |em yours|elf with|
|00003b40| 0a 40 63 6f 64 65 7b 54 | 52 5f 53 65 74 41 74 74 |.@code{T|R_SetAtt|
|00003b50| 72 69 62 75 74 65 28 29 | 7d 2e 20 54 68 69 73 20 |ribute()|}. This |
|00003b60| 69 73 20 70 61 72 74 69 | 63 75 6c 61 72 6c 79 20 |is parti|cularly |
|00003b70| 75 73 65 66 75 6c 20 74 | 6f 20 6c 69 6e 6b 20 61 |useful t|o link a|
|00003b80| 0a 43 68 65 63 6b 42 6f | 78 20 67 61 64 67 65 74 |.CheckBo|x gadget|
|00003b90| 20 61 6e 64 20 61 20 63 | 68 65 63 6b 61 62 6c 65 | and a c|heckable|
|00003ba0| 20 6d 65 6e 75 20 69 74 | 65 6d 20 74 6f 67 65 74 | menu it|em toget|
|00003bb0| 68 65 72 2e 0a 0a 53 65 | 65 20 74 68 65 20 40 63 |her...Se|e the @c|
|00003bc0| 6f 64 65 7b 43 6f 6e 6e | 65 63 74 69 6f 6e 73 7d |ode{Conn|ections}|
|00003bd0| 20 77 69 6e 64 6f 77 20 | 6f 66 20 74 68 65 20 54 | window |of the T|
|00003be0| 72 69 74 6f 6e 20 64 65 | 6d 6f 20 61 70 70 6c 69 |riton de|mo appli|
|00003bf0| 63 61 74 69 6f 6e 20 66 | 6f 72 20 61 0a 6d 6f 72 |cation f|or a.mor|
|00003c00| 65 20 64 65 74 61 69 6c | 65 64 20 65 78 61 6d 70 |e detail|ed examp|
|00003c10| 6c 65 20 6f 6e 20 61 74 | 74 72 69 62 75 74 65 20 |le on at|tribute |
|00003c20| 62 72 6f 61 64 63 61 73 | 74 69 6e 67 2e 0a 0a 40 |broadcas|ting...@|
|00003c30| 6e 6f 64 65 20 54 55 54 | 5f 4c 41 59 2c 20 54 55 |node TUT|_LAY, TU|
|00003c40| 54 5f 4d 41 43 2c 20 54 | 55 54 5f 4f 42 4a 2c 20 |T_MAC, T|UT_OBJ, |
|00003c50| 54 6f 70 0a 40 73 65 63 | 74 69 6f 6e 20 4c 61 79 |Top.@sec|tion Lay|
|00003c60| 6f 75 74 0a 40 63 69 6e | 64 65 78 20 4c 61 79 6f |out.@cin|dex Layo|
|00003c70| 75 74 0a 0a 4f 6e 65 20 | 6f 66 20 74 68 65 20 6d |ut..One |of the m|
|00003c80| 6f 73 74 20 69 6d 70 6f | 72 74 61 6e 74 20 63 6c |ost impo|rtant cl|
|00003c90| 61 73 73 65 73 20 69 73 | 20 40 63 6f 64 65 7b 47 |asses is| @code{G|
|00003ca0| 72 6f 75 70 7d 2e 20 49 | 74 20 69 6d 70 6c 65 6d |roup}. I|t implem|
|00003cb0| 65 6e 74 73 20 54 72 69 | 74 6f 6e 27 73 0a 6c 61 |ents Tri|ton's.la|
|00003cc0| 79 6f 75 74 20 65 6e 67 | 69 6e 65 2e 0a 0a 40 63 |yout eng|ine...@c|
|00003cd0| 6f 64 65 7b 47 72 6f 75 | 70 7d 20 6f 62 6a 65 63 |ode{Grou|p} objec|
|00003ce0| 74 73 20 6f 66 66 65 72 | 20 74 77 6f 20 6b 69 6e |ts offer| two kin|
|00003cf0| 64 73 20 6f 66 20 64 69 | 72 65 63 74 69 6f 6e 73 |ds of di|rections|
|00003d00| 3a 0a 0a 40 65 6e 75 6d | 65 72 61 74 65 0a 40 69 |:..@enum|erate.@i|
|00003d10| 74 65 6d 0a 48 6f 72 69 | 7a 6f 6e 74 61 6c 20 28 |tem.Hori|zontal (|
|00003d20| 70 72 69 6d 61 72 79 20 | 64 69 72 65 63 74 69 6f |primary |directio|
|00003d30| 6e 3b 20 73 65 63 6f 6e | 64 61 72 79 20 64 69 72 |n; secon|dary dir|
|00003d40| 65 63 74 69 6f 6e 20 69 | 73 20 76 65 72 74 69 63 |ection i|s vertic|
|00003d50| 61 6c 29 2e 0a 43 72 65 | 61 74 65 64 20 77 69 74 |al)..Cre|ated wit|
|00003d60| 68 20 40 63 6f 64 65 7b | 54 52 47 52 5f 48 6f 72 |h @code{|TRGR_Hor|
|00003d70| 69 7a 7d 2e 0a 40 69 74 | 65 6d 0a 56 65 72 74 69 |iz}..@it|em.Verti|
|00003d80| 63 61 6c 20 28 70 72 69 | 6d 61 72 79 20 64 69 72 |cal (pri|mary dir|
|00003d90| 65 63 74 69 6f 6e 3b 20 | 73 65 63 6f 6e 64 61 72 |ection; |secondar|
|00003da0| 79 20 64 69 72 65 63 74 | 69 6f 6e 20 69 73 20 68 |y direct|ion is h|
|00003db0| 6f 72 69 7a 6f 6e 74 61 | 6c 29 0a 43 72 65 61 74 |orizonta|l).Creat|
|00003dc0| 65 64 20 77 69 74 68 20 | 40 63 6f 64 65 7b 54 52 |ed with |@code{TR|
|00003dd0| 47 52 5f 56 65 72 74 7d | 2e 0a 40 65 6e 64 20 65 |GR_Vert}|..@end e|
|00003de0| 6e 75 6d 65 72 61 74 65 | 0a 0a 33 20 64 69 66 66 |numerate|..3 diff|
|00003df0| 65 72 65 6e 74 20 6c 61 | 79 6f 75 74 20 74 79 70 |erent la|yout typ|
|00003e00| 65 73 20 61 72 65 20 61 | 76 61 69 6c 61 62 6c 65 |es are a|vailable|
|00003e10| 20 66 6f 72 20 65 61 63 | 68 20 69 6e 73 74 61 6e | for eac|h instan|
|00003e20| 63 65 0a 6f 66 20 40 63 | 6f 64 65 7b 47 72 6f 75 |ce.of @c|ode{Grou|
|00003e30| 70 7d 20 28 61 64 6a 75 | 73 74 61 62 6c 65 20 77 |p} (adju|stable w|
|00003e40| 69 74 68 20 74 68 65 20 | 67 72 6f 75 70 20 66 6c |ith the |group fl|
|00003e50| 61 67 73 29 2e 20 54 68 | 65 79 20 61 66 66 65 63 |ags). Th|ey affec|
|00003e60| 74 0a 74 68 65 20 70 72 | 69 6d 61 72 79 20 64 69 |t.the pr|imary di|
|00003e70| 72 65 63 74 69 6f 6e 20 | 6f 6e 6c 79 3a 0a 0a 40 |rection |only:..@|
|00003e80| 65 6e 75 6d 65 72 61 74 | 65 0a 40 69 74 65 6d 0a |enumerat|e.@item.|
|00003e90| 40 63 6f 64 65 7b 54 52 | 47 52 5f 50 52 4f 50 53 |@code{TR|GR_PROPS|
|00003ea0| 48 41 52 45 7d 3a 20 44 | 69 76 69 64 65 73 20 61 |HARE}: D|ivides a|
|00003eb0| 6c 6c 20 6f 62 6a 65 63 | 74 73 20 70 72 6f 70 6f |ll objec|ts propo|
|00003ec0| 72 74 69 6f 6e 61 6c 6c | 79 20 74 6f 20 74 68 65 |rtionall|y to the|
|00003ed0| 69 72 0a 6d 69 6e 69 6d | 75 6d 20 73 69 7a 65 2e |ir.minim|um size.|
|00003ee0| 20 41 6c 6c 20 73 70 61 | 63 65 73 20 72 65 74 61 | All spa|ces reta|
|00003ef0| 69 6e 20 74 68 65 69 72 | 20 6d 69 6e 69 6d 75 6d |in their| minimum|
|00003f00| 20 73 69 7a 65 20 61 6e | 64 20 61 72 65 20 6e 6f | size an|d are no|
|00003f10| 74 20 72 65 73 69 7a 61 | 62 6c 65 2e 0a 4e 6f 6e |t resiza|ble..Non|
|00003f20| 2d 72 65 73 69 7a 61 62 | 6c 65 20 6e 6f 6e 2d 73 |-resizab|le non-s|
|00003f30| 70 61 63 65 20 6f 62 6a | 65 63 74 73 20 64 6f 20 |pace obj|ects do |
|00003f40| 61 6c 73 6f 20 73 74 69 | 63 6b 20 74 6f 20 74 68 |also sti|ck to th|
|00003f50| 65 69 72 20 6d 69 6e 69 | 6d 75 6d 20 73 69 7a 65 |eir mini|mum size|
|00003f60| 73 0a 28 77 65 6c 6c 2c | 20 74 68 65 79 20 64 6f |s.(well,| they do|
|00003f70| 6e 27 74 20 72 65 61 6c | 6c 79 20 68 61 76 65 20 |n't real|ly have |
|00003f80| 61 20 63 68 6f 69 63 65 | 2c 20 64 6f 20 74 68 65 |a choice|, do the|
|00003f90| 79 3f 20 3b 29 2e 0a 40 | 69 74 65 6d 0a 40 63 6f |y? ;)..@|item.@co|
|00003fa0| 64 65 7b 54 52 47 52 5f | 45 51 55 41 4c 53 48 41 |de{TRGR_|EQUALSHA|
|00003fb0| 52 45 7d 3a 20 53 61 6d | 65 20 61 73 20 40 63 6f |RE}: Sam|e as @co|
|00003fc0| 64 65 7b 54 52 47 52 5f | 50 52 4f 50 53 48 41 52 |de{TRGR_|PROPSHAR|
|00003fd0| 45 7d 20 65 78 63 65 70 | 74 20 74 68 61 74 20 61 |E} excep|t that a|
|00003fe0| 6c 6c 20 6e 6f 6e 2d 73 | 70 61 63 65 0a 6f 62 6a |ll non-s|pace.obj|
|00003ff0| 65 63 74 73 20 68 61 76 | 65 20 74 68 65 20 73 61 |ects hav|e the sa|
|00004000| 6d 65 20 73 69 7a 65 2e | 20 54 68 65 69 72 20 6d |me size.| Their m|
|00004010| 69 6e 69 6d 75 6d 20 73 | 69 7a 65 20 65 71 75 61 |inimum s|ize equa|
|00004020| 6c 73 20 74 68 65 20 62 | 69 67 67 65 73 74 20 6d |ls the b|iggest m|
|00004030| 69 6e 69 6d 75 6d 20 73 | 69 7a 65 0a 6f 66 20 74 |inimum s|ize.of t|
|00004040| 68 65 20 69 6e 64 69 76 | 69 64 75 61 6c 20 6f 62 |he indiv|idual ob|
|00004050| 6a 65 63 74 73 2e 0a 40 | 69 74 65 6d 0a 40 63 6f |jects..@|item.@co|
|00004060| 64 65 7b 54 52 47 52 5f | 50 52 4f 50 53 50 41 43 |de{TRGR_|PROPSPAC|
|00004070| 45 53 7d 3a 20 41 6c 6c | 20 6e 6f 6e 2d 73 70 61 |ES}: All| non-spa|
|00004080| 63 65 20 6f 62 6a 65 63 | 74 73 20 72 65 74 61 69 |ce objec|ts retai|
|00004090| 6e 20 74 68 65 69 72 20 | 6d 69 6e 69 6d 75 6d 20 |n their |minimum |
|000040a0| 73 69 7a 65 73 20 61 6c | 6c 0a 74 68 65 20 74 69 |sizes al|l.the ti|
|000040b0| 6d 65 20 61 6e 64 20 64 | 6f 20 6e 6f 74 20 67 65 |me and d|o not ge|
|000040c0| 74 20 73 74 72 65 74 63 | 68 65 64 2e 20 49 6e 73 |t stretc|hed. Ins|
|000040d0| 74 65 61 64 20 74 68 65 | 20 73 70 61 63 65 73 20 |tead the| spaces |
|000040e0| 61 72 65 20 73 74 72 65 | 74 63 68 65 64 0a 70 72 |are stre|tched.pr|
|000040f0| 6f 70 6f 72 74 69 6f 6e | 61 6c 6c 79 20 74 6f 20 |oportion|ally to |
|00004100| 74 68 65 69 72 20 6d 69 | 6e 69 6d 75 6d 20 73 69 |their mi|nimum si|
|00004110| 7a 65 73 2e 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |zes..@it|em.@code|
|00004120| 7b 54 52 47 52 5f 41 52 | 52 41 59 7d 3a 20 54 68 |{TRGR_AR|RAY}: Th|
|00004130| 69 73 20 67 72 6f 75 70 | 20 62 75 69 6c 64 73 20 |is group| builds |
|00004140| 74 68 65 20 74 6f 70 20 | 67 72 6f 75 70 20 6f 66 |the top |group of|
|00004150| 20 61 6e 20 61 72 72 61 | 79 2e 20 49 6e 20 6f 72 | an arra|y. In or|
|00004160| 64 65 72 0a 74 6f 20 63 | 72 65 61 74 65 20 61 6e |der.to c|reate an|
|00004170| 20 61 72 72 61 79 2c 20 | 79 6f 75 20 68 61 76 65 | array, |you have|
|00004180| 20 74 6f 20 73 65 74 20 | 75 70 20 61 6e 20 6f 75 | to set |up an ou|
|00004190| 74 65 72 20 40 63 6f 64 | 65 7b 54 52 47 52 5f 41 |ter @cod|e{TRGR_A|
|000041a0| 52 52 41 59 7d 20 67 72 | 6f 75 70 0a 28 68 6f 72 |RRAY} gr|oup.(hor|
|000041b0| 69 7a 6f 6e 74 61 6c 20 | 66 6f 72 20 61 20 63 6f |izontal |for a co|
|000041c0| 6c 75 6d 6e 20 61 72 72 | 61 79 2c 20 76 65 72 74 |lumn arr|ay, vert|
|000041d0| 69 63 61 6c 20 66 6f 72 | 20 61 20 6c 69 6e 65 20 |ical for| a line |
|000041e0| 61 72 72 61 79 29 20 61 | 6e 64 20 66 69 6c 6c 20 |array) a|nd fill |
|000041f0| 69 74 0a 77 69 74 68 20 | 73 69 6e 67 6c 65 20 6f |it.with |single o|
|00004200| 62 6a 65 63 74 73 20 28 | 6e 6f 74 61 62 6c 79 20 |bjects (|notably |
|00004210| 73 70 61 63 65 73 29 20 | 6f 72 20 40 63 6f 64 65 |spaces) |or @code|
|00004220| 7b 54 52 47 52 5f 50 52 | 4f 50 53 48 41 52 45 7d |{TRGR_PR|OPSHARE}|
|00004230| 20 67 72 6f 75 70 73 20 | 69 6e 0a 74 68 65 20 6f | groups |in.the o|
|00004240| 70 70 6f 73 69 74 65 20 | 64 69 72 65 63 74 69 6f |pposite |directio|
|00004250| 6e 2e 20 41 6c 6c 20 65 | 6c 65 6d 65 6e 74 73 20 |n. All e|lements |
|00004260| 6f 66 20 74 68 65 20 69 | 6e 6e 65 72 20 67 72 6f |of the i|nner gro|
|00004270| 75 70 73 20 77 69 6c 6c | 20 62 65 20 61 6c 69 67 |ups will| be alig|
|00004280| 6e 65 64 0a 74 6f 20 62 | 75 69 6c 64 20 61 6e 20 |ned.to b|uild an |
|00004290| 61 72 72 61 79 2e 20 49 | 6e 6e 65 72 20 67 72 6f |array. I|nner gro|
|000042a0| 75 70 73 20 77 68 69 63 | 68 20 68 61 76 65 20 74 |ups whic|h have t|
|000042b0| 68 65 20 66 6c 61 67 20 | 40 63 6f 64 65 7b 54 52 |he flag |@code{TR|
|000042c0| 47 52 5f 49 4e 44 45 50 | 7d 20 73 65 74 0a 77 69 |GR_INDEP|} set.wi|
|000042d0| 6c 6c 20 6e 6f 74 20 62 | 65 20 61 6c 69 67 6e 65 |ll not b|e aligne|
|000042e0| 64 2e 20 54 68 65 79 20 | 61 72 65 20 6d 61 69 6e |d. They |are main|
|000042f0| 6c 79 20 75 73 65 64 20 | 74 6f 20 69 6e 73 65 72 |ly used |to inser|
|00004300| 74 20 6e 61 6d 65 64 20 | 73 65 70 61 72 61 74 6f |t named |separato|
|00004310| 72 20 62 61 72 73 0a 28 | 63 72 65 61 74 65 64 20 |r bars.(|created |
|00004320| 77 69 74 68 20 40 63 6f | 64 65 7b 54 52 4f 42 5f |with @co|de{TROB_|
|00004330| 4c 69 6e 65 7d 20 61 6e | 64 20 40 63 6f 64 65 7b |Line} an|d @code{|
|00004340| 54 52 4f 42 5f 54 65 78 | 74 7d 29 20 69 6e 74 6f |TROB_Tex|t}) into|
|00004350| 20 61 6e 20 61 72 72 61 | 79 2e 0a 40 65 6e 64 20 | an arra|y..@end |
|00004360| 65 6e 75 6d 65 72 61 74 | 65 0a 0a 43 75 72 72 65 |enumerat|e..Curre|
|00004370| 6e 74 6c 79 20 74 68 65 | 20 6f 6e 6c 79 20 6f 62 |ntly the| only ob|
|00004380| 6a 65 63 74 73 20 77 68 | 69 63 68 20 61 72 65 20 |jects wh|ich are |
|00004390| 74 72 65 61 74 65 64 20 | 61 73 20 73 70 61 63 65 |treated |as space|
|000043a0| 73 20 69 6e 20 74 68 65 | 20 61 62 6f 76 65 20 73 |s in the| above s|
|000043b0| 63 68 65 6d 65 0a 61 72 | 65 20 69 6e 73 74 61 6e |cheme.ar|e instan|
|000043c0| 63 65 73 20 6f 66 20 63 | 6c 61 73 73 20 40 63 6f |ces of c|lass @co|
|000043d0| 64 65 7b 53 70 61 63 65 | 7d 2e 0a 0a 54 68 65 20 |de{Space|}...The |
|000043e0| 62 65 68 61 76 69 6f 75 | 72 20 6f 66 20 74 68 65 |behaviou|r of the|
|000043f0| 20 67 72 6f 75 70 20 69 | 6e 20 69 74 73 20 73 65 | group i|n its se|
|00004400| 63 6f 6e 64 61 72 79 20 | 64 69 72 65 63 74 69 6f |condary |directio|
|00004410| 6e 20 63 61 6e 20 62 65 | 20 63 68 61 6e 67 65 64 |n can be| changed|
|00004420| 2c 20 74 6f 6f 2e 0a 54 | 77 6f 20 61 64 64 69 74 |, too..T|wo addit|
|00004430| 69 6f 6e 61 6c 20 66 6c | 61 67 73 20 61 72 65 20 |ional fl|ags are |
|00004440| 61 76 61 69 6c 61 62 6c | 65 20 66 6f 72 20 74 68 |availabl|e for th|
|00004450| 61 74 20 70 75 72 70 6f | 73 65 2e 20 49 6e 20 6d |at purpo|se. In m|
|00004460| 6f 73 74 20 63 61 73 65 | 73 20 79 6f 75 20 6d 61 |ost case|s you ma|
|00004470| 79 0a 77 61 6e 74 20 74 | 6f 20 73 65 74 20 62 6f |y.want t|o set bo|
|00004480| 74 68 20 6f 66 20 74 68 | 65 6d 3a 0a 0a 40 65 6e |th of th|em:..@en|
|00004490| 75 6d 65 72 61 74 65 0a | 40 69 74 65 6d 0a 40 63 |umerate.|@item.@c|
|000044a0| 6f 64 65 7b 54 52 47 52 | 5f 41 4c 49 47 4e 7d 3a |ode{TRGR|_ALIGN}:|
|000044b0| 20 41 6c 6c 20 72 65 73 | 69 7a 61 62 6c 65 20 6f | All res|izable o|
|000044c0| 62 6a 65 63 74 73 20 28 | 69 2e 65 2e 20 72 65 73 |bjects (|i.e. res|
|000044d0| 69 7a 61 62 6c 65 20 69 | 6e 20 74 68 65 20 73 65 |izable i|n the se|
|000044e0| 63 6f 6e 64 61 72 79 0a | 64 69 6d 65 6e 73 69 6f |condary.|dimensio|
|000044f0| 6e 20 6f 66 20 74 68 65 | 20 67 72 6f 75 70 29 20 |n of the| group) |
|00004500| 61 72 65 20 73 74 72 65 | 63 68 74 65 64 20 74 6f |are stre|chted to|
|00004510| 20 66 69 74 20 74 68 65 | 20 66 75 6c 6c 20 73 70 | fit the| full sp|
|00004520| 61 63 65 20 6f 63 63 75 | 70 69 65 64 20 62 79 0a |ace occu|pied by.|
|00004530| 74 68 65 20 67 72 6f 75 | 70 2e 0a 40 69 74 65 6d |the grou|p..@item|
|00004540| 0a 40 63 6f 64 65 7b 54 | 52 47 52 5f 43 45 4e 54 |.@code{T|RGR_CENT|
|00004550| 45 52 7d 3a 20 41 6c 6c | 20 6e 6f 6e 2d 72 65 73 |ER}: All| non-res|
|00004560| 69 7a 61 62 6c 65 20 6f | 62 6a 65 63 74 73 20 61 |izable o|bjects a|
|00004570| 72 65 20 63 65 6e 74 65 | 72 65 64 20 69 6e 20 74 |re cente|red in t|
|00004580| 68 65 20 67 72 6f 75 70 | 2e 0a 57 69 74 68 6f 75 |he group|..Withou|
|00004590| 74 20 74 68 69 73 20 66 | 6c 61 67 20 74 68 65 79 |t this f|lag they|
|000045a0| 20 67 65 74 20 61 6c 69 | 67 6e 65 64 20 74 6f 20 | get ali|gned to |
|000045b0| 74 68 65 20 6c 65 66 74 | 20 6f 72 20 74 6f 70 20 |the left| or top |
|000045c0| 62 6f 72 64 65 72 2e 0a | 40 65 6e 64 20 65 6e 75 |border..|@end enu|
|000045d0| 6d 65 72 61 74 65 0a 0a | 49 74 20 69 73 20 61 6c |merate..|It is al|
|000045e0| 73 6f 20 70 6f 73 73 69 | 62 6c 65 20 74 6f 20 6b |so possi|ble to k|
|000045f0| 65 65 70 20 61 20 67 72 | 6f 75 70 20 61 74 20 69 |eep a gr|oup at i|
|00004600| 74 73 20 6d 69 6e 69 6d | 75 6d 20 73 69 7a 65 20 |ts minim|um size |
|00004610| 61 6e 64 20 64 6f 6e 27 | 74 20 61 6c 6c 6f 77 0a |and don'|t allow.|
|00004620| 69 74 20 74 6f 20 62 65 | 20 73 74 72 65 74 63 68 |it to be| stretch|
|00004630| 65 64 20 69 6e 20 65 69 | 74 68 65 72 20 6f 72 20 |ed in ei|ther or |
|00004640| 62 6f 74 68 20 64 69 72 | 65 63 74 69 6f 6e 73 2e |both dir|ections.|
|00004650| 20 54 68 69 73 20 63 61 | 6e 20 62 65 20 61 63 63 | This ca|n be acc|
|00004660| 6f 6d 70 6c 69 73 68 65 | 64 0a 77 69 74 68 20 74 |omplishe|d.with t|
|00004670| 68 65 20 40 63 6f 64 65 | 7b 54 52 47 52 5f 46 49 |he @code|{TRGR_FI|
|00004680| 58 48 4f 52 49 5a 7d 20 | 61 6e 64 20 40 63 6f 64 |XHORIZ} |and @cod|
|00004690| 65 7b 54 52 47 52 5f 46 | 49 58 56 45 52 54 7d 20 |e{TRGR_F|IXVERT} |
|000046a0| 66 6c 61 67 73 2e 0a 0a | 41 20 67 72 6f 75 70 20 |flags...|A group |
|000046b0| 63 61 6e 20 62 65 20 63 | 72 65 61 74 65 64 20 6c |can be c|reated l|
|000046c0| 69 6b 65 20 61 6e 79 20 | 6f 74 68 65 72 20 6f 62 |ike any |other ob|
|000046d0| 6a 65 63 74 2e 20 49 74 | 20 74 61 6b 65 73 20 6f |ject. It| takes o|
|000046e0| 74 68 65 72 20 6f 62 6a | 65 63 74 73 0a 61 73 20 |ther obj|ects.as |
|000046f0| 69 74 73 20 61 72 67 75 | 6d 65 6e 74 73 2e 20 45 |its argu|ments. E|
|00004700| 76 65 72 79 20 67 72 6f | 75 70 20 68 61 73 20 74 |very gro|up has t|
|00004710| 6f 20 62 65 20 74 65 72 | 6d 69 6e 61 74 65 64 20 |o be ter|minated |
|00004720| 77 69 74 68 20 61 20 40 | 63 6f 64 65 7b 54 52 47 |with a @|code{TRG|
|00004730| 52 5f 45 6e 64 7d 0a 74 | 61 67 2e 20 41 20 74 79 |R_End}.t|ag. A ty|
|00004740| 70 69 63 61 6c 20 68 6f | 72 69 7a 6f 6e 74 61 6c |pical ho|rizontal|
|00004750| 20 67 72 6f 75 70 2c 20 | 77 68 69 63 68 20 63 6f | group, |which co|
|00004760| 6e 74 61 69 6e 73 20 61 | 20 43 68 65 63 6b 42 6f |ntains a| CheckBo|
|00004770| 78 2c 20 61 20 73 70 61 | 63 65 20 61 6e 64 0a 61 |x, a spa|ce and.a|
|00004780| 67 61 69 6e 20 61 20 43 | 68 65 63 6b 42 6f 78 2c |gain a C|heckBox,|
|00004790| 20 77 6f 75 6c 64 20 6c | 6f 6f 6b 20 6c 69 6b 65 | would l|ook like|
|000047a0| 20 74 68 69 73 3a 0a 0a | 40 65 78 61 6d 70 6c 65 | this:..|@example|
|000047b0| 0a 20 20 20 20 54 52 47 | 52 5f 48 6f 72 69 7a 2c |. TRG|R_Horiz,|
|000047c0| 20 20 20 20 20 20 54 52 | 47 52 5f 50 52 4f 50 53 | TR|GR_PROPS|
|000047d0| 48 41 52 45 7c 54 52 47 | 52 5f 41 4c 49 47 4e 7c |HARE|TRG|R_ALIGN||
|000047e0| 54 52 47 52 5f 43 45 4e | 54 45 52 2c 0a 0a 20 20 |TRGR_CEN|TER,.. |
|000047f0| 20 20 20 20 54 52 4f 42 | 5f 43 68 65 63 6b 42 6f | TROB|_CheckBo|
|00004800| 78 2c 20 30 2c 0a 20 20 | 20 20 20 20 20 20 54 52 |x, 0,. | TR|
|00004810| 41 54 5f 49 44 2c 20 20 | 20 20 20 31 2c 0a 0a 20 |AT_ID, | 1,.. |
|00004820| 20 20 20 20 20 54 52 4f | 42 5f 53 70 61 63 65 2c | TRO|B_Space,|
|00004830| 20 20 20 20 54 52 53 54 | 5f 4e 4f 52 4d 41 4c 2c | TRST|_NORMAL,|
|00004840| 0a 0a 20 20 20 20 20 20 | 54 52 4f 42 5f 43 68 65 |.. |TROB_Che|
|00004850| 63 6b 42 6f 78 2c 20 30 | 2c 0a 20 20 20 20 20 20 |ckBox, 0|,. |
|00004860| 20 20 54 52 41 54 5f 56 | 61 6c 75 65 2c 20 20 54 | TRAT_V|alue, T|
|00004870| 52 55 45 2c 0a 20 20 20 | 20 20 20 20 20 54 52 41 |RUE,. | TRA|
|00004880| 54 5f 49 44 2c 20 20 20 | 20 20 32 2c 0a 0a 20 20 |T_ID, | 2,.. |
|00004890| 20 20 20 20 54 52 47 52 | 5f 45 6e 64 2c 20 20 20 | TRGR|_End, |
|000048a0| 20 20 20 30 0a 40 65 6e | 64 20 65 78 61 6d 70 6c | 0.@en|d exampl|
|000048b0| 65 0a 0a 53 65 65 20 74 | 68 65 20 40 63 6f 64 65 |e..See t|he @code|
|000048c0| 7b 47 72 6f 75 70 73 7d | 20 77 69 6e 64 6f 77 20 |{Groups}| window |
|000048d0| 6f 66 20 74 68 65 20 54 | 72 69 74 6f 6e 20 64 65 |of the T|riton de|
|000048e0| 6d 6f 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 66 |mo appli|cation f|
|000048f0| 6f 72 20 61 0a 6d 6f 72 | 65 20 64 65 74 61 69 6c |or a.mor|e detail|
|00004900| 65 64 20 65 78 61 6d 70 | 6c 65 20 6f 6e 20 67 72 |ed examp|le on gr|
|00004910| 6f 75 70 73 20 61 6e 64 | 20 61 72 72 61 79 73 2e |oups and| arrays.|
|00004920| 0a 0a 40 6e 6f 64 65 20 | 54 55 54 5f 4d 41 43 2c |..@node |TUT_MAC,|
|00004930| 20 54 55 54 5f 50 4f 4c | 2c 20 54 55 54 5f 4c 41 | TUT_POL|, TUT_LA|
|00004940| 59 2c 20 54 6f 70 0a 40 | 73 65 63 74 69 6f 6e 20 |Y, Top.@|section |
|00004950| 4d 61 63 72 6f 73 0a 40 | 63 69 6e 64 65 78 20 4d |Macros.@|cindex M|
|00004960| 61 63 72 6f 73 0a 0a 54 | 68 65 20 43 20 68 65 61 |acros..T|he C hea|
|00004970| 64 65 72 20 66 69 6c 65 | 20 40 66 69 6c 65 7b 44 |der file| @file{D|
|00004980| 65 76 65 6c 6f 70 65 72 | 2f 49 6e 63 6c 75 64 65 |eveloper|/Include|
|00004990| 2f 6c 69 62 72 61 72 69 | 65 73 2f 74 72 69 74 6f |/librari|es/trito|
|000049a0| 6e 2e 68 7d 20 63 6f 6e | 74 61 69 6e 73 0a 71 75 |n.h} con|tains.qu|
|000049b0| 69 74 65 20 61 20 6c 6f | 74 20 6f 66 20 6d 61 63 |ite a lo|t of mac|
|000049c0| 72 6f 20 64 65 66 69 6e | 69 74 69 6f 6e 73 20 77 |ro defin|itions w|
|000049d0| 68 69 63 68 20 6d 61 6b | 65 20 63 72 65 61 74 69 |hich mak|e creati|
|000049e0| 6e 67 20 61 20 54 72 69 | 74 6f 6e 20 47 55 49 20 |ng a Tri|ton GUI |
|000049f0| 6d 75 63 68 0a 65 61 73 | 69 65 72 2e 20 57 69 74 |much.eas|ier. Wit|
|00004a00| 68 20 74 68 65 20 68 65 | 6c 70 20 6f 66 20 74 68 |h the he|lp of th|
|00004a10| 65 20 70 72 65 70 72 6f | 63 65 73 73 6f 72 20 40 |e prepro|cessor @|
|00004a20| 63 6f 64 65 7b 4d 61 63 | 32 45 7d 20 74 68 65 73 |code{Mac|2E} thes|
|00004a30| 65 20 6d 61 63 72 6f 73 | 0a 61 72 65 20 61 6c 73 |e macros|.are als|
|00004a40| 6f 20 61 76 61 69 6c 61 | 62 6c 65 20 69 6e 20 40 |o availa|ble in @|
|00004a50| 63 6f 64 65 7b 41 6d 69 | 67 61 45 7d 2e 20 4f 74 |code{Ami|gaE}. Ot|
|00004a60| 68 65 72 20 6c 61 6e 67 | 75 61 67 65 73 20 6f 72 |her lang|uages or|
|00004a70| 20 63 6f 6d 70 69 6c 65 | 72 73 20 6d 61 79 0a 73 | compile|rs may.s|
|00004a80| 75 70 70 6f 72 74 20 73 | 69 6d 69 6c 61 72 20 6f |upport s|imilar o|
|00004a90| 72 20 64 69 66 66 65 72 | 65 6e 74 20 6d 61 63 72 |r differ|ent macr|
|00004aa0| 6f 73 20 6f 72 20 6e 6f | 6e 65 20 61 74 20 61 6c |os or no|ne at al|
|00004ab0| 6c 2e 20 49 66 20 6e 6f | 20 6d 61 63 72 6f 73 20 |l. If no| macros |
|00004ac0| 61 72 65 0a 61 76 61 69 | 6c 61 62 6c 65 20 69 6e |are.avai|lable in|
|00004ad0| 20 79 6f 75 72 20 64 65 | 76 65 6c 6f 70 6d 65 6e | your de|velopmen|
|00004ae0| 74 20 73 79 73 74 65 6d | 2c 20 79 6f 75 20 68 61 |t system|, you ha|
|00004af0| 76 65 20 74 6f 20 64 6f | 20 69 74 20 74 68 65 20 |ve to do| it the |
|00004b00| 74 72 61 64 69 74 69 6f | 6e 61 6c 0a 77 61 79 2e |traditio|nal.way.|
|00004b10| 20 49 66 20 79 6f 75 20 | 63 61 6e 20 75 73 65 20 | If you |can use |
|00004b20| 6d 61 63 72 6f 73 2c 20 | 75 73 65 20 74 68 65 6d |macros, |use them|
|00004b30| 2e 0a 0a 54 68 65 20 73 | 74 61 74 69 63 20 74 61 |...The s|tatic ta|
|00004b40| 67 6c 69 73 74 20 64 65 | 66 69 6e 69 74 69 6f 6e |glist de|finition|
|00004b50| 20 63 61 6e 20 62 65 20 | 77 72 69 74 74 65 6e 20 | can be |written |
|00004b60| 61 20 62 69 74 20 73 69 | 6d 70 6c 65 72 20 77 69 |a bit si|mpler wi|
|00004b70| 74 68 20 6d 61 63 72 6f | 73 3a 0a 0a 40 65 78 61 |th macro|s:..@exa|
|00004b80| 6d 70 6c 65 0a 20 20 20 | 20 50 72 6f 6a 65 63 74 |mple. | Project|
|00004b90| 44 65 66 69 6e 69 74 69 | 6f 6e 28 64 75 6d 6d 79 |Definiti|on(dummy|
|00004ba0| 54 61 67 73 29 0a 20 20 | 20 20 40 7b 0a 20 20 20 |Tags). | @{. |
|00004bb0| 20 20 20 2f 2a 20 49 6e | 73 65 72 74 20 70 72 6f | /* In|sert pro|
|00004bc0| 6a 65 63 74 20 74 61 67 | 73 20 68 65 72 65 20 2a |ject tag|s here *|
|00004bd0| 2f 0a 20 20 20 20 40 7d | 3b 0a 40 65 6e 64 20 65 |/. @}|;.@end e|
|00004be0| 78 61 6d 70 6c 65 0a 0a | 42 75 74 20 74 68 65 20 |xample..|But the |
|00004bf0| 6d 61 69 6e 20 75 73 65 | 20 66 6f 72 20 6d 61 63 |main use| for mac|
|00004c00| 72 6f 73 20 61 72 65 20 | 74 68 65 20 74 61 67 73 |ros are |the tags|
|00004c10| 20 74 68 65 6d 73 65 6c | 76 65 73 2e 20 46 6f 72 | themsel|ves. For|
|00004c20| 20 65 78 61 6d 70 6c 65 | 2c 20 74 68 65 20 74 61 | example|, the ta|
|00004c30| 67 73 0a 66 72 6f 6d 20 | 74 68 65 20 64 75 6d 6d |gs.from |the dumm|
|00004c40| 79 20 77 69 6e 64 6f 77 | 20 65 78 61 6d 70 6c 65 |y window| example|
|00004c50| 20 28 73 65 65 20 40 72 | 65 66 7b 54 55 54 5f 50 | (see @r|ef{TUT_P|
|00004c60| 52 4f 2c 20 50 72 6f 6a | 65 63 74 73 2c 20 54 75 |RO, Proj|ects, Tu|
|00004c70| 74 6f 72 69 61 6c 20 2d | 20 50 72 6f 6a 65 63 74 |torial -| Project|
|00004c80| 73 7d 29 0a 77 6f 75 6c | 64 20 6c 6f 6f 6b 20 6c |s}).woul|d look l|
|00004c90| 69 6b 65 20 74 68 69 73 | 3a 0a 0a 40 65 78 61 6d |ike this|:..@exam|
|00004ca0| 70 6c 65 0a 20 20 20 20 | 20 20 57 69 6e 64 6f 77 |ple. | Window|
|00004cb0| 54 69 74 6c 65 28 22 41 | 20 64 75 6d 6d 79 20 77 |Title("A| dummy w|
|00004cc0| 69 6e 64 6f 77 22 29 2c | 0a 20 20 20 20 20 20 57 |indow"),|. W|
|00004cd0| 69 6e 64 6f 77 49 44 28 | 34 32 29 2c 0a 20 20 20 |indowID(|42),. |
|00004ce0| 20 20 20 45 6e 64 50 72 | 6f 6a 65 63 74 0a 40 65 | EndPr|oject.@e|
|00004cf0| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 0a 48 61 76 65 |nd examp|le..Have|
|00004d00| 20 61 20 6c 6f 6f 6b 20 | 61 74 20 74 68 65 20 6d | a look |at the m|
|00004d10| 61 63 72 6f 20 64 65 66 | 69 6e 69 74 69 6f 6e 73 |acro def|initions|
|00004d20| 20 61 6e 64 20 74 68 65 | 20 73 75 70 70 6c 69 65 | and the| supplie|
|00004d30| 64 20 64 65 6d 6f 20 61 | 70 70 6c 69 63 61 74 69 |d demo a|pplicati|
|00004d40| 6f 6e 73 0a 66 6f 72 20 | 6d 6f 72 65 20 64 65 74 |ons.for |more det|
|00004d50| 61 69 6c 65 64 20 69 6e | 66 6f 72 6d 61 74 69 6f |ailed in|formatio|
|00004d60| 6e 20 61 62 6f 75 74 20 | 74 68 65 20 6d 61 63 72 |n about |the macr|
|00004d70| 6f 73 2e 0a 0a 40 6e 6f | 64 65 20 54 55 54 5f 50 |os...@no|de TUT_P|
|00004d80| 4f 4c 2c 20 54 55 54 5f | 4d 45 53 2c 20 54 55 54 |OL, TUT_|MES, TUT|
|00004d90| 5f 4d 41 43 2c 20 54 6f | 70 0a 40 73 65 63 74 69 |_MAC, To|p.@secti|
|00004da0| 6f 6e 20 50 6f 6c 6c 69 | 6e 67 20 4c 6f 6f 70 0a |on Polli|ng Loop.|
|00004db0| 40 63 69 6e 64 65 78 20 | 50 6f 6c 6c 69 6e 67 20 |@cindex |Polling |
|00004dc0| 4c 6f 6f 70 0a 40 63 69 | 6e 64 65 78 20 4c 6f 6f |Loop.@ci|ndex Loo|
|00004dd0| 70 2c 20 50 6f 6c 6c 69 | 6e 67 0a 0a 41 66 74 65 |p, Polli|ng..Afte|
|00004de0| 72 20 63 72 65 61 74 69 | 6e 67 20 61 20 47 55 49 |r creati|ng a GUI|
|00004df0| 20 79 6f 75 20 68 61 76 | 65 20 74 6f 20 68 61 6e | you hav|e to han|
|00004e00| 64 6c 65 20 75 73 65 72 | 20 69 6e 70 75 74 2e 20 |dle user| input. |
|00004e10| 49 6e 20 6f 72 64 65 72 | 20 74 6f 20 61 63 63 6f |In order| to acco|
|00004e20| 6d 70 6c 69 73 68 0a 74 | 68 69 73 20 74 61 73 6b |mplish.t|his task|
|00004e30| 2c 20 54 72 69 74 6f 6e | 20 6f 66 66 65 72 73 20 |, Triton| offers |
|00004e40| 61 20 70 6f 6c 6c 69 6e | 67 20 73 79 73 74 65 6d |a pollin|g system|
|00004e50| 20 77 68 69 63 68 20 72 | 65 73 65 6d 62 6c 65 73 | which r|esembles|
|00004e60| 20 74 68 65 20 49 6e 74 | 75 69 74 69 6f 6e 0a 49 | the Int|uition.I|
|00004e70| 44 43 4d 50 20 70 6f 6c | 6c 69 6e 67 20 73 79 73 |DCMP pol|ling sys|
|00004e80| 74 65 6d 20 76 65 72 79 | 20 6d 75 63 68 2e 20 41 |tem very| much. A|
|00004e90| 20 62 61 73 69 63 20 70 | 6f 6c 6c 69 6e 67 20 6c | basic p|olling l|
|00004ea0| 6f 6f 70 20 6c 6f 6f 6b | 73 20 6c 69 6b 65 20 74 |oop look|s like t|
|00004eb0| 68 69 73 3a 0a 0a 40 65 | 78 61 6d 70 6c 65 0a 20 |his:..@e|xample. |
|00004ec0| 20 20 20 76 6f 69 64 20 | 68 61 6e 64 6c 65 44 75 | void |handleDu|
|00004ed0| 6d 6d 79 57 69 6e 64 6f | 77 28 76 6f 69 64 29 0a |mmyWindo|w(void).|
|00004ee0| 20 20 20 20 40 7b 0a 20 | 20 20 20 20 20 42 4f 4f | @{. | BOO|
|00004ef0| 4c 20 63 6c 6f 73 65 4d | 65 3d 46 41 4c 53 45 3b |L closeM|e=FALSE;|
|00004f00| 0a 20 20 20 20 20 20 73 | 74 72 75 63 74 20 54 52 |. s|truct TR|
|00004f10| 5f 4d 65 73 73 61 67 65 | 20 2a 74 72 4d 73 67 3b |_Message| *trMsg;|
|00004f20| 0a 0a 20 20 20 20 20 20 | 2f 2a 20 4f 70 65 6e 20 |.. |/* Open |
|00004f30| 74 68 65 20 77 69 6e 64 | 6f 77 2e 2e 2e 20 2a 2f |the wind|ow... */|
|00004f40| 0a 0a 20 20 20 20 20 20 | 77 68 69 6c 65 28 21 63 |.. |while(!c|
|00004f50| 6c 6f 73 65 4d 65 29 0a | 20 20 20 20 20 20 40 7b |loseMe).| @{|
|00004f60| 0a 20 20 20 20 20 20 20 | 20 54 52 5f 57 61 69 74 |. | TR_Wait|
|00004f70| 28 41 70 70 6c 69 63 61 | 74 69 6f 6e 2c 4e 55 4c |(Applica|tion,NUL|
|00004f80| 4c 29 3b 0a 20 20 20 20 | 20 20 20 20 77 68 69 6c |L);. | whil|
|00004f90| 65 28 74 72 4d 73 67 3d | 54 52 5f 47 65 74 4d 73 |e(trMsg=|TR_GetMs|
|00004fa0| 67 28 41 70 70 6c 69 63 | 61 74 69 6f 6e 29 29 0a |g(Applic|ation)).|
|00004fb0| 20 20 20 20 20 20 20 20 | 40 7b 0a 20 20 20 20 20 | |@{. |
|00004fc0| 20 20 20 20 20 73 77 69 | 74 63 68 28 74 72 4d 73 | swi|tch(trMs|
|00004fd0| 67 2d 3e 74 72 6d 5f 43 | 6c 61 73 73 29 0a 20 20 |g->trm_C|lass). |
|00004fe0| 20 20 20 20 20 20 20 20 | 40 7b 0a 20 20 20 20 20 | |@{. |
|00004ff0| 20 20 20 20 20 20 20 63 | 61 73 65 20 54 52 4d 53 | c|ase TRMS|
|00005000| 5f 43 4c 4f 53 45 57 49 | 4e 44 4f 57 3a 0a 20 20 |_CLOSEWI|NDOW:. |
|00005010| 20 20 20 20 20 20 20 20 | 20 20 20 20 63 6c 6f 73 | | clos|
|00005020| 65 4d 65 3d 54 52 55 45 | 3b 0a 20 20 20 20 20 20 |eMe=TRUE|;. |
|00005030| 20 20 20 20 20 20 20 20 | 62 72 65 61 6b 3b 0a 0a | |break;..|
|00005040| 20 20 20 20 20 20 20 20 | 20 20 20 20 63 61 73 65 | | case|
|00005050| 20 54 52 4d 53 5f 41 43 | 54 49 4f 4e 3a 0a 20 20 | TRMS_AC|TION:. |
|00005060| 20 20 20 20 20 20 20 20 | 20 20 20 20 73 77 69 74 | | swit|
|00005070| 63 68 28 74 72 6d 73 67 | 2d 3e 74 72 6d 5f 49 44 |ch(trmsg|->trm_ID|
|00005080| 29 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |). | |
|00005090| 40 7b 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |@{. | |
|000050a0| 20 20 20 63 61 73 65 20 | 49 44 5f 46 4f 4f 3a 0a | case |ID_FOO:.|
|000050b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000050c0| 20 20 2f 2a 20 44 6f 20 | 73 6f 6d 65 74 68 69 6e | /* Do |somethin|
|000050d0| 67 2e 2e 2e 20 2a 2f 0a | 20 20 20 20 20 20 20 20 |g... */.| |
|000050e0| 20 20 20 20 20 20 20 20 | 20 20 62 72 65 61 6b 3b | | break;|
|000050f0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00005100| 20 63 61 73 65 20 49 44 | 5f 42 41 52 3a 0a 20 20 | case ID|_BAR:. |
|00005110| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005120| 2f 2a 20 44 6f 20 73 6f | 6d 65 74 68 69 6e 67 2e |/* Do so|mething.|
|00005130| 2e 2e 20 2a 2f 0a 20 20 | 20 20 20 20 20 20 20 20 |.. */. | |
|00005140| 20 20 20 20 20 20 20 20 | 62 72 65 61 6b 3b 0a 20 | |break;. |
|00005150| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 40 7d 0a | | @}.|
|00005160| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 62 72 | | br|
|00005170| 65 61 6b 3b 0a 0a 20 20 | 20 20 20 20 20 20 20 20 |eak;.. | |
|00005180| 20 20 63 61 73 65 20 54 | 52 4d 53 5f 4e 45 57 56 | case T|RMS_NEWV|
|00005190| 41 4c 55 45 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |ALUE:. | |
|000051a0| 20 20 20 20 73 77 69 74 | 63 68 28 74 72 4d 73 67 | swit|ch(trMsg|
|000051b0| 2d 3e 74 72 6d 5f 49 44 | 29 0a 20 20 20 20 20 20 |->trm_ID|). |
|000051c0| 20 20 20 20 20 20 20 20 | 40 7b 0a 20 20 20 20 20 | |@{. |
|000051d0| 20 20 20 20 20 20 20 20 | 20 20 20 2f 2a 20 4e 65 | | /* Ne|
|000051e0| 77 20 76 61 6c 75 65 20 | 69 73 20 69 6e 20 74 72 |w value |is in tr|
|000051f0| 4d 73 67 2d 3e 74 72 6d | 5f 44 61 74 61 20 2a 2f |Msg->trm|_Data */|
|00005200| 0a 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.. | |
|00005210| 20 20 63 61 73 65 20 49 | 44 5f 4d 59 43 48 45 43 | case I|D_MYCHEC|
|00005220| 4b 42 4f 58 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |KBOX:. | |
|00005230| 20 20 20 20 20 20 20 20 | 2f 2a 20 44 6f 20 73 6f | |/* Do so|
|00005240| 6d 65 74 68 69 6e 67 2e | 2e 2e 20 2a 2f 0a 20 20 |mething.|.. */. |
|00005250| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005260| 62 72 65 61 6b 3b 0a 20 | 20 20 20 20 20 20 20 20 |break;. | |
|00005270| 20 20 20 20 20 20 20 63 | 61 73 65 20 49 44 5f 4d | c|ase ID_M|
|00005280| 59 53 4c 49 44 45 52 3a | 0a 20 20 20 20 20 20 20 |YSLIDER:|. |
|00005290| 20 20 20 20 20 20 20 20 | 20 20 20 2f 2a 20 44 6f | | /* Do|
|000052a0| 20 73 6f 6d 65 74 68 69 | 6e 67 2e 2e 2e 20 2a 2f | somethi|ng... */|
|000052b0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|000052c0| 20 20 20 62 72 65 61 6b | 3b 0a 20 20 20 20 20 20 | break|;. |
|000052d0| 20 20 20 20 20 20 20 20 | 40 7d 0a 20 20 20 20 20 | |@}. |
|000052e0| 20 20 20 20 20 20 20 20 | 20 62 72 65 61 6b 3b 0a | | break;.|
|000052f0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 63 61 73 |. | cas|
|00005300| 65 20 54 52 4d 53 5f 45 | 52 52 4f 52 3a 0a 20 20 |e TRMS_E|RROR:. |
|00005310| 20 20 20 20 20 20 20 20 | 20 20 20 20 70 75 74 73 | | puts|
|00005320| 28 54 52 5f 47 65 74 45 | 72 72 6f 72 53 74 72 69 |(TR_GetE|rrorStri|
|00005330| 6e 67 28 74 72 4d 73 67 | 2d 3e 74 72 6d 5f 44 61 |ng(trMsg|->trm_Da|
|00005340| 74 61 29 29 3b 0a 20 20 | 20 20 20 20 20 20 20 20 |ta));. | |
|00005350| 20 20 20 20 62 72 65 61 | 6b 3b 0a 20 20 20 20 20 | brea|k;. |
|00005360| 20 20 20 20 20 40 7d 0a | 20 20 20 20 20 20 20 20 | @}.| |
|00005370| 20 20 54 52 5f 52 65 70 | 6c 79 4d 73 67 28 74 72 | TR_Rep|lyMsg(tr|
|00005380| 4d 73 67 29 3b 0a 20 20 | 20 20 20 20 20 20 40 7d |Msg);. | @}|
|00005390| 0a 20 20 20 20 20 20 40 | 7d 0a 0a 20 20 20 20 20 |. @|}.. |
|000053a0| 20 2f 2a 20 43 6c 6f 73 | 65 20 74 68 65 20 77 69 | /* Clos|e the wi|
|000053b0| 6e 64 6f 77 2e 2e 2e 20 | 2a 2f 0a 20 20 20 20 40 |ndow... |*/. @|
|000053c0| 7d 0a 40 65 6e 64 20 65 | 78 61 6d 70 6c 65 0a 0a |}.@end e|xample..|
|000053d0| 40 73 74 72 6f 6e 67 7b | 4e 6f 74 65 3a 7d 20 44 |@strong{|Note:} D|
|000053e0| 6f 6e 27 74 20 66 6f 72 | 67 65 74 20 74 6f 20 72 |on't for|get to r|
|000053f0| 65 70 6c 79 20 61 6c 6c | 20 6d 65 73 73 61 67 65 |eply all| message|
|00005400| 73 21 0a 0a 59 6f 75 20 | 63 6f 75 6c 64 20 61 64 |s!..You |could ad|
|00005410| 64 20 61 20 40 63 6f 64 | 65 7b 73 77 69 74 63 68 |d a @cod|e{switch|
|00005420| 28 29 7d 20 66 6f 72 20 | 74 68 65 20 70 72 6f 6a |()} for |the proj|
|00005430| 65 63 74 20 77 68 69 63 | 68 20 73 65 6e 74 20 74 |ect whic|h sent t|
|00005440| 68 65 20 6d 65 73 73 61 | 67 65 20 69 66 0a 79 6f |he messa|ge if.yo|
|00005450| 75 20 68 61 76 65 20 6d | 6f 72 65 20 74 68 61 6e |u have m|ore than|
|00005460| 20 6f 6e 65 20 70 72 6f | 6a 65 63 74 20 6f 70 65 | one pro|ject ope|
|00005470| 6e 65 64 2c 20 62 75 74 | 20 61 20 62 65 74 74 65 |ned, but| a bette|
|00005480| 72 20 77 61 79 20 69 73 | 20 74 6f 20 75 73 65 20 |r way is| to use |
|00005490| 75 6e 69 71 75 65 0a 6f | 62 6a 65 63 74 20 49 44 |unique.o|bject ID|
|000054a0| 73 2e 20 54 68 69 73 20 | 64 6f 65 73 20 61 6c 73 |s. This |does als|
|000054b0| 6f 20 79 69 65 6c 64 20 | 74 68 65 20 61 64 76 61 |o yield |the adva|
|000054c0| 6e 74 61 67 65 20 74 68 | 61 74 20 6d 6f 76 69 6e |ntage th|at movin|
|000054d0| 67 20 61 6e 20 6f 62 6a | 65 63 74 20 66 72 6f 6d |g an obj|ect from|
|000054e0| 0a 6f 6e 65 20 77 69 6e | 64 6f 77 20 74 6f 20 61 |.one win|dow to a|
|000054f0| 6e 6f 74 68 65 72 20 64 | 6f 65 73 20 6e 6f 74 20 |nother d|oes not |
|00005500| 72 65 71 75 69 72 65 20 | 61 6e 79 20 63 68 61 6e |require |any chan|
|00005510| 67 65 20 69 6e 20 74 68 | 65 20 6d 65 73 73 61 67 |ge in th|e messag|
|00005520| 65 20 68 61 6e 64 6c 69 | 6e 67 2e 0a 0a 49 74 20 |e handli|ng...It |
|00005530| 69 73 20 63 75 72 72 65 | 6e 74 6c 79 20 6e 6f 74 |is curre|ntly not|
|00005540| 20 76 65 72 79 20 77 65 | 6c 6c 20 64 6f 63 75 6d | very we|ll docum|
|00005550| 65 6e 74 65 64 20 77 68 | 69 63 68 20 6d 65 73 73 |ented wh|ich mess|
|00005560| 61 67 65 73 20 61 72 65 | 20 73 65 6e 74 20 62 79 |ages are| sent by|
|00005570| 20 74 68 65 0a 64 69 66 | 66 65 72 65 6e 74 20 6f | the.dif|ferent o|
|00005580| 62 6a 65 63 74 73 2e 20 | 41 73 20 61 20 67 65 6e |bjects. |As a gen|
|00005590| 65 72 61 6c 20 72 75 6c | 65 2c 20 61 63 74 69 76 |eral rul|e, activ|
|000055a0| 61 74 61 62 6c 65 20 6f | 62 6a 65 63 74 73 20 73 |atable o|bjects s|
|000055b0| 65 6e 64 20 40 63 6f 64 | 65 7b 54 52 4d 53 5f 41 |end @cod|e{TRMS_A|
|000055c0| 43 54 49 4f 4e 7d 0a 61 | 6e 64 20 6f 62 6a 65 63 |CTION}.a|nd objec|
|000055d0| 74 73 20 77 68 69 63 68 | 20 68 61 76 65 20 61 20 |ts which| have a |
|000055e0| 40 63 6f 64 65 7b 54 52 | 41 54 5f 56 61 6c 75 65 |@code{TR|AT_Value|
|000055f0| 7d 20 6f 72 20 61 20 73 | 69 6d 69 6c 61 72 20 6d |} or a s|imilar m|
|00005600| 6f 64 69 66 69 61 62 6c | 65 20 74 61 67 2c 0a 73 |odifiabl|e tag,.s|
|00005610| 65 6e 64 20 40 63 6f 64 | 65 7b 54 52 4d 53 5f 4e |end @cod|e{TRMS_N|
|00005620| 45 57 56 41 4c 55 45 7d | 2e 0a 0a 48 65 72 65 20 |EWVALUE}|...Here |
|00005630| 69 73 20 61 20 6d 6f 72 | 65 20 64 65 74 61 69 6c |is a mor|e detail|
|00005640| 65 64 20 64 65 73 63 72 | 69 70 74 69 6f 6e 20 6f |ed descr|iption o|
|00005650| 66 20 74 68 65 20 6d 65 | 73 73 61 67 65 20 74 79 |f the me|ssage ty|
|00005660| 70 65 73 3a 0a 0a 40 69 | 74 65 6d 69 7a 65 20 40 |pes:..@i|temize @|
|00005670| 62 75 6c 6c 65 74 0a 40 | 69 74 65 6d 0a 40 63 6f |bullet.@|item.@co|
|00005680| 64 65 7b 54 52 4d 53 5f | 43 4c 4f 53 45 57 49 4e |de{TRMS_|CLOSEWIN|
|00005690| 44 4f 57 7d 3a 20 54 68 | 65 20 75 73 65 72 20 68 |DOW}: Th|e user h|
|000056a0| 61 73 20 70 72 65 73 73 | 65 64 20 74 68 65 20 63 |as press|ed the c|
|000056b0| 6c 6f 73 65 20 67 61 64 | 67 65 74 20 6f 72 20 74 |lose gad|get or t|
|000056c0| 68 65 20 40 63 6f 64 65 | 7b 45 73 63 7d 20 6b 65 |he @code|{Esc} ke|
|000056d0| 79 0a 28 69 66 20 69 74 | 20 68 61 73 6e 27 74 20 |y.(if it| hasn't |
|000056e0| 62 65 65 6e 20 64 69 73 | 61 62 6c 65 64 20 77 69 |been dis|abled wi|
|000056f0| 74 68 20 40 63 6f 64 65 | 7b 54 52 57 46 5f 4e 4f |th @code|{TRWF_NO|
|00005700| 45 53 43 43 4c 4f 53 45 | 7d 29 2e 0a 40 69 74 65 |ESCCLOSE|})..@ite|
|00005710| 6d 0a 40 63 6f 64 65 7b | 54 52 4d 53 5f 45 52 52 |m.@code{|TRMS_ERR|
|00005720| 4f 52 7d 3a 20 41 6e 20 | 65 72 72 6f 72 20 6f 63 |OR}: An |error oc|
|00005730| 63 75 72 65 64 2e 20 40 | 63 6f 64 65 7b 54 52 5f |cured. @|code{TR_|
|00005740| 4d 65 73 73 61 67 65 2e | 74 72 6d 5f 44 61 74 61 |Message.|trm_Data|
|00005750| 7d 20 63 6f 6e 74 61 69 | 6e 73 20 74 68 65 20 65 |} contai|ns the e|
|00005760| 72 72 6f 72 0a 63 6f 64 | 65 2e 20 59 6f 75 20 63 |rror.cod|e. You c|
|00005770| 61 6e 20 75 73 65 20 40 | 63 6f 64 65 7b 54 52 5f |an use @|code{TR_|
|00005780| 47 65 74 45 72 72 6f 72 | 53 74 72 69 6e 67 28 29 |GetError|String()|
|00005790| 7d 20 74 6f 20 67 65 6e | 65 72 61 74 65 20 61 20 |} to gen|erate a |
|000057a0| 75 73 65 72 2d 72 65 61 | 64 61 62 6c 65 20 65 72 |user-rea|dable er|
|000057b0| 72 6f 72 0a 6d 65 73 73 | 61 67 65 20 66 72 6f 6d |ror.mess|age from|
|000057c0| 20 74 68 69 73 20 65 72 | 72 6f 72 20 63 6f 64 65 | this er|ror code|
|000057d0| 2e 0a 40 69 74 65 6d 0a | 40 63 6f 64 65 7b 54 52 |..@item.|@code{TR|
|000057e0| 4d 53 5f 4e 45 57 56 41 | 4c 55 45 7d 3a 20 41 6e |MS_NEWVA|LUE}: An|
|000057f0| 20 6f 62 6a 65 63 74 27 | 73 20 61 74 74 72 69 62 | object'|s attrib|
|00005800| 75 74 65 20 68 61 73 20 | 63 68 61 6e 67 65 64 2e |ute has |changed.|
|00005810| 20 40 63 6f 64 65 7b 54 | 52 5f 4d 65 73 73 61 67 | @code{T|R_Messag|
|00005820| 65 2e 74 72 6d 5f 44 61 | 74 61 7d 20 63 6f 6e 74 |e.trm_Da|ta} cont|
|00005830| 61 69 6e 73 0a 74 68 65 | 20 6e 65 77 20 76 61 6c |ains.the| new val|
|00005840| 75 65 20 66 6f 72 20 74 | 68 65 20 61 74 74 72 69 |ue for t|he attri|
|00005850| 62 75 74 65 2e 0a 40 69 | 74 65 6d 0a 40 63 6f 64 |bute..@i|tem.@cod|
|00005860| 65 7b 54 52 4d 53 5f 41 | 43 54 49 4f 4e 7d 3a 20 |e{TRMS_A|CTION}: |
|00005870| 41 6e 20 6f 62 6a 65 63 | 74 20 68 61 73 20 62 65 |An objec|t has be|
|00005880| 65 6e 20 61 63 74 69 76 | 61 74 65 64 20 73 6f 6d |en activ|ated som|
|00005890| 65 68 6f 77 20 28 65 2e | 67 2e 20 61 20 62 75 74 |ehow (e.|g. a but|
|000058a0| 74 6f 6e 20 68 61 73 20 | 62 65 65 6e 20 70 72 65 |ton has |been pre|
|000058b0| 73 73 65 64 0a 6f 72 20 | 69 74 73 20 6b 65 79 62 |ssed.or |its keyb|
|000058c0| 6f 61 72 64 20 73 68 6f | 72 74 63 75 74 20 77 61 |oard sho|rtcut wa|
|000058d0| 73 20 75 73 65 64 20 69 | 6e 73 74 65 61 64 29 2e |s used i|nstead).|
|000058e0| 0a 40 69 74 65 6d 0a 40 | 63 6f 64 65 7b 54 52 4d |.@item.@|code{TRM|
|000058f0| 53 5f 49 43 4f 4e 44 52 | 4f 50 50 45 44 7d 3a 20 |S_ICONDR|OPPED}: |
|00005900| 41 6e 20 69 63 6f 6e 20 | 68 61 73 20 62 65 65 6e |An icon |has been|
|00005910| 20 64 72 6f 70 70 65 64 | 20 6f 76 65 72 20 61 20 | dropped| over a |
|00005920| 77 69 6e 64 6f 77 2e 0a | 59 6f 75 20 77 69 6c 6c |window..|You will|
|00005930| 20 67 65 74 20 74 68 69 | 73 20 6d 65 73 73 61 67 | get thi|s messag|
|00005940| 65 20 6f 6e 6c 79 20 69 | 66 20 61 6e 20 6f 62 6a |e only i|f an obj|
|00005950| 65 63 74 20 69 6e 20 79 | 6f 75 72 0a 77 69 6e 64 |ect in y|our.wind|
|00005960| 6f 77 20 72 65 61 63 74 | 73 20 6f 6e 20 64 72 6f |ow react|s on dro|
|00005970| 70 70 65 64 20 69 63 6f | 6e 73 20 6f 72 20 79 6f |pped ico|ns or yo|
|00005980| 75 20 61 73 6b 20 64 69 | 72 65 63 74 6c 79 20 66 |u ask di|rectly f|
|00005990| 6f 72 20 69 74 20 62 79 | 0a 73 70 65 63 69 66 79 |or it by|.specify|
|000059a0| 69 6e 67 20 74 68 65 20 | 70 72 6f 6a 65 63 74 20 |ing the |project |
|000059b0| 66 6c 61 67 20 40 63 6f | 64 65 7b 54 52 57 46 5f |flag @co|de{TRWF_|
|000059c0| 41 50 50 57 49 4e 44 4f | 57 7d 2e 20 4f 74 68 65 |APPWINDO|W}. Othe|
|000059d0| 72 77 69 73 65 0a 57 6f | 72 6b 62 65 6e 63 68 20 |rwise.Wo|rkbench |
|000059e0| 77 69 6c 6c 20 6e 6f 74 | 20 61 6c 6c 6f 77 20 79 |will not| allow y|
|000059f0| 6f 75 20 74 6f 20 64 72 | 6f 70 20 69 63 6f 6e 73 |ou to dr|op icons|
|00005a00| 20 6f 76 65 72 20 61 20 | 54 72 69 74 6f 6e 20 77 | over a |Triton w|
|00005a10| 69 6e 64 6f 77 2e 0a 40 | 63 6f 64 65 7b 54 52 5f |indow..@|code{TR_|
|00005a20| 4d 65 73 73 61 67 65 2e | 74 72 6d 5f 49 44 7d 20 |Message.|trm_ID} |
|00005a30| 63 6f 6e 74 61 69 6e 73 | 20 74 68 65 20 49 44 20 |contains| the ID |
|00005a40| 6f 66 20 74 68 65 20 6f | 62 6a 65 63 74 20 6f 76 |of the o|bject ov|
|00005a50| 65 72 20 77 68 69 63 68 | 20 74 68 65 0a 69 63 6f |er which| the.ico|
|00005a60| 6e 20 77 61 73 20 64 72 | 6f 70 70 65 64 20 6f 72 |n was dr|opped or|
|00005a70| 20 30 20 69 66 20 69 74 | 20 77 61 73 20 64 72 6f | 0 if it| was dro|
|00005a80| 70 70 65 64 20 6f 76 65 | 72 20 61 6e 20 6f 62 6a |pped ove|r an obj|
|00005a90| 65 63 74 20 77 69 74 68 | 6f 75 74 20 61 6e 20 49 |ect with|out an I|
|00005aa0| 44 2e 0a 40 63 6f 64 65 | 7b 54 52 5f 4d 65 73 73 |D..@code|{TR_Mess|
|00005ab0| 61 67 65 2e 74 72 6d 5f | 44 61 74 61 7d 20 63 6f |age.trm_|Data} co|
|00005ac0| 6e 74 61 69 6e 73 20 61 | 20 70 6f 69 6e 74 65 72 |ntains a| pointer|
|00005ad0| 20 74 6f 20 74 68 65 20 | 40 63 6f 64 65 7b 73 74 | to the |@code{st|
|00005ae0| 72 75 63 74 20 41 70 70 | 4d 65 73 73 61 67 65 7d |ruct App|Message}|
|00005af0| 0a 77 68 69 63 68 20 77 | 61 73 20 73 65 6e 74 20 |.which w|as sent |
|00005b00| 62 79 20 57 6f 72 6b 62 | 65 6e 63 68 2e 0a 40 69 |by Workb|ench..@i|
|00005b10| 74 65 6d 0a 40 63 6f 64 | 65 7b 54 52 4d 53 5f 4b |tem.@cod|e{TRMS_K|
|00005b20| 45 59 50 52 45 53 53 45 | 44 7d 3a 20 41 20 6b 65 |EYPRESSE|D}: A ke|
|00005b30| 79 20 68 61 73 20 62 65 | 65 6e 20 70 72 65 73 73 |y has be|en press|
|00005b40| 65 64 20 61 6e 64 20 54 | 72 69 74 6f 6e 20 77 61 |ed and T|riton wa|
|00005b50| 73 20 6e 6f 74 20 61 62 | 6c 65 20 74 6f 0a 69 64 |s not ab|le to.id|
|00005b60| 65 6e 74 69 66 79 20 69 | 74 20 28 65 2e 67 2e 20 |entify i|t (e.g. |
|00005b70| 61 73 20 61 20 6b 65 79 | 62 6f 61 72 64 20 73 68 |as a key|board sh|
|00005b80| 6f 72 74 63 75 74 29 2e | 0a 40 63 6f 64 65 7b 54 |ortcut).|.@code{T|
|00005b90| 52 5f 4d 65 73 73 61 67 | 65 2e 74 72 6d 5f 44 61 |R_Messag|e.trm_Da|
|00005ba0| 74 61 7d 20 63 6f 6e 74 | 61 69 6e 73 20 74 68 65 |ta} cont|ains the|
|00005bb0| 20 41 53 43 49 49 20 63 | 6f 64 65 20 28 69 66 20 | ASCII c|ode (if |
|00005bc0| 61 76 61 69 6c 61 62 6c | 65 2c 0a 6f 74 68 65 72 |availabl|e,.other|
|00005bd0| 77 69 73 65 20 30 29 2c | 0a 40 63 6f 64 65 7b 54 |wise 0),|.@code{T|
|00005be0| 52 5f 4d 65 73 73 61 67 | 65 2e 74 72 6d 5f 43 6f |R_Messag|e.trm_Co|
|00005bf0| 64 65 7d 20 63 6f 6e 74 | 61 69 6e 73 20 74 68 65 |de} cont|ains the|
|00005c00| 20 52 61 77 4b 65 79 20 | 63 6f 64 65 20 61 6e 64 | RawKey |code and|
|00005c10| 20 40 63 6f 64 65 7b 54 | 52 5f 4d 65 73 73 61 67 | @code{T|R_Messag|
|00005c20| 65 2e 74 72 6d 5f 51 75 | 61 6c 69 66 69 65 72 7d |e.trm_Qu|alifier}|
|00005c30| 0a 74 68 65 20 71 75 61 | 6c 69 66 69 65 72 20 62 |.the qua|lifier b|
|00005c40| 69 74 73 2e 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |its..@it|em.@code|
|00005c50| 7b 54 52 4d 53 5f 48 45 | 4c 50 7d 3a 20 54 68 65 |{TRMS_HE|LP}: The|
|00005c60| 20 75 73 65 72 20 72 65 | 71 75 65 73 74 73 20 68 | user re|quests h|
|00005c70| 65 6c 70 20 66 6f 72 20 | 74 68 65 20 6f 62 6a 65 |elp for |the obje|
|00005c80| 63 74 20 73 70 65 63 69 | 66 69 65 64 20 62 79 20 |ct speci|fied by |
|00005c90| 40 63 6f 64 65 7b 54 52 | 5f 4d 65 73 73 61 67 65 |@code{TR|_Message|
|00005ca0| 2e 74 72 6d 5f 49 44 7d | 0a 6f 72 20 66 6f 72 20 |.trm_ID}|.or for |
|00005cb0| 74 68 65 20 77 68 6f 6c | 65 20 77 69 6e 64 6f 77 |the whol|e window|
|00005cc0| 20 69 66 20 74 68 65 20 | 49 44 20 69 73 20 30 2e | if the |ID is 0.|
|00005cd0| 0a 40 65 6e 64 20 69 74 | 65 6d 69 7a 65 0a 0a 41 |.@end it|emize..A|
|00005ce0| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 20 6f 66 20 | descrip|tion of |
|00005cf0| 61 6c 6c 20 66 69 65 6c | 64 73 20 6f 66 20 74 68 |all fiel|ds of th|
|00005d00| 65 20 40 63 6f 64 65 7b | 54 52 5f 4d 65 73 73 61 |e @code{|TR_Messa|
|00005d10| 67 65 7d 20 73 74 72 75 | 63 74 75 72 65 20 63 61 |ge} stru|cture ca|
|00005d20| 6e 20 62 65 20 66 6f 75 | 6e 64 20 69 6e 0a 74 68 |n be fou|nd in.th|
|00005d30| 65 20 43 20 68 65 61 64 | 65 72 20 66 69 6c 65 20 |e C head|er file |
|00005d40| 40 66 69 6c 65 7b 44 65 | 76 65 6c 6f 70 65 72 2f |@file{De|veloper/|
|00005d50| 49 6e 63 6c 75 64 65 2f | 6c 69 62 72 61 72 69 65 |Include/|librarie|
|00005d60| 73 2f 74 72 69 74 6f 6e | 2e 68 7d 2e 0a 0a 40 6e |s/triton|.h}...@n|
|00005d70| 6f 64 65 20 54 55 54 5f | 4d 45 53 2c 20 54 55 54 |ode TUT_|MES, TUT|
|00005d80| 5f 48 45 4c 2c 20 54 55 | 54 5f 50 4f 4c 2c 20 54 |_HEL, TU|T_POL, T|
|00005d90| 6f 70 0a 40 73 65 63 74 | 69 6f 6e 20 4d 65 73 73 |op.@sect|ion Mess|
|00005da0| 61 67 65 73 0a 40 63 69 | 6e 64 65 78 20 53 65 74 |ages.@ci|ndex Set|
|00005db0| 0a 40 63 69 6e 64 65 78 | 20 47 65 74 0a 40 63 69 |.@cindex| Get.@ci|
|00005dc0| 6e 64 65 78 20 4d 65 73 | 73 61 67 65 0a 40 63 69 |ndex Mes|sage.@ci|
|00005dd0| 6e 64 65 78 20 41 74 74 | 72 69 62 75 74 65 0a 40 |ndex Att|ribute.@|
|00005de0| 63 69 6e 64 65 78 20 51 | 75 65 72 79 0a 40 63 69 |cindex Q|uery.@ci|
|00005df0| 6e 64 65 78 20 4d 6f 64 | 69 66 79 0a 0a 53 6f 6d |ndex Mod|ify..Som|
|00005e00| 65 74 69 6d 65 73 20 79 | 6f 75 20 6d 61 79 20 77 |etimes y|ou may w|
|00005e10| 69 73 68 20 74 6f 20 71 | 75 65 72 79 20 61 6e 20 |ish to q|uery an |
|00005e20| 6f 62 6a 65 63 74 27 73 | 20 61 74 74 72 69 62 75 |object's| attribu|
|00005e30| 74 65 20 64 69 72 65 63 | 74 6c 79 0a 77 69 74 68 |te direc|tly.with|
|00005e40| 6f 75 74 20 77 61 69 74 | 69 6e 67 20 69 6e 20 61 |out wait|ing in a|
|00005e50| 20 70 6f 6c 6c 69 6e 67 | 20 6c 6f 6f 70 20 61 6e | polling| loop an|
|00005e60| 64 20 74 68 65 6e 20 70 | 75 74 74 69 6e 67 20 69 |d then p|utting i|
|00005e70| 74 20 64 6f 77 6e 20 73 | 6f 6d 65 77 68 65 72 65 |t down s|omewhere|
|00005e80| 0a 65 6c 73 65 2e 20 54 | 68 69 73 20 69 73 20 65 |.else. T|his is e|
|00005e90| 73 70 65 63 69 61 6c 6c | 79 20 75 73 65 66 75 6c |speciall|y useful|
|00005ea0| 20 66 6f 72 20 73 74 72 | 69 6e 67 20 67 61 64 67 | for str|ing gadg|
|00005eb0| 65 74 73 2e 20 59 6f 75 | 20 73 68 6f 75 6c 64 0a |ets. You| should.|
|00005ec0| 40 65 6d 70 68 7b 6e 6f | 74 7d 20 72 65 61 64 20 |@emph{no|t} read |
|00005ed0| 74 68 65 69 72 20 63 6f | 6e 74 65 6e 74 73 20 77 |their co|ntents w|
|00005ee0| 68 65 6e 20 79 6f 75 20 | 72 65 63 65 69 76 65 20 |hen you |receive |
|00005ef0| 61 20 40 63 6f 64 65 7b | 54 52 4d 53 5f 4e 45 57 |a @code{|TRMS_NEW|
|00005f00| 56 41 4c 55 45 7d 0a 6d | 65 73 73 61 67 65 2c 20 |VALUE}.m|essage, |
|00005f10| 62 65 63 61 75 73 65 20 | 69 74 20 69 73 20 70 6f |because |it is po|
|00005f20| 73 73 69 62 6c 65 20 74 | 6f 20 65 78 69 74 20 61 |ssible t|o exit a|
|00005f30| 20 73 74 72 69 6e 67 20 | 67 61 64 67 65 74 20 77 | string |gadget w|
|00005f40| 69 74 68 6f 75 74 0a 74 | 72 69 67 67 65 72 69 6e |ithout.t|riggerin|
|00005f50| 67 20 73 75 63 68 20 61 | 20 6d 65 73 73 61 67 65 |g such a| message|
|00005f60| 2e 20 49 6e 73 74 65 61 | 64 20 79 6f 75 20 68 61 |. Instea|d you ha|
|00005f70| 76 65 20 74 6f 20 72 65 | 61 64 20 74 68 65 20 63 |ve to re|ad the c|
|00005f80| 6f 6e 74 65 6e 74 73 0a | 64 69 72 65 63 74 6c 79 |ontents.|directly|
|00005f90| 20 62 65 66 6f 72 65 20 | 79 6f 75 20 6e 65 65 64 | before |you need|
|00005fa0| 20 74 68 65 6d 2e 0a 0a | 41 74 74 72 69 62 75 74 | them...|Attribut|
|00005fb0| 65 73 20 63 61 6e 20 62 | 65 20 72 65 61 64 20 77 |es can b|e read w|
|00005fc0| 69 74 68 20 74 68 65 20 | 40 63 6f 64 65 7b 54 52 |ith the |@code{TR|
|00005fd0| 5f 47 65 74 41 74 74 72 | 69 62 75 74 65 28 29 7d |_GetAttr|ibute()}|
|00005fe0| 20 66 75 6e 63 74 69 6f | 6e 2c 0a 77 68 69 63 68 | functio|n,.which|
|00005ff0| 20 77 69 6c 6c 20 72 65 | 74 75 72 6e 20 74 68 65 | will re|turn the|
|00006000| 20 76 61 6c 75 65 20 6f | 66 20 61 6e 20 6f 62 6a | value o|f an obj|
|00006010| 65 63 74 27 73 20 6f 72 | 20 70 72 6f 6a 65 63 74 |ect's or| project|
|00006020| 27 73 20 61 74 74 72 69 | 62 75 74 65 2e 0a 53 70 |'s attri|bute..Sp|
|00006030| 65 63 69 66 79 20 74 68 | 65 20 6f 62 6a 65 63 74 |ecify th|e object|
|00006040| 27 73 20 49 44 20 6f 72 | 20 30 20 66 6f 72 20 61 |'s ID or| 0 for a|
|00006050| 20 70 72 6f 6a 65 63 74 | 20 61 74 74 72 69 62 75 | project| attribu|
|00006060| 74 65 2e 20 59 6f 75 20 | 63 61 6e 20 67 65 74 0a |te. You |can get.|
|00006070| 74 68 65 20 64 65 66 61 | 75 6c 74 20 61 74 74 72 |the defa|ult attr|
|00006080| 69 62 75 74 65 20 6f 66 | 20 61 6e 20 6f 62 6a 65 |ibute of| an obje|
|00006090| 63 74 20 62 79 20 73 65 | 74 74 69 6e 67 20 40 63 |ct by se|tting @c|
|000060a0| 6f 64 65 7b 41 74 74 72 | 69 62 75 74 65 7d 20 74 |ode{Attr|ibute} t|
|000060b0| 6f 0a 30 2e 20 4f 74 68 | 65 72 77 69 73 65 20 73 |o.0. Oth|erwise s|
|000060c0| 65 74 20 69 74 20 74 6f | 20 61 6e 20 61 74 74 72 |et it to| an attr|
|000060d0| 69 62 75 74 65 20 74 61 | 67 2e 0a 0a 53 65 74 74 |ibute ta|g...Sett|
|000060e0| 69 6e 67 20 61 20 6e 65 | 77 20 61 74 74 72 69 62 |ing a ne|w attrib|
|000060f0| 75 74 65 20 77 6f 72 6b | 73 20 6a 75 73 74 20 74 |ute work|s just t|
|00006100| 68 65 20 73 61 6d 65 20 | 77 61 79 20 77 69 74 68 |he same |way with|
|00006110| 20 74 68 65 20 66 75 6e | 63 74 69 6f 6e 0a 40 63 | the fun|ction.@c|
|00006120| 6f 64 65 7b 54 52 5f 53 | 65 74 41 74 74 72 69 62 |ode{TR_S|etAttrib|
|00006130| 75 74 65 28 29 7d 2e 20 | 41 67 61 69 6e 20 79 6f |ute()}. |Again yo|
|00006140| 75 20 6d 61 79 20 61 6c | 73 6f 20 6d 6f 64 69 66 |u may al|so modif|
|00006150| 79 20 70 72 6f 6a 65 63 | 74 20 61 74 74 72 69 62 |y projec|t attrib|
|00006160| 75 74 65 73 2e 0a 53 65 | 65 20 74 68 65 20 61 75 |utes..Se|e the au|
|00006170| 74 6f 64 6f 63 20 63 6c | 69 70 20 66 6f 72 20 61 |todoc cl|ip for a|
|00006180| 20 6c 69 73 74 20 6f 66 | 20 74 68 65 6d 2e 20 41 | list of| them. A|
|00006190| 66 74 65 72 20 73 65 74 | 74 69 6e 67 20 61 20 6e |fter set|ting a n|
|000061a0| 65 77 20 61 74 74 72 69 | 62 75 74 65 0a 74 68 65 |ew attri|bute.the|
|000061b0| 20 6f 6e 2d 73 63 72 65 | 65 6e 20 72 65 70 72 65 | on-scre|en repre|
|000061c0| 73 65 6e 74 61 74 69 6f | 6e 20 6f 66 20 69 74 20 |sentatio|n of it |
|000061d0| 77 69 6c 6c 20 62 65 20 | 75 70 64 61 74 65 64 20 |will be |updated |
|000061e0| 69 66 20 6e 65 63 65 73 | 73 61 72 79 2e 0a 0a 49 |if neces|sary...I|
|000061f0| 66 20 79 6f 75 20 77 61 | 6e 74 20 74 6f 20 73 65 |f you wa|nt to se|
|00006200| 6e 64 20 63 75 73 74 6f | 6d 20 6f 62 6a 65 63 74 |nd custo|m object|
|00006210| 20 6d 65 73 73 61 67 65 | 73 20 28 40 63 6f 64 65 | message|s (@code|
|00006220| 7b 54 52 5f 53 65 74 41 | 74 74 72 69 62 75 74 65 |{TR_SetA|ttribute|
|00006230| 28 29 7d 20 61 6e 64 0a | 40 63 6f 64 65 7b 54 52 |()} and.|@code{TR|
|00006240| 5f 47 65 74 41 74 74 72 | 69 62 75 74 65 28 29 7d |_GetAttr|ibute()}|
|00006250| 20 69 6e 76 6f 6b 65 20 | 74 68 65 20 6d 65 73 73 | invoke |the mess|
|00006260| 61 67 65 73 20 40 63 6f | 64 65 7b 54 52 44 4d 5f |ages @co|de{TRDM_|
|00006270| 53 45 54 41 54 54 52 49 | 42 55 54 45 7d 20 61 6e |SETATTRI|BUTE} an|
|00006280| 64 0a 40 63 6f 64 65 7b | 54 52 44 4d 5f 47 45 54 |d.@code{|TRDM_GET|
|00006290| 41 54 54 52 49 42 55 54 | 45 7d 29 2c 20 79 6f 75 |ATTRIBUT|E}), you|
|000062a0| 20 68 61 76 65 20 74 6f | 20 75 73 65 20 40 63 6f | have to| use @co|
|000062b0| 64 65 7b 54 52 5f 53 65 | 6e 64 4d 65 73 73 61 67 |de{TR_Se|ndMessag|
|000062c0| 65 28 29 7d 2e 20 54 68 | 65 20 61 75 74 6f 64 6f |e()}. Th|e autodo|
|000062d0| 63 73 0a 77 69 6c 6c 20 | 74 65 6c 6c 20 79 6f 75 |cs.will |tell you|
|000062e0| 20 77 68 69 63 68 20 63 | 6c 61 73 73 65 73 20 61 | which c|lasses a|
|000062f0| 63 63 65 70 74 20 77 68 | 69 63 68 20 6d 65 73 73 |ccept wh|ich mess|
|00006300| 61 67 65 73 2e 0a 0a 40 | 65 6d 70 68 7b 4e 6f 74 |ages...@|emph{Not|
|00006310| 65 3a 7d 20 44 6f 20 6e | 6f 74 20 63 6f 6e 66 75 |e:} Do n|ot confu|
|00006320| 73 65 20 40 63 6f 64 65 | 7b 4f 62 6a 65 63 74 20 |se @code|{Object |
|00006330| 4d 65 73 73 61 67 65 73 | 7d 20 28 40 63 6f 64 65 |Messages|} (@code|
|00006340| 7b 54 52 4f 4d 5f 2e 2e | 2e 7d 29 20 77 68 69 63 |{TROM_..|.}) whic|
|00006350| 68 20 61 72 65 20 73 65 | 6e 74 0a 74 6f 20 54 72 |h are se|nt.to Tr|
|00006360| 69 74 6f 6e 20 6f 62 6a | 65 63 74 73 20 77 69 74 |iton obj|ects wit|
|00006370| 68 20 40 63 6f 64 65 7b | 54 72 69 74 6f 6e 20 6d |h @code{|Triton m|
|00006380| 65 73 73 61 67 65 73 7d | 20 28 40 63 6f 64 65 7b |essages}| (@code{|
|00006390| 54 52 4d 53 5f 2e 2e 2e | 7d 29 20 77 68 69 63 68 |TRMS_...|}) which|
|000063a0| 20 79 6f 75 20 72 65 63 | 65 69 76 65 20 69 6e 20 | you rec|eive in |
|000063b0| 79 6f 75 72 0a 70 6f 6c | 6c 69 6e 67 20 6c 6f 6f |your.pol|ling loo|
|000063c0| 70 2e 0a 0a 40 6e 6f 64 | 65 20 54 55 54 5f 48 45 |p...@nod|e TUT_HE|
|000063d0| 4c 2c 20 54 55 54 5f 52 | 45 51 2c 20 54 55 54 5f |L, TUT_R|EQ, TUT_|
|000063e0| 4d 45 53 2c 20 54 6f 70 | 0a 40 73 65 63 74 69 6f |MES, Top|.@sectio|
|000063f0| 6e 20 48 65 6c 70 0a 40 | 63 69 6e 64 65 78 20 48 |n Help.@|cindex H|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.