home *** CD-ROM | disk | FTP | other *** search
| Texinfo Document | 1997-04-13 | 40.4 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: Texinfo Document
(document/texInfo).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Texinfo Document (document/texInfo)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| TeX document, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| x-fmt/111 Plain Text File
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 69 6e 70 75 74 20 61 | 6d 69 67 61 74 65 78 69 |\input a|migatexi|
|00000010| 6e 66 6f 20 40 63 20 2d | 2a 2d 74 65 78 69 6e 66 |nfo @c -|*-texinf|
|00000020| 6f 2d 2a 2d 0a 5c 69 6e | 70 75 74 20 74 65 78 69 |o-*-.\in|put texi|
|00000030| 6e 66 6f 0a 40 63 6f 6d | 6d 65 6e 74 20 25 2a 2a |nfo.@com|ment %**|
|00000040| 73 74 61 72 74 20 6f 66 | 20 68 65 61 64 65 72 0a |start of| header.|
|00000050| 40 73 65 74 66 69 6c 65 | 6e 61 6d 65 20 54 72 69 |@setfile|name Tri|
|00000060| 74 6f 6e 44 65 76 2e 69 | 6e 66 6f 0a 40 73 65 74 |tonDev.i|nfo.@set|
|00000070| 74 69 74 6c 65 20 54 72 | 69 74 6f 6e 44 65 76 0a |title Tr|itonDev.|
|00000080| 40 69 66 74 65 78 0a 40 | 61 66 6f 75 72 70 61 70 |@iftex.@|afourpap|
|00000090| 65 72 0a 40 65 6e 64 20 | 69 66 74 65 78 0a 40 66 |er.@end |iftex.@f|
|000000a0| 69 6e 61 6c 6f 75 74 0a | 40 63 6f 6d 6d 65 6e 74 |inalout.|@comment|
|000000b0| 20 25 2a 2a 65 6e 64 20 | 6f 66 20 68 65 61 64 65 | %**end |of heade|
|000000c0| 72 0a 0a 40 63 20 40 73 | 65 74 63 68 61 70 74 65 |r..@c @s|etchapte|
|000000d0| 72 6e 65 77 70 61 67 65 | 20 6f 64 64 0a 0a 40 74 |rnewpage| odd..@t|
|000000e0| 69 74 6c 65 70 61 67 65 | 0a 40 73 70 20 35 0a 40 |itlepage|.@sp 5.@|
|000000f0| 63 65 6e 74 65 72 20 40 | 74 69 74 6c 65 66 6f 6e |center @|titlefon|
|00000100| 74 7b 54 72 69 74 6f 6e | 7d 0a 40 73 70 20 34 0a |t{Triton|}.@sp 4.|
|00000110| 40 63 65 6e 74 65 72 20 | 52 65 6c 65 61 73 65 20 |@center |Release |
|00000120| 32 2e 30 0a 40 73 70 20 | 34 0a 40 63 65 6e 74 65 |2.0.@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 37 20 62 79 20 53 74 | 1993-19|97 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 32 2e 30 0a |ter Rele|ase 2.0.|
|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 37 20 | 53 74 65 66 61 6e 20 5a |93-1997 |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 57 72 69 74 69 6e 67 |utodocs.|.Writing|
|000003d0| 20 41 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 2d 20 | Applica|tions - |
|000003e0| 53 74 65 70 20 62 79 20 | 53 74 65 70 20 54 75 74 |Step by |Step Tut|
|000003f0| 6f 72 69 61 6c 0a 0a 2a | 20 41 70 70 6c 69 63 61 |orial..*| Applica|
|00000400| 74 69 6f 6e 73 20 20 20 | 20 3a 54 55 54 5f 41 50 |tions | :TUT_AP|
|00000410| 50 2e 20 20 20 20 20 20 | 20 54 68 65 20 6b 65 79 |P. | The key|
|00000420| 20 74 6f 20 54 72 69 74 | 6f 6e 0a 2a 20 50 72 6f | to Trit|on.* Pro|
|00000430| 6a 65 63 74 73 20 20 20 | 20 20 20 20 20 3a 54 55 |jects | :TU|
|00000440| 54 5f 50 52 4f 2e 20 20 | 20 20 20 20 20 54 72 69 |T_PRO. | Tri|
|00000450| 74 6f 6e 20 47 55 49 20 | 77 69 6e 64 6f 77 73 0a |ton GUI |windows.|
|00000460| 2a 20 4d 65 6e 75 73 20 | 20 20 20 20 20 20 20 20 |* Menus | |
|00000470| 20 20 3a 54 55 54 5f 4d | 45 4e 2e 20 20 20 20 20 | :TUT_M|EN. |
|00000480| 20 20 4d 65 6e 75 73 0a | 2a 20 4f 62 6a 65 63 74 | Menus.|* Object|
|00000490| 73 20 20 20 20 20 20 20 | 20 20 3a 54 55 54 5f 4f |s | :TUT_O|
|000004a0| 42 4a 2e 20 20 20 20 20 | 20 20 54 72 69 74 6f 6e |BJ. | Triton|
|000004b0| 20 6f 62 6a 65 63 74 73 | 0a 2a 20 4c 61 79 6f 75 | objects|.* Layou|
|000004c0| 74 20 20 20 20 20 20 20 | 20 20 20 3a 54 55 54 5f |t | :TUT_|
|000004d0| 4c 41 59 2e 20 20 20 20 | 20 20 20 54 68 65 20 6c |LAY. | The l|
|000004e0| 61 79 6f 75 74 20 65 6e | 67 69 6e 65 0a 2a 20 4d |ayout en|gine.* M|
|000004f0| 61 63 72 6f 73 20 20 20 | 20 20 20 20 20 20 20 3a |acros | :|
|00000500| 54 55 54 5f 4d 41 43 2e | 20 20 20 20 20 20 20 55 |TUT_MAC.| U|
|00000510| 73 69 6e 67 20 74 68 65 | 20 54 72 69 74 6f 6e 20 |sing the| Triton |
|00000520| 47 55 49 20 6d 61 63 72 | 6f 73 0a 2a 20 50 6f 6c |GUI macr|os.* Pol|
|00000530| 6c 69 6e 67 20 4c 6f 6f | 70 20 20 20 20 3a 54 55 |ling Loo|p :TU|
|00000540| 54 5f 50 4f 4c 2e 20 20 | 20 20 20 20 20 48 61 6e |T_POL. | Han|
|00000550| 64 6c 69 6e 67 20 47 55 | 49 20 65 76 65 6e 74 73 |dling GU|I events|
|00000560| 0a 2a 20 4d 65 73 73 61 | 67 65 73 20 20 20 20 20 |.* Messa|ges |
|00000570| 20 20 20 3a 54 55 54 5f | 4d 45 53 2e 20 20 20 20 | :TUT_|MES. |
|00000580| 20 20 20 53 65 6e 64 69 | 6e 67 20 6d 65 73 73 61 | Sendi|ng messa|
|00000590| 67 65 73 0a 2a 20 48 65 | 6c 70 20 20 20 20 20 20 |ges.* He|lp |
|000005a0| 20 20 20 20 20 20 3a 54 | 55 54 5f 48 45 4c 2e 20 | :T|UT_HEL. |
|000005b0| 20 20 20 20 20 20 50 72 | 6f 76 69 64 69 6e 67 20 | Pr|oviding |
|000005c0| 68 65 6c 70 0a 2a 20 52 | 65 71 75 65 73 74 65 72 |help.* R|equester|
|000005d0| 73 20 20 20 20 20 20 3a | 54 55 54 5f 52 45 51 2e |s :|TUT_REQ.|
|000005e0| 20 20 20 20 20 20 20 54 | 72 69 74 6f 6e 20 72 65 | T|riton re|
|000005f0| 71 75 65 73 74 65 72 73 | 0a 0a 43 6c 61 73 73 20 |questers|..Class |
|00000600| 41 75 74 68 6f 72 69 6e | 67 20 54 75 74 6f 72 69 |Authorin|g Tutori|
|00000610| 61 6c 0a 0a 2a 20 43 6c | 61 73 73 20 42 61 73 69 |al..* Cl|ass Basi|
|00000620| 63 73 20 20 20 20 3a 43 | 4c 41 5f 42 41 53 2e 20 |cs :C|LA_BAS. |
|00000630| 20 20 20 20 20 20 54 68 | 65 20 62 61 73 69 63 20 | Th|e basic |
|00000640| 63 6c 61 73 73 20 6c 61 | 79 6f 75 74 0a 2a 20 4d |class la|yout.* M|
|00000650| 65 74 68 6f 64 73 20 20 | 20 20 20 20 20 20 20 3a |ethods | :|
|00000660| 43 4c 41 5f 4d 45 54 2e | 20 20 20 20 20 20 20 54 |CLA_MET.| T|
|00000670| 68 65 20 64 65 66 61 75 | 6c 74 20 6d 65 74 68 6f |he defau|lt metho|
|00000680| 64 73 0a 2a 20 46 72 61 | 6d 65 73 20 20 20 20 20 |ds.* Fra|mes |
|00000690| 20 20 20 20 20 3a 43 4c | 41 5f 46 52 41 2e 20 20 | :CL|A_FRA. |
|000006a0| 20 20 20 20 20 46 72 61 | 6d 65 20 50 72 69 6d 69 | Fra|me Primi|
|000006b0| 74 69 76 65 73 0a 2a 20 | 54 65 78 74 20 20 20 20 |tives.* |Text |
|000006c0| 20 20 20 20 20 20 20 20 | 3a 43 4c 41 5f 54 45 58 | |:CLA_TEX|
|000006d0| 2e 20 20 20 20 20 20 20 | 54 65 78 74 20 50 72 69 |. |Text Pri|
|000006e0| 6d 69 74 69 76 65 73 0a | 2a 20 49 6d 61 67 65 20 |mitives.|* Image |
|000006f0| 20 20 20 20 20 20 20 20 | 20 20 3a 43 4c 41 5f 49 | | :CLA_I|
|00000700| 4d 47 2e 20 20 20 20 20 | 20 20 49 6d 61 67 65 20 |MG. | Image |
|00000710| 50 72 69 6d 69 74 69 76 | 65 73 0a 2a 20 43 6f 6c |Primitiv|es.* Col|
|00000720| 6f 72 20 20 20 20 20 20 | 20 20 20 20 20 3a 43 4c |or | :CL|
|00000730| 41 5f 43 4f 4c 2e 20 20 | 20 20 20 20 20 43 6f 6c |A_COL. | Col|
|00000740| 6f 72 20 50 72 69 6d 69 | 74 69 76 65 73 0a 0a 53 |or Primi|tives..S|
|00000750| 74 79 6c 65 20 47 75 69 | 64 65 0a 0a 2a 20 47 75 |tyle Gui|de..* Gu|
|00000760| 69 64 65 6c 69 6e 65 73 | 20 20 20 20 20 20 3a 53 |idelines| :S|
|00000770| 54 59 5f 4f 56 45 2e 20 | 20 20 20 20 20 20 47 75 |TY_OVE. | Gu|
|00000780| 69 64 65 6c 69 6e 65 73 | 20 66 6f 72 20 54 72 69 |idelines| for Tri|
|00000790| 74 6f 6e 20 47 55 49 73 | 0a 0a 4f 64 64 73 20 26 |ton GUIs|..Odds &|
|000007a0| 20 45 6e 64 73 0a 0a 2a | 20 4d 61 69 6c 69 6e 67 | Ends..*| Mailing|
|000007b0| 20 6c 69 73 74 20 20 20 | 20 3a 4f 44 44 5f 4d 41 | list | :ODD_MA|
|000007c0| 49 2e 20 20 20 20 20 20 | 20 41 62 6f 75 74 20 74 |I. | About t|
|000007d0| 68 65 20 54 72 69 74 6f | 6e 20 6d 61 69 6c 69 6e |he Trito|n mailin|
|000007e0| 67 20 6c 69 73 74 0a 2a | 20 46 41 51 20 20 20 20 |g list.*| FAQ |
|000007f0| 20 20 20 20 20 20 20 20 | 20 3a 4f 44 44 5f 46 41 | | :ODD_FA|
|00000800| 51 2e 20 20 20 20 20 20 | 20 46 72 65 71 75 65 6e |Q. | Frequen|
|00000810| 74 6c 79 20 41 73 6b 65 | 64 20 51 75 65 73 74 69 |tly Aske|d Questi|
|00000820| 6f 6e 73 0a 0a 2a 20 49 | 6e 64 65 78 20 20 20 20 |ons..* I|ndex |
|00000830| 20 20 20 20 20 20 20 3a | 49 6e 64 65 78 2e 0a 0a | :|Index...|
|00000840| 40 65 6e 64 20 6d 65 6e | 75 0a 0a 40 65 78 61 6d |@end men|u..@exam|
|00000850| 70 6c 65 0a 40 2a 0a 40 | 65 6e 64 20 65 78 61 6d |ple.@*.@|end exam|
|00000860| 70 6c 65 0a 0a 40 69 66 | 69 6e 66 6f 0a 4e 6f 74 |ple..@if|info.Not|
|00000870| 65 20 74 68 61 74 20 61 | 6c 6c 20 70 61 67 65 73 |e that a|ll pages|
|00000880| 20 63 61 6e 20 62 65 20 | 72 65 61 63 68 65 64 20 | can be |reached |
|00000890| 64 69 72 65 63 74 6c 79 | 20 66 72 6f 6d 20 74 68 |directly| from th|
|000008a0| 69 73 20 6d 65 6e 75 2c | 0a 73 6f 20 74 68 61 74 |is menu,|.so that|
|000008b0| 20 79 6f 75 20 6d 61 79 | 20 63 6f 6e 76 65 6e 69 | you may| conveni|
|000008c0| 65 6e 74 6c 79 20 62 72 | 6f 77 73 65 20 74 68 72 |ently br|owse thr|
|000008d0| 6f 75 67 68 20 61 6c 6c | 20 69 74 65 6d 73 20 69 |ough all| items i|
|000008e0| 6e 20 74 68 69 73 0a 6d | 61 69 6e 20 6d 65 6e 75 |n this.m|ain menu|
|000008f0| 20 69 6e 20 6f 72 64 65 | 72 20 74 6f 20 72 65 61 | in orde|r to rea|
|00000900| 64 20 74 68 65 20 65 6e | 74 69 72 65 20 64 6f 63 |d the en|tire doc|
|00000910| 75 6d 65 6e 74 61 74 69 | 6f 6e 2e 0a 40 65 6e 64 |umentati|on..@end|
|00000920| 20 69 66 69 6e 66 6f 0a | 0a 40 6e 6f 64 65 20 49 | ifinfo.|.@node I|
|00000930| 4e 54 5f 4f 56 45 2c 20 | 49 4e 54 5f 4f 4f 50 2c |NT_OVE, |INT_OOP,|
|00000940| 20 54 6f 70 2c 20 54 6f | 70 0a 40 63 68 61 70 74 | Top, To|p.@chapt|
|00000950| 65 72 20 49 6e 74 72 6f | 64 75 63 74 69 6f 6e 0a |er Intro|duction.|
|00000960| 40 63 69 6e 64 65 78 20 | 49 6e 74 72 6f 64 75 63 |@cindex |Introduc|
|00000970| 74 69 6f 6e 0a 40 73 65 | 63 74 69 6f 6e 20 4f 76 |tion.@se|ction Ov|
|00000980| 65 72 76 69 65 77 0a 40 | 63 69 6e 64 65 78 20 4f |erview.@|cindex O|
|00000990| 76 65 72 76 69 65 77 0a | 0a 54 68 65 20 54 72 69 |verview.|.The Tri|
|000009a0| 74 6f 6e 20 47 55 49 20 | 63 72 65 61 74 69 6f 6e |ton GUI |creation|
|000009b0| 20 73 79 73 74 65 6d 20 | 6f 66 66 65 72 73 20 61 | system |offers a|
|000009c0| 6e 20 65 61 73 79 20 77 | 61 79 20 74 6f 20 63 72 |n easy w|ay to cr|
|000009d0| 65 61 74 65 20 67 6f 6f | 64 20 6c 6f 6f 6b 69 6e |eate goo|d lookin|
|000009e0| 67 0a 47 55 49 73 20 66 | 6f 72 20 79 6f 75 72 20 |g.GUIs f|or your |
|000009f0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 73 2e 20 49 74 |applicat|ions. It|
|00000a00| 20 63 61 6e 20 62 65 20 | 75 73 65 64 20 77 69 74 | can be |used wit|
|00000a10| 68 20 61 20 76 61 72 69 | 65 74 79 20 6f 66 0a 70 |h a vari|ety of.p|
|00000a20| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 6c 61 6e 67 75 |rogrammi|ng langu|
|00000a30| 61 67 65 73 2e 20 53 75 | 70 70 6f 72 74 20 66 6f |ages. Su|pport fo|
|00000a40| 72 20 53 41 53 2f 43 20 | 69 73 20 69 6e 63 6c 75 |r SAS/C |is inclu|
|00000a50| 64 65 64 20 64 69 72 65 | 63 74 6c 79 20 69 6e 20 |ded dire|ctly in |
|00000a60| 74 68 69 73 0a 70 61 63 | 6b 61 67 65 2e 20 43 68 |this.pac|kage. Ch|
|00000a70| 65 63 6b 20 6f 75 74 20 | 74 68 65 20 41 6d 69 4e |eck out |the AmiN|
|00000a80| 65 74 20 64 69 72 65 63 | 74 6f 72 79 20 40 66 69 |et direc|tory @fi|
|00000a90| 6c 65 7b 64 65 76 2f 67 | 75 69 7d 20 6f 72 20 74 |le{dev/g|ui} or t|
|00000aa0| 68 65 20 54 72 69 74 6f | 6e 0a 48 6f 6d 65 20 50 |he Trito|n.Home P|
|00000ab0| 61 67 65 20 61 74 20 40 | 63 6f 64 65 7b 68 74 74 |age at @|code{htt|
|00000ac0| 70 3a 2f 2f 68 6f 6d 65 | 2e 70 61 67 65 73 2e 64 |p://home|.pages.d|
|00000ad0| 65 2f 7e 73 7a 65 69 67 | 65 72 2f 74 72 69 74 6f |e/~szeig|er/trito|
|00000ae0| 6e 2e 68 74 6d 6c 7d 20 | 66 6f 72 0a 73 75 70 70 |n.html} |for.supp|
|00000af0| 6f 72 74 20 66 69 6c 65 | 73 20 66 6f 72 20 6f 74 |ort file|s for ot|
|00000b00| 68 65 72 20 6c 61 6e 67 | 75 61 67 65 73 20 61 6e |her lang|uages an|
|00000b10| 64 20 64 65 76 65 6c 6f | 70 6d 65 6e 74 20 73 79 |d develo|pment sy|
|00000b20| 73 74 65 6d 73 2e 0a 0a | 49 66 20 79 6f 75 20 68 |stems...|If you h|
|00000b30| 61 76 65 20 72 65 6c 65 | 61 73 65 64 20 61 20 54 |ave rele|ased a T|
|00000b40| 72 69 74 6f 6e 20 73 75 | 70 70 6f 72 74 20 70 61 |riton su|pport pa|
|00000b50| 63 6b 61 67 65 20 66 6f | 72 20 61 20 6e 65 77 20 |ckage fo|r a new |
|00000b60| 6c 61 6e 67 75 61 67 65 | 20 6f 72 0a 64 65 76 65 |language| or.deve|
|00000b70| 6c 6f 70 6d 65 6e 74 20 | 73 79 73 74 65 6d 2c 20 |lopment |system, |
|00000b80| 70 6c 65 61 73 65 20 63 | 6f 6e 74 61 63 74 20 6d |please c|ontact m|
|00000b90| 65 20 66 6f 72 20 69 6e | 63 6c 75 73 69 6f 6e 20 |e for in|clusion |
|00000ba0| 69 6e 74 6f 20 74 68 65 | 20 6c 69 73 74 20 6f 6e |into the| list on|
|00000bb0| 20 74 68 65 0a 54 72 69 | 74 6f 6e 20 68 6f 6d 65 | the.Tri|ton home|
|00000bc0| 20 70 61 67 65 2e 0a 0a | 54 68 69 73 20 64 6f 63 | page...|This doc|
|00000bd0| 75 6d 65 6e 74 20 64 65 | 73 63 72 69 62 65 73 20 |ument de|scribes |
|00000be0| 68 6f 77 20 74 6f 20 75 | 73 65 20 54 72 69 74 6f |how to u|se Trito|
|00000bf0| 6e 20 69 6e 20 79 6f 75 | 72 20 6f 77 6e 20 61 70 |n in you|r own ap|
|00000c00| 70 6c 69 63 61 74 69 6f | 6e 73 0a 62 79 20 70 72 |plicatio|ns.by pr|
|00000c10| 6f 76 69 64 69 6e 67 20 | 79 6f 75 20 77 69 74 68 |oviding |you with|
|00000c20| 20 73 6f 6d 65 20 6f 76 | 65 72 76 69 65 77 20 74 | some ov|erview t|
|00000c30| 6f 70 69 63 73 20 61 6e | 64 20 61 20 73 74 65 70 |opics an|d a step|
|00000c40| 20 62 79 20 73 74 65 70 | 0a 69 6e 74 72 6f 64 75 | by step|.introdu|
|00000c50| 63 74 69 6f 6e 2e 20 49 | 74 20 64 6f 65 73 20 40 |ction. I|t does @|
|00000c60| 73 74 72 6f 6e 67 7b 6e | 6f 74 7d 20 64 65 73 63 |strong{n|ot} desc|
|00000c70| 72 69 62 65 20 69 6e 20 | 64 65 74 61 69 6c 20 74 |ribe in |detail t|
|00000c80| 68 65 20 66 75 6e 63 74 | 69 6f 6e 73 2c 0a 73 74 |he funct|ions,.st|
|00000c90| 72 75 63 74 75 72 65 73 | 2c 20 74 61 67 73 2c 20 |ructures|, tags, |
|00000ca0| 65 74 63 40 2e 20 77 68 | 69 63 68 20 61 72 65 20 |etc@. wh|ich are |
|00000cb0| 75 73 65 64 2c 20 73 6f | 20 79 6f 75 20 73 68 6f |used, so| you sho|
|00000cc0| 75 6c 64 20 61 6c 77 61 | 79 73 20 6c 6f 6f 6b 0a |uld alwa|ys look.|
|00000cd0| 74 68 65 6d 20 75 70 20 | 69 6e 20 74 68 65 20 61 |them up |in the a|
|00000ce0| 75 74 6f 64 6f 63 73 20 | 66 69 6c 65 20 28 73 65 |utodocs |file (se|
|00000cf0| 65 20 40 72 65 66 7b 49 | 4e 54 5f 41 55 54 2c 20 |e @ref{I|NT_AUT, |
|00000d00| 41 75 74 6f 64 6f 63 73 | 2c 20 49 6e 74 72 6f 64 |Autodocs|, Introd|
|00000d10| 75 63 74 69 6f 6e 20 2d | 20 41 75 74 6f 64 6f 63 |uction -| Autodoc|
|00000d20| 73 7d 29 0a 61 6e 64 20 | 74 68 65 20 43 20 68 65 |s}).and |the C he|
|00000d30| 61 64 65 72 20 66 69 6c | 65 20 40 66 69 6c 65 7b |ader fil|e @file{|
|00000d40| 44 65 76 65 6c 6f 70 65 | 72 2f 49 6e 63 6c 75 64 |Develope|r/Includ|
|00000d50| 65 2f 6c 69 62 72 61 72 | 69 65 73 2f 74 72 69 74 |e/librar|ies/trit|
|00000d60| 6f 6e 2e 68 7d 2e 0a 0a | 54 68 65 20 65 78 61 6d |on.h}...|The exam|
|00000d70| 70 6c 65 73 20 69 6e 20 | 74 68 69 73 20 64 6f 63 |ples in |this doc|
|00000d80| 75 6d 65 6e 74 20 61 73 | 73 75 6d 65 20 74 68 61 |ument as|sume tha|
|00000d90| 74 20 79 6f 75 27 72 65 | 20 75 73 69 6e 67 20 74 |t you're| using t|
|00000da0| 68 65 20 43 20 73 75 70 | 70 6f 72 74 0a 66 69 6c |he C sup|port.fil|
|00000db0| 65 73 20 77 69 74 68 20 | 74 68 65 20 53 41 53 2f |es with |the SAS/|
|00000dc0| 43 20 63 6f 6d 70 69 6c | 65 72 2e 20 54 68 65 72 |C compil|er. Ther|
|00000dd0| 65 20 6d 61 79 20 62 65 | 20 64 69 66 66 65 72 65 |e may be| differe|
|00000de0| 6e 63 65 73 20 69 6e 20 | 6f 74 68 65 72 0a 6c 61 |nces in |other.la|
|00000df0| 6e 67 75 61 67 65 73 20 | 6f 72 20 65 76 65 6e 20 |nguages |or even |
|00000e00| 77 69 74 68 20 6f 74 68 | 65 72 20 43 20 64 65 76 |with oth|er C dev|
|00000e10| 65 6c 6f 70 6d 65 6e 74 | 20 73 79 73 74 65 6d 73 |elopment| systems|
|00000e20| 2e 0a 0a 40 6e 6f 64 65 | 20 49 4e 54 5f 4f 4f 50 |...@node| INT_OOP|
|00000e30| 2c 20 49 4e 54 5f 43 4c | 41 2c 20 49 4e 54 5f 4f |, INT_CL|A, INT_O|
|00000e40| 56 45 2c 20 54 6f 70 0a | 40 73 65 63 74 69 6f 6e |VE, Top.|@section|
|00000e50| 20 4f 4f 50 20 49 6e 74 | 65 72 6e 61 6c 73 0a 40 | OOP Int|ernals.@|
|00000e60| 63 69 6e 64 65 78 20 4f | 4f 50 20 49 6e 74 65 72 |cindex O|OP Inter|
|00000e70| 6e 61 6c 73 0a 0a 41 6c | 74 68 6f 75 67 68 20 54 |nals..Al|though T|
|00000e80| 72 69 74 6f 6e 20 6f 66 | 66 65 72 73 20 61 20 6d |riton of|fers a m|
|00000e90| 6f 73 74 6c 79 20 70 72 | 6f 63 65 64 75 72 61 6c |ostly pr|ocedural|
|00000ea0| 20 41 50 49 2c 20 69 74 | 20 69 73 20 62 61 73 65 | API, it| is base|
|00000eb0| 64 20 6f 6e 20 61 6e 0a | 6f 62 6a 65 63 74 2d 6f |d on an.|object-o|
|00000ec0| 72 69 65 6e 74 65 64 20 | 73 79 73 74 65 6d 2e 20 |riented |system. |
|00000ed0| 41 73 20 61 20 54 72 69 | 74 6f 6e 20 75 73 65 72 |As a Tri|ton user|
|00000ee0| 20 79 6f 75 20 77 69 6c | 6c 20 6e 65 76 65 72 20 | you wil|l never |
|00000ef0| 73 65 65 20 54 72 69 74 | 6f 6e 0a 6f 62 6a 65 63 |see Trit|on.objec|
|00000f00| 74 73 20 64 69 72 65 63 | 74 6c 79 2c 20 62 75 74 |ts direc|tly, but|
|00000f10| 20 69 6e 73 74 65 61 64 | 20 72 65 66 65 72 65 6e | instead| referen|
|00000f20| 63 65 20 74 68 65 6d 20 | 74 68 72 6f 75 67 68 20 |ce them |through |
|00000f30| 49 44 20 6e 75 6d 62 65 | 72 73 2e 0a 0a 40 6e 6f |ID numbe|rs...@no|
|00000f40| 64 65 20 49 4e 54 5f 43 | 4c 41 2c 20 49 4e 54 5f |de INT_C|LA, INT_|
|00000f50| 41 55 54 2c 20 49 4e 54 | 5f 4f 4f 50 2c 20 54 6f |AUT, INT|_OOP, To|
|00000f60| 70 0a 40 73 65 63 74 69 | 6f 6e 20 43 6c 61 73 73 |p.@secti|on Class|
|00000f70| 20 54 72 65 65 0a 40 63 | 69 6e 64 65 78 20 43 6c | Tree.@c|index Cl|
|00000f80| 61 73 73 20 54 72 65 65 | 0a 0a 54 68 65 20 66 6f |ass Tree|..The fo|
|00000f90| 6c 6c 6f 77 69 6e 67 20 | 63 6c 61 73 73 65 73 20 |llowing |classes |
|00000fa0| 61 72 65 20 61 76 61 69 | 6c 61 62 6c 65 20 69 6e |are avai|lable in|
|00000fb0| 20 54 72 69 74 6f 6e 3a | 0a 0a 40 65 78 61 6d 70 | Triton:|..@examp|
|00000fc0| 6c 65 0a 20 20 20 20 4f | 62 6a 65 63 74 20 20 20 |le. O|bject |
|00000fd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 41 | | A|
|00000fe0| 62 73 74 72 61 63 74 20 | 72 6f 6f 74 20 63 6c 61 |bstract |root cla|
|00000ff0| 73 73 0a 20 20 20 20 60 | 2d 2d 20 44 69 73 70 6c |ss. `|-- Displ|
|00001000| 61 79 4f 62 6a 65 63 74 | 20 20 20 20 20 20 20 41 |ayObject| A|
|00001010| 62 73 74 72 61 63 74 20 | 63 6c 61 73 73 20 66 6f |bstract |class fo|
|00001020| 72 20 77 69 6e 64 6f 77 | 20 63 6f 6e 74 65 6e 74 |r window| content|
|00001030| 73 0a 20 20 20 20 20 20 | 20 20 2b 2d 2d 20 42 75 |s. | +-- Bu|
|00001040| 74 74 6f 6e 20 20 20 20 | 20 20 20 20 20 20 42 4f |tton | BO|
|00001050| 4f 50 53 49 20 62 75 74 | 74 6f 6e 20 67 61 64 67 |OPSI but|ton gadg|
|00001060| 65 74 0a 20 20 20 20 20 | 20 20 20 2b 2d 2d 20 43 |et. | +-- C|
|00001070| 68 65 63 6b 42 6f 78 20 | 20 20 20 20 20 20 20 47 |heckBox | G|
|00001080| 61 64 54 6f 6f 6c 73 20 | 43 68 65 63 6b 42 6f 78 |adTools |CheckBox|
|00001090| 0a 20 20 20 20 20 20 20 | 20 2b 2d 2d 20 43 79 63 |. | +-- Cyc|
|000010a0| 6c 65 20 20 20 20 20 20 | 20 20 20 20 20 47 61 64 |le | Gad|
|000010b0| 54 6f 6f 6c 73 20 43 79 | 63 6c 65 20 61 6e 64 20 |Tools Cy|cle and |
|000010c0| 4d 58 20 67 61 64 67 65 | 74 0a 20 20 20 20 20 20 |MX gadge|t. |
|000010d0| 20 20 2b 2d 2d 20 44 72 | 6f 70 42 6f 78 20 20 20 | +-- Dr|opBox |
|000010e0| 20 20 20 20 20 20 41 70 | 70 49 63 6f 6e 20 64 72 | Ap|pIcon dr|
|000010f0| 6f 70 70 69 6e 67 20 62 | 6f 78 0a 20 20 20 20 20 |opping b|ox. |
|00001100| 20 20 20 2b 2d 2d 20 46 | 72 61 6d 65 42 6f 78 20 | +-- F|rameBox |
|00001110| 20 20 20 20 20 20 20 46 | 72 61 6d 69 6e 67 20 6f | F|raming o|
|00001120| 72 20 67 72 6f 75 70 69 | 6e 67 20 62 6f 78 0a 20 |r groupi|ng box. |
|00001130| 20 20 20 20 20 20 20 2b | 2d 2d 20 47 72 6f 75 70 | +|-- Group|
|00001140| 20 20 20 20 20 20 20 20 | 20 20 20 54 72 69 74 6f | | Trito|
|00001150| 6e 27 73 20 6c 61 79 6f | 75 74 20 65 6e 67 69 6e |n's layo|ut engin|
|00001160| 65 0a 20 20 20 20 20 20 | 20 20 2b 2d 2d 20 49 6d |e. | +-- Im|
|00001170| 61 67 65 20 20 20 20 20 | 20 20 20 20 20 20 49 6d |age | Im|
|00001180| 61 67 65 0a 20 20 20 20 | 20 20 20 20 2b 2d 2d 20 |age. | +-- |
|00001190| 4c 69 6e 65 20 20 20 20 | 20 20 20 20 20 20 20 20 |Line | |
|000011a0| 33 44 20 6c 69 6e 65 0a | 20 20 20 20 20 20 20 20 |3D line.| |
|000011b0| 2b 2d 2d 20 4c 69 73 74 | 76 69 65 77 20 20 20 20 |+-- List|view |
|000011c0| 20 20 20 20 47 61 64 54 | 6f 6f 6c 73 20 4c 69 73 | GadT|ools Lis|
|000011d0| 74 76 69 65 77 0a 20 20 | 20 20 20 20 20 20 2b 2d |tview. | +-|
|000011e0| 2d 20 50 61 6c 65 74 74 | 65 20 20 20 20 20 20 20 |- Palett|e |
|000011f0| 20 20 47 61 64 54 6f 6f | 6c 73 20 50 61 6c 65 74 | GadToo|ls Palet|
|00001200| 74 65 20 67 61 64 67 65 | 74 0a 20 20 20 20 20 20 |te gadge|t. |
|00001210| 20 20 2b 2d 2d 20 50 72 | 6f 67 72 65 73 73 20 20 | +-- Pr|ogress |
|00001220| 20 20 20 20 20 20 50 72 | 6f 67 72 65 73 73 20 69 | Pr|ogress i|
|00001230| 6e 64 69 63 61 74 6f 72 | 0a 20 20 20 20 20 20 20 |ndicator|. |
|00001240| 20 2b 2d 2d 20 53 63 72 | 6f 6c 6c 65 72 20 20 20 | +-- Scr|oller |
|00001250| 20 20 20 20 20 47 61 64 | 54 6f 6f 6c 73 20 53 63 | Gad|Tools Sc|
|00001260| 72 6f 6c 6c 65 72 0a 20 | 20 20 20 20 20 20 20 2b |roller. | +|
|00001270| 2d 2d 20 53 6c 69 64 65 | 72 20 20 20 20 20 20 20 |-- Slide|r |
|00001280| 20 20 20 47 61 64 54 6f | 6f 6c 73 20 53 6c 69 64 | GadTo|ols Slid|
|00001290| 65 72 0a 20 20 20 20 20 | 20 20 20 2b 2d 2d 20 53 |er. | +-- S|
|000012a0| 70 61 63 65 20 20 20 20 | 20 20 20 20 20 20 20 45 |pace | E|
|000012b0| 6d 70 74 79 20 73 70 61 | 63 65 0a 20 20 20 20 20 |mpty spa|ce. |
|000012c0| 20 20 20 2b 2d 2d 20 53 | 74 72 69 6e 67 20 20 20 | +-- S|tring |
|000012d0| 20 20 20 20 20 20 20 47 | 61 64 54 6f 6f 6c 73 20 | G|adTools |
|000012e0| 53 74 72 69 6e 67 20 67 | 61 64 67 65 74 0a 20 20 |String g|adget. |
|000012f0| 20 20 20 20 20 20 60 2d | 2d 20 54 65 78 74 20 20 | `-|- Text |
|00001300| 20 20 20 20 20 20 20 20 | 20 20 54 65 78 74 0a 40 | | Text.@|
|00001310| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 0a 44 65 73 |end exam|ple..Des|
|00001320| 63 72 69 70 74 69 6f 6e | 73 20 66 6f 72 20 61 6c |cription|s for al|
|00001330| 6c 20 63 6c 61 73 73 65 | 73 20 63 61 6e 20 62 65 |l classe|s can be|
|00001340| 20 66 6f 75 6e 64 20 69 | 6e 20 74 68 65 20 54 72 | found i|n the Tr|
|00001350| 69 74 6f 6e 20 61 75 74 | 6f 64 6f 63 73 0a 28 73 |iton aut|odocs.(s|
|00001360| 65 65 20 40 72 65 66 7b | 49 4e 54 5f 41 55 54 2c |ee @ref{|INT_AUT,|
|00001370| 20 41 75 74 6f 64 6f 63 | 73 2c 20 49 6e 74 72 6f | Autodoc|s, Intro|
|00001380| 64 75 63 74 69 6f 6e 20 | 2d 20 41 75 74 6f 64 6f |duction |- Autodo|
|00001390| 63 73 7d 29 0a 75 6e 64 | 65 72 20 40 63 6f 64 65 |cs}).und|er @code|
|000013a0| 7b 74 72 69 74 6f 6e 2e | 6c 69 62 72 61 72 79 2f |{triton.|library/|
|000013b0| 63 6c 61 73 73 5f 3c 63 | 6c 61 73 73 6e 61 6d 65 |class_<c|lassname|
|000013c0| 3e 7d 2e 0a 0a 40 6e 6f | 64 65 20 49 4e 54 5f 41 |>}...@no|de INT_A|
|000013d0| 55 54 2c 20 54 55 54 5f | 41 50 50 2c 20 49 4e 54 |UT, TUT_|APP, INT|
|000013e0| 5f 43 4c 41 2c 20 54 6f | 70 0a 40 73 65 63 74 69 |_CLA, To|p.@secti|
|000013f0| 6f 6e 20 41 75 74 6f 64 | 6f 63 73 0a 40 63 69 6e |on Autod|ocs.@cin|
|00001400| 64 65 78 20 41 75 74 6f | 64 6f 63 73 0a 0a 44 6f |dex Auto|docs..Do|
|00001410| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 6f 6e 20 61 |cumentat|ion on a|
|00001420| 6c 6c 20 54 72 69 74 6f | 6e 20 63 6c 61 73 73 65 |ll Trito|n classe|
|00001430| 73 20 61 6e 64 20 40 66 | 69 6c 65 7b 74 72 69 74 |s and @f|ile{trit|
|00001440| 6f 6e 2e 6c 69 62 72 61 | 72 79 7d 20 66 75 6e 63 |on.libra|ry} func|
|00001450| 74 69 6f 6e 73 20 63 61 | 6e 20 62 65 0a 66 6f 75 |tions ca|n be.fou|
|00001460| 6e 64 20 69 6e 20 74 68 | 65 20 54 72 69 74 6f 6e |nd in th|e Triton|
|00001470| 20 61 75 74 6f 64 6f 63 | 73 20 66 69 6c 65 20 40 | autodoc|s file @|
|00001480| 66 69 6c 65 7b 44 65 76 | 65 6c 6f 70 65 72 2f 41 |file{Dev|eloper/A|
|00001490| 75 74 6f 64 6f 63 73 2f | 74 72 69 74 6f 6e 2e 64 |utodocs/|triton.d|
|000014a0| 6f 63 7d 2e 20 54 68 65 | 0a 66 75 6e 63 74 69 6f |oc}. The|.functio|
|000014b0| 6e 20 64 65 73 63 72 69 | 70 74 69 6f 6e 73 20 66 |n descri|ptions f|
|000014c0| 6f 6c 6c 6f 77 20 74 68 | 65 20 75 73 75 61 6c 20 |ollow th|e usual |
|000014d0| 73 79 6e 74 61 78 20 61 | 73 20 75 73 65 64 20 69 |syntax a|s used i|
|000014e0| 6e 20 74 68 65 20 41 6d | 69 67 61 4f 53 20 61 75 |n the Am|igaOS au|
|000014f0| 74 6f 64 6f 63 73 2e 0a | 54 68 65 20 54 72 69 74 |todocs..|The Trit|
|00001500| 6f 6e 20 63 6c 61 73 73 | 65 73 20 61 72 65 20 6c |on class|es are l|
|00001510| 69 73 74 65 64 20 77 69 | 74 68 20 74 68 65 20 70 |isted wi|th the p|
|00001520| 72 65 66 69 78 20 40 63 | 6f 64 65 7b 74 72 69 74 |refix @c|ode{trit|
|00001530| 6f 6e 2e 6c 69 62 72 61 | 72 79 2f 63 6c 61 73 73 |on.libra|ry/class|
|00001540| 5f 7d 20 61 6e 64 0a 61 | 72 65 20 64 65 73 63 72 |_} and.a|re descr|
|00001550| 69 62 65 64 20 75 73 69 | 6e 67 20 74 68 65 20 66 |ibed usi|ng the f|
|00001560| 6f 6c 6c 6f 77 69 6e 67 | 20 6b 65 79 77 6f 72 64 |ollowing| keyword|
|00001570| 73 3a 0a 0a 40 69 74 65 | 6d 69 7a 65 20 40 62 75 |s:..@ite|mize @bu|
|00001580| 6c 6c 65 74 0a 40 69 74 | 65 6d 20 40 63 6f 64 65 |llet.@it|em @code|
|00001590| 7b 4e 41 4d 45 7d 0a 0a | 54 68 65 20 6e 61 6d 65 |{NAME}..|The name|
|000015a0| 20 6f 66 20 74 68 65 20 | 63 6c 61 73 73 20 61 6e | of the |class an|
|000015b0| 64 20 61 20 73 68 6f 72 | 74 20 64 65 73 63 72 69 |d a shor|t descri|
|000015c0| 70 74 69 6f 6e 2e 0a 40 | 69 74 65 6d 20 40 63 6f |ption..@|item @co|
|000015d0| 64 65 7b 53 55 50 45 52 | 43 4c 41 53 53 7d 0a 0a |de{SUPER|CLASS}..|
|000015e0| 54 68 65 20 73 75 70 65 | 72 63 6c 61 73 73 2e 20 |The supe|rclass. |
|000015f0| 49 66 20 74 68 65 20 63 | 6f 6d 6d 65 6e 74 20 40 |If the c|omment @|
|00001600| 63 6f 64 65 7b 28 6e 6f | 20 61 74 74 72 69 62 75 |code{(no| attribu|
|00001610| 74 65 73 20 69 6e 68 65 | 72 69 74 65 64 29 7d 20 |tes inhe|rited)} |
|00001620| 69 73 20 61 64 64 65 64 | 2c 0a 61 6c 6c 20 61 74 |is added|,.all at|
|00001630| 74 72 69 62 75 74 65 73 | 20 28 73 65 65 20 62 65 |tributes| (see be|
|00001640| 6c 6f 77 29 20 61 72 65 | 20 64 65 73 63 72 69 62 |low) are| describ|
|00001650| 65 64 20 69 6e 20 74 68 | 69 73 20 61 75 74 6f 64 |ed in th|is autod|
|00001660| 6f 63 20 63 6c 69 70 2e | 20 4f 74 68 65 72 77 69 |oc clip.| Otherwi|
|00001670| 73 65 0a 61 6c 6c 20 61 | 74 74 72 69 62 75 74 65 |se.all a|ttribute|
|00001680| 73 20 6f 66 20 74 68 65 | 20 73 75 70 65 72 63 6c |s of the| supercl|
|00001690| 61 73 73 20 61 72 65 20 | 69 6e 68 65 72 69 74 65 |ass are |inherite|
|000016a0| 64 2e 0a 40 69 74 65 6d | 20 40 63 6f 64 65 7b 53 |d..@item| @code{S|
|000016b0| 59 4e 4f 50 53 49 53 7d | 0a 0a 54 68 65 20 74 61 |YNOPSIS}|..The ta|
|000016c0| 67 73 20 77 68 69 63 68 | 20 69 6e 76 6f 6b 65 20 |gs which| invoke |
|000016d0| 74 68 65 20 63 72 65 61 | 74 69 6f 6e 20 6f 66 20 |the crea|tion of |
|000016e0| 61 6e 20 69 6e 73 74 61 | 6e 63 65 20 6f 66 20 74 |an insta|nce of t|
|000016f0| 68 65 20 63 6c 61 73 73 | 2e 20 49 66 20 74 68 65 |he class|. If the|
|00001700| 20 74 61 67 73 0a 61 72 | 65 20 65 6e 63 6c 6f 73 | tags.ar|e enclos|
|00001710| 65 64 20 69 6e 20 70 61 | 72 61 6e 74 68 65 73 65 |ed in pa|ranthese|
|00001720| 73 20 74 68 65 20 63 6c | 61 73 73 20 69 73 20 61 |s the cl|ass is a|
|00001730| 62 73 74 72 61 63 74 20 | 61 6e 64 20 6e 6f 20 69 |bstract |and no i|
|00001740| 6e 73 74 61 6e 63 65 73 | 20 63 61 6e 20 62 65 0a |nstances| can be.|
|00001750| 63 72 65 61 74 65 64 2e | 0a 40 69 74 65 6d 20 40 |created.|.@item @|
|00001760| 63 6f 64 65 7b 41 54 54 | 52 49 42 55 54 45 53 7d |code{ATT|RIBUTES}|
|00001770| 0a 0a 54 68 65 20 61 74 | 74 72 69 62 75 74 65 73 |..The at|tributes|
|00001780| 20 77 68 69 63 68 20 61 | 72 65 20 63 72 65 61 74 | which a|re creat|
|00001790| 65 64 20 66 6f 72 20 65 | 76 65 72 79 20 69 6e 73 |ed for e|very ins|
|000017a0| 74 61 6e 63 65 20 6f 66 | 20 74 68 65 20 63 6c 61 |tance of| the cla|
|000017b0| 73 73 2e 20 41 6c 6c 0a | 61 74 74 72 69 62 75 74 |ss. All.|attribut|
|000017c0| 65 73 20 61 72 65 20 6c | 69 73 74 65 64 20 77 69 |es are l|isted wi|
|000017d0| 74 68 20 74 68 65 69 72 | 20 74 61 67 20 6e 61 6d |th their| tag nam|
|000017e0| 65 73 2c 20 65 78 63 65 | 70 74 20 66 6f 72 20 74 |es, exce|pt for t|
|000017f0| 68 65 20 64 65 66 61 75 | 6c 74 0a 61 74 74 72 69 |he defau|lt.attri|
|00001800| 62 75 74 65 20 77 68 69 | 63 68 20 69 73 20 6c 69 |bute whi|ch is li|
|00001810| 73 74 65 64 20 61 73 20 | 40 63 6f 64 65 7b 3c 44 |sted as |@code{<D|
|00001820| 65 66 61 75 6c 74 3e 7d | 2e 20 53 65 65 20 61 62 |efault>}|. See ab|
|00001830| 6f 76 65 20 66 6f 72 20 | 73 75 70 65 72 63 6c 61 |ove for |supercla|
|00001840| 73 73 0a 61 74 74 72 69 | 62 75 74 65 73 2e 20 41 |ss.attri|butes. A|
|00001850| 20 63 6f 6d 6d 65 6e 74 | 20 69 6e 20 73 71 75 61 | comment| in squa|
|00001860| 72 65 20 62 72 61 63 6b | 65 74 73 20 64 65 6e 6f |re brack|ets deno|
|00001870| 74 65 73 20 69 66 20 61 | 6e 20 61 74 74 72 69 62 |tes if a|n attrib|
|00001880| 75 74 65 20 63 61 6e 20 | 62 65 0a 73 70 65 63 69 |ute can |be.speci|
|00001890| 66 69 65 64 20 69 6e 20 | 61 20 63 72 65 61 74 69 |fied in |a creati|
|000018a0| 6f 6e 20 74 61 67 6c 69 | 73 74 2c 20 6d 6f 64 69 |on tagli|st, modi|
|000018b0| 66 69 65 64 20 6c 61 74 | 65 72 20 77 69 74 68 0a |fied lat|er with.|
|000018c0| 40 63 6f 64 65 7b 54 52 | 4f 4d 5f 53 45 54 41 54 |@code{TR|OM_SETAT|
|000018d0| 54 52 49 42 55 54 45 7d | 20 6f 72 20 40 63 6f 64 |TRIBUTE}| or @cod|
|000018e0| 65 7b 54 52 5f 53 65 74 | 41 74 74 72 69 62 75 74 |e{TR_Set|Attribut|
|000018f0| 65 28 29 7d 20 6f 72 20 | 71 75 65 72 69 65 64 20 |e()} or |queried |
|00001900| 77 69 74 68 0a 40 63 6f | 64 65 7b 54 52 4f 4d 5f |with.@co|de{TROM_|
|00001910| 47 45 54 41 54 54 52 49 | 42 55 54 45 7d 20 6f 72 |GETATTRI|BUTE} or|
|00001920| 20 40 63 6f 64 65 7b 54 | 52 5f 47 65 74 41 74 74 | @code{T|R_GetAtt|
|00001930| 72 69 62 75 74 65 28 29 | 7d 2e 0a 40 69 74 65 6d |ribute()|}..@item|
|00001940| 20 40 63 6f 64 65 7b 41 | 50 50 4c 49 43 41 54 49 | @code{A|PPLICATI|
|00001950| 4f 4e 20 4d 45 53 53 41 | 47 45 53 7d 0a 0a 54 68 |ON MESSA|GES}..Th|
|00001960| 69 73 20 73 65 63 74 69 | 6f 6e 20 64 65 73 63 72 |is secti|on descr|
|00001970| 69 62 65 73 20 61 6c 6c | 20 61 70 70 6c 69 63 61 |ibes all| applica|
|00001980| 74 69 6f 6e 20 6d 65 73 | 73 61 67 65 73 20 28 40 |tion mes|sages (@|
|00001990| 63 6f 64 65 7b 54 52 4d | 53 5f 2e 2e 2e 7d 29 20 |code{TRM|S_...}) |
|000019a0| 77 68 69 63 68 0a 6f 62 | 6a 65 63 74 73 20 6f 66 |which.ob|jects of|
|000019b0| 20 74 68 69 73 20 63 6c | 61 73 73 20 61 72 65 20 | this cl|ass are |
|000019c0| 63 75 72 72 65 6e 74 6c | 79 20 61 62 6c 65 20 74 |currentl|y able t|
|000019d0| 6f 20 73 65 6e 64 2e 20 | 49 66 20 6e 6f 20 6d 65 |o send. |If no me|
|000019e0| 73 73 61 67 65 73 20 61 | 72 65 0a 64 65 73 63 72 |ssages a|re.descr|
|000019f0| 69 62 65 64 2c 20 74 68 | 69 73 20 64 6f 65 73 6e |ibed, th|is doesn|
|00001a00| 27 74 20 6d 65 61 6e 20 | 74 68 61 74 20 6e 6f 6e |'t mean |that non|
|00001a10| 65 20 61 72 65 20 73 65 | 6e 74 2e 20 4e 6f 74 20 |e are se|nt. Not |
|00001a20| 61 6c 6c 20 63 6c 61 73 | 73 0a 64 65 73 63 72 69 |all clas|s.descri|
|00001a30| 70 74 69 6f 6e 73 20 68 | 61 76 65 20 74 68 69 73 |ptions h|ave this|
|00001a40| 20 73 65 63 74 69 6f 6e | 20 79 65 74 2e 0a 40 69 | section| yet..@i|
|00001a50| 74 65 6d 20 40 63 6f 64 | 65 7b 4f 42 4a 45 43 54 |tem @cod|e{OBJECT|
|00001a60| 20 4d 45 53 53 41 47 45 | 53 7d 0a 0a 54 68 69 73 | MESSAGE|S}..This|
|00001a70| 20 73 65 63 74 69 6f 6e | 20 64 65 73 63 72 69 62 | section| describ|
|00001a80| 65 73 20 61 6c 6c 20 6d | 65 73 73 61 67 65 73 20 |es all m|essages |
|00001a90| 77 68 69 63 68 20 63 61 | 6e 20 62 65 20 73 65 6e |which ca|n be sen|
|00001aa0| 74 20 74 6f 20 69 6e 73 | 74 61 6e 63 65 73 20 6f |t to ins|tances o|
|00001ab0| 66 0a 74 68 69 73 20 63 | 6c 61 73 73 2e 20 44 65 |f.this c|lass. De|
|00001ac0| 66 65 72 72 65 64 20 6d | 65 73 73 61 67 65 73 20 |ferred m|essages |
|00001ad0| 61 72 65 20 6c 69 73 74 | 65 64 20 69 6e 20 70 61 |are list|ed in pa|
|00001ae0| 72 61 6e 74 68 65 73 65 | 73 2e 20 49 6e 68 65 72 |ranthese|s. Inher|
|00001af0| 69 74 65 64 0a 6d 65 73 | 73 61 67 65 73 20 61 72 |ited.mes|sages ar|
|00001b00| 65 20 6e 6f 74 20 6c 69 | 73 74 65 64 2e 0a 40 65 |e not li|sted..@e|
|00001b10| 6e 64 20 69 74 65 6d 69 | 7a 65 0a 0a 40 6e 6f 64 |nd itemi|ze..@nod|
|00001b20| 65 20 54 55 54 5f 41 50 | 50 2c 20 54 55 54 5f 50 |e TUT_AP|P, TUT_P|
|00001b30| 52 4f 2c 20 49 4e 54 5f | 41 55 54 2c 20 54 6f 70 |RO, INT_|AUT, Top|
|00001b40| 0a 40 63 68 61 70 74 65 | 72 20 57 72 69 74 69 6e |.@chapte|r Writin|
|00001b50| 67 20 41 70 70 6c 69 63 | 61 74 69 6f 6e 73 0a 40 |g Applic|ations.@|
|00001b60| 63 69 6e 64 65 78 20 54 | 75 74 6f 72 69 61 6c 0a |cindex T|utorial.|
|00001b70| 40 73 65 63 74 69 6f 6e | 20 41 70 70 6c 69 63 61 |@section| Applica|
|00001b80| 74 69 6f 6e 73 0a 40 63 | 69 6e 64 65 78 20 41 70 |tions.@c|index Ap|
|00001b90| 70 6c 69 63 61 74 69 6f | 6e 73 0a 0a 49 6e 20 6f |plicatio|ns..In o|
|00001ba0| 72 64 65 72 20 74 6f 20 | 75 73 65 20 40 66 69 6c |rder to |use @fil|
|00001bb0| 65 7b 74 72 69 74 6f 6e | 2e 6c 69 62 72 61 72 79 |e{triton|.library|
|00001bc0| 7d 20 79 6f 75 20 6d 75 | 73 74 20 66 69 72 73 74 |} you mu|st first|
|00001bd0| 20 6f 66 20 61 6c 6c 20 | 6f 70 65 6e 20 69 74 2c | of all |open it,|
|00001be0| 20 6c 69 6b 65 20 61 6e | 79 20 6f 74 68 65 72 0a | like an|y other.|
|00001bf0| 73 68 61 72 65 64 20 6c | 69 62 72 61 72 79 2c 20 |shared l|ibrary, |
|00001c00| 61 73 20 64 65 73 63 72 | 69 62 65 64 20 69 6e 20 |as descr|ibed in |
|00001c10| 74 68 65 20 40 63 6f 64 | 65 7b 41 6d 69 67 61 20 |the @cod|e{Amiga |
|00001c20| 52 4f 4d 20 4b 65 72 6e | 65 6c 20 52 65 66 65 72 |ROM Kern|el Refer|
|00001c30| 65 6e 63 65 20 4d 61 6e | 75 61 6c 7d 2c 0a 76 6f |ence Man|ual},.vo|
|00001c40| 6c 75 6d 65 20 40 63 6f | 64 65 7b 4c 69 62 72 61 |lume @co|de{Libra|
|00001c50| 72 69 65 73 7d 2e 20 42 | 65 66 6f 72 65 20 71 75 |ries}. B|efore qu|
|00001c60| 69 74 74 69 6e 67 2c 20 | 79 6f 75 20 68 61 76 65 |itting, |you have|
|00001c70| 20 74 6f 20 63 6c 6f 73 | 65 20 69 74 0a 61 67 61 | to clos|e it.aga|
|00001c80| 69 6e 2e 20 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |in. The |followin|
|00001c90| 67 20 63 6f 64 65 20 6d | 61 6b 65 73 20 73 75 72 |g code m|akes sur|
|00001ca0| 65 20 74 68 61 74 20 79 | 6f 75 20 63 61 6e 20 75 |e that y|ou can u|
|00001cb0| 73 65 20 66 75 6e 63 74 | 69 6f 6e 73 20 66 72 6f |se funct|ions fro|
|00001cc0| 6d 0a 40 66 69 6c 65 7b | 74 72 69 74 6f 6e 2e 6c |m.@file{|triton.l|
|00001cd0| 69 62 72 61 72 79 7d 20 | 72 65 6c 65 61 73 65 20 |ibrary} |release |
|00001ce0| 31 2e 32 20 6f 72 20 68 | 69 67 68 65 72 3a 0a 0a |1.2 or h|igher:..|
|00001cf0| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 23 69 6e |@example|. #in|
|00001d00| 63 6c 75 64 65 20 3c 6c | 69 62 72 61 72 69 65 73 |clude <l|ibraries|
|00001d10| 2f 74 72 69 74 6f 6e 2e | 68 3e 0a 20 20 20 20 23 |/triton.|h>. #|
|00001d20| 69 6e 63 6c 75 64 65 20 | 3c 63 6c 69 62 2f 74 72 |include |<clib/tr|
|00001d30| 69 74 6f 6e 5f 70 72 6f | 74 6f 73 2e 68 3e 0a 20 |iton_pro|tos.h>. |
|00001d40| 20 20 20 23 69 6e 63 6c | 75 64 65 20 3c 70 72 61 | #incl|ude <pra|
|00001d50| 67 6d 61 73 2f 74 72 69 | 74 6f 6e 5f 70 72 61 67 |gmas/tri|ton_prag|
|00001d60| 6d 61 73 2e 68 3e 0a 0a | 20 20 20 20 73 74 72 75 |mas.h>..| stru|
|00001d70| 63 74 20 4c 69 62 72 61 | 72 79 20 2a 54 72 69 74 |ct Libra|ry *Trit|
|00001d80| 6f 6e 42 61 73 65 3b 0a | 0a 20 20 20 20 69 6e 74 |onBase;.|. int|
|00001d90| 20 6d 61 69 6e 28 76 6f | 69 64 29 0a 20 20 20 20 | main(vo|id). |
|00001da0| 40 7b 0a 20 20 20 20 20 | 20 69 66 28 54 72 69 74 |@{. | if(Trit|
|00001db0| 6f 6e 42 61 73 65 3d 4f | 70 65 6e 4c 69 62 72 61 |onBase=O|penLibra|
|00001dc0| 72 79 28 54 52 49 54 4f | 4e 4e 41 4d 45 2c 54 52 |ry(TRITO|NNAME,TR|
|00001dd0| 49 54 4f 4e 31 32 56 45 | 52 53 49 4f 4e 29 29 0a |ITON12VE|RSION)).|
|00001de0| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|00001df0| 20 2f 2a 20 55 73 65 20 | 66 75 6e 63 74 69 6f 6e | /* Use |function|
|00001e00| 73 20 66 72 6f 6d 20 74 | 72 69 74 6f 6e 2e 6c 69 |s from t|riton.li|
|00001e10| 62 72 61 72 79 2e 2e 2e | 20 2a 2f 0a 20 20 20 20 |brary...| */. |
|00001e20| 20 20 20 20 43 6c 6f 73 | 65 4c 69 62 72 61 72 79 | Clos|eLibrary|
|00001e30| 28 54 72 69 74 6f 6e 42 | 61 73 65 29 3b 0a 20 20 |(TritonB|ase);. |
|00001e40| 20 20 20 20 40 7d 0a 20 | 20 20 20 20 20 65 6c 73 | @}. | els|
|00001e50| 65 0a 20 20 20 20 20 20 | 40 7b 0a 20 20 20 20 20 |e. |@{. |
|00001e60| 20 20 20 2f 2a 20 52 65 | 61 63 74 20 6f 6e 20 74 | /* Re|act on t|
|00001e70| 68 65 20 65 72 72 6f 72 | 2e 2e 2e 20 2a 2f 0a 20 |he error|... */. |
|00001e80| 20 20 20 20 20 40 7d 0a | 20 20 20 20 20 20 72 65 | @}.| re|
|00001e90| 74 75 72 6e 20 30 3b 0a | 20 20 20 20 40 7d 0a 40 |turn 0;.| @}.@|
|00001ea0| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 0a 41 6c 6c |end exam|ple..All|
|00001eb0| 20 54 72 69 74 6f 6e 20 | 70 72 6f 67 72 61 6d 73 | Triton |programs|
|00001ec0| 20 61 72 65 20 62 61 73 | 65 64 20 6f 6e 20 61 20 | are bas|ed on a |
|00001ed0| 54 72 69 74 6f 6e 20 61 | 70 70 6c 69 63 61 74 69 |Triton a|pplicati|
|00001ee0| 6f 6e 20 73 74 72 75 63 | 74 75 72 65 20 28 73 74 |on struc|ture (st|
|00001ef0| 72 75 63 74 20 54 52 5f | 41 70 70 29 2e 0a 54 68 |ruct TR_|App)..Th|
|00001f00| 69 73 20 73 74 72 75 63 | 74 75 72 65 20 69 73 20 |is struc|ture is |
|00001f10| 74 68 65 20 63 6f 6e 6e | 65 63 74 69 6f 6e 20 77 |the conn|ection w|
|00001f20| 68 69 63 68 20 6b 65 65 | 70 73 20 61 6c 6c 20 54 |hich kee|ps all T|
|00001f30| 72 69 74 6f 6e 20 70 61 | 72 74 73 20 6f 66 20 79 |riton pa|rts of y|
|00001f40| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 0a |our appl|ication.|
|00001f50| 74 6f 67 65 74 68 65 72 | 2e 20 42 65 66 6f 72 65 |together|. Before|
|00001f60| 20 75 73 69 6e 67 20 61 | 6e 79 20 6f 74 68 65 72 | using a|ny other|
|00001f70| 20 54 72 69 74 6f 6e 20 | 66 75 6e 63 74 69 6f 6e | Triton |function|
|00001f80| 73 2c 20 79 6f 75 20 68 | 61 76 65 20 74 6f 20 63 |s, you h|ave to c|
|00001f90| 72 65 61 74 65 20 61 20 | 54 72 69 74 6f 6e 0a 61 |reate a |Triton.a|
|00001fa0| 70 70 6c 69 63 61 74 69 | 6f 6e 2c 20 61 6e 64 20 |pplicati|on, and |
|00001fb0| 79 6f 75 20 6d 75 73 74 | 20 64 65 6c 65 74 65 20 |you must| delete |
|00001fc0| 69 74 20 61 67 61 69 6e | 20 62 65 66 6f 72 65 20 |it again| before |
|00001fd0| 79 6f 75 72 20 70 72 6f | 67 72 61 6d 20 71 75 69 |your pro|gram qui|
|00001fe0| 74 73 20 28 61 6e 64 20 | 62 65 66 6f 72 65 0a 79 |ts (and |before.y|
|00001ff0| 6f 75 20 63 6c 6f 73 65 | 20 40 66 69 6c 65 7b 74 |ou close| @file{t|
|00002000| 72 69 74 6f 6e 2e 6c 69 | 62 72 61 72 79 7d 20 6f |riton.li|brary} o|
|00002010| 66 20 63 6f 75 72 73 65 | 29 2e 20 41 6e 79 20 54 |f course|). Any T|
|00002020| 72 69 74 6f 6e 20 61 70 | 70 6c 69 63 61 74 69 6f |riton ap|plicatio|
|00002030| 6e 20 6d 75 73 74 20 68 | 61 76 65 20 61 74 0a 6c |n must h|ave at.l|
|00002040| 65 61 73 74 20 61 20 73 | 68 6f 72 74 20 6e 61 6d |east a s|hort nam|
|00002050| 65 2c 20 77 68 69 63 68 | 20 69 73 20 75 73 65 64 |e, which| is used|
|00002060| 20 62 79 20 54 72 69 74 | 6f 6e 20 74 6f 20 69 64 | by Trit|on to id|
|00002070| 65 6e 74 69 66 79 20 74 | 68 65 20 61 70 70 6c 69 |entify t|he appli|
|00002080| 63 61 74 69 6f 6e 2e 20 | 41 6c 6c 20 6f 74 68 65 |cation. |All othe|
|00002090| 72 0a 74 61 67 73 20 61 | 72 65 20 6f 70 74 69 6f |r.tags a|re optio|
|000020a0| 6e 61 6c 2e 20 41 20 74 | 79 70 69 63 61 6c 20 63 |nal. A t|ypical c|
|000020b0| 6f 64 65 20 73 65 67 6d | 65 6e 74 20 63 6f 75 6c |ode segm|ent coul|
|000020c0| 64 20 6c 6f 6f 6b 20 6c | 69 6b 65 20 74 68 69 73 |d look l|ike this|
|000020d0| 3a 0a 0a 40 65 78 61 6d | 70 6c 65 0a 20 20 20 20 |:..@exam|ple. |
|000020e0| 73 74 72 75 63 74 20 54 | 52 5f 41 70 70 20 2a 6d |struct T|R_App *m|
|000020f0| 79 41 70 70 3b 0a 0a 20 | 20 20 20 69 66 28 6d 79 |yApp;.. | if(my|
|00002100| 41 70 70 3d 54 52 5f 43 | 72 65 61 74 65 41 70 70 |App=TR_C|reateApp|
|00002110| 54 61 67 73 28 0a 20 20 | 20 20 20 20 54 52 43 41 |Tags(. | TRCA|
|00002120| 5f 4e 61 6d 65 2c 20 20 | 20 20 22 4d 79 41 70 70 |_Name, | "MyApp|
|00002130| 22 2c 0a 20 20 20 20 20 | 20 54 52 43 41 5f 52 65 |",. | TRCA_Re|
|00002140| 6c 65 61 73 65 2c 20 22 | 31 2e 30 22 2c 0a 20 20 |lease, "|1.0",. |
|00002150| 20 20 20 20 54 52 43 41 | 5f 56 65 72 73 69 6f 6e | TRCA|_Version|
|00002160| 2c 20 22 34 32 2e 31 31 | 33 22 2c 0a 20 20 20 20 |, "42.11|3",. |
|00002170| 20 20 54 52 43 41 5f 44 | 61 74 65 2c 20 20 20 20 | TRCA_D|ate, |
|00002180| 22 33 2e 31 31 2e 39 34 | 22 2c 0a 20 20 20 20 20 |"3.11.94|",. |
|00002190| 20 54 41 47 5f 45 4e 44 | 29 29 0a 20 20 20 20 40 | TAG_END|)). @|
|000021a0| 7b 0a 20 20 20 20 20 20 | 2f 2a 20 55 73 65 20 6d |{. |/* Use m|
|000021b0| 79 41 70 70 20 66 6f 72 | 20 6f 74 68 65 72 20 54 |yApp for| other T|
|000021c0| 72 69 74 6f 6e 20 66 75 | 6e 63 74 69 6f 6e 73 2e |riton fu|nctions.|
|000021d0| 2e 2e 20 2a 2f 0a 20 20 | 20 20 20 20 54 52 5f 44 |.. */. | TR_D|
|000021e0| 65 6c 65 74 65 41 70 70 | 28 6d 79 41 70 70 29 3b |eleteApp|(myApp);|
|000021f0| 0a 20 20 20 20 40 7d 0a | 20 20 20 20 65 6c 73 65 |. @}.| else|
|00002200| 0a 20 20 20 20 40 7b 0a | 20 20 20 20 20 20 2f 2a |. @{.| /*|
|00002210| 20 52 65 61 63 74 20 6f | 6e 20 74 68 65 20 65 72 | React o|n the er|
|00002220| 72 6f 72 2e 2e 2e 20 2a | 2f 0a 20 20 20 20 40 7d |ror... *|/. @}|
|00002230| 0a 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 0a 54 |.@end ex|ample..T|
|00002240| 68 65 20 6c 69 6e 6b 65 | 72 20 6c 69 62 72 61 72 |he linke|r librar|
|00002250| 79 20 40 66 69 6c 65 7b | 74 72 69 74 6f 6e 2e 6c |y @file{|triton.l|
|00002260| 69 62 7d 20 6f 66 66 65 | 72 73 20 61 6e 20 65 61 |ib} offe|rs an ea|
|00002270| 73 69 65 72 20 77 61 79 | 20 74 6f 20 6f 70 65 6e |sier way| to open|
|00002280| 20 40 66 69 6c 65 7b 74 | 72 69 74 6f 6e 2e 6c 69 | @file{t|riton.li|
|00002290| 62 72 61 72 79 7d 0a 61 | 6e 64 20 63 72 65 61 74 |brary}.a|nd creat|
|000022a0| 65 20 61 20 54 72 69 74 | 6f 6e 20 61 70 70 6c 69 |e a Trit|on appli|
|000022b0| 63 61 74 69 6f 6e 20 73 | 74 72 75 63 74 75 72 65 |cation s|tructure|
|000022c0| 2e 20 54 68 65 20 74 77 | 6f 20 65 78 61 6d 70 6c |. The tw|o exampl|
|000022d0| 65 73 20 66 72 6f 6d 20 | 61 62 6f 76 65 20 63 61 |es from |above ca|
|000022e0| 6e 20 62 65 20 63 6f 6d | 62 69 6e 65 64 0a 69 6e |n be com|bined.in|
|000022f0| 74 6f 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |to the f|ollowing|
|00002300| 20 73 68 6f 72 74 20 76 | 65 72 73 69 6f 6e 3a 0a | short v|ersion:.|
|00002310| 0a 40 65 78 61 6d 70 6c | 65 0a 20 20 20 20 23 69 |.@exampl|e. #i|
|00002320| 6e 63 6c 75 64 65 20 3c | 6c 69 62 72 61 72 69 65 |nclude <|librarie|
|00002330| 73 2f 74 72 69 74 6f 6e | 2e 68 3e 0a 20 20 20 20 |s/triton|.h>. |
|00002340| 23 69 6e 63 6c 75 64 65 | 20 3c 70 72 6f 74 6f 2f |#include| <proto/|
|00002350| 74 72 69 74 6f 6e 2e 68 | 3e 0a 0a 20 20 20 20 69 |triton.h|>.. i|
|00002360| 6e 74 20 6d 61 69 6e 28 | 76 6f 69 64 29 0a 20 20 |nt main(|void). |
|00002370| 20 20 40 7b 0a 20 20 20 | 20 20 20 69 66 28 54 52 | @{. | if(TR|
|00002380| 5f 4f 70 65 6e 54 72 69 | 74 6f 6e 28 54 52 49 54 |_OpenTri|ton(TRIT|
|00002390| 4f 4e 31 32 56 45 52 53 | 49 4f 4e 2c 0a 20 20 20 |ON12VERS|ION,. |
|000023a0| 20 20 20 20 20 54 52 43 | 41 5f 4e 61 6d 65 2c 20 | TRC|A_Name, |
|000023b0| 20 20 20 22 4d 79 41 70 | 70 22 2c 0a 20 20 20 20 | "MyAp|p",. |
|000023c0| 20 20 20 20 54 52 43 41 | 5f 52 65 6c 65 61 73 65 | TRCA|_Release|
|000023d0| 2c 20 22 31 2e 30 22 2c | 0a 20 20 20 20 20 20 20 |, "1.0",|. |
|000023e0| 20 54 52 43 41 5f 56 65 | 72 73 69 6f 6e 2c 20 22 | TRCA_Ve|rsion, "|
|000023f0| 34 32 2e 31 31 33 22 2c | 0a 20 20 20 20 20 20 20 |42.113",|. |
|00002400| 20 54 52 43 41 5f 44 61 | 74 65 2c 20 20 20 20 22 | TRCA_Da|te, "|
|00002410| 33 2e 31 31 2e 39 34 22 | 2c 0a 20 20 20 20 20 20 |3.11.94"|,. |
|00002420| 20 20 54 41 47 5f 45 4e | 44 29 29 0a 20 20 20 20 | TAG_EN|D)). |
|00002430| 20 20 40 7b 0a 20 20 20 | 20 20 20 20 20 2f 2a 20 | @{. | /* |
|00002440| 54 68 65 20 6f 70 65 6e | 65 64 20 61 70 70 6c 69 |The open|ed appli|
|00002450| 63 61 74 69 6f 6e 20 69 | 73 20 63 61 6c 6c 65 64 |cation i|s called|
|00002460| 20 27 41 70 70 6c 69 63 | 61 74 69 6f 6e 27 20 2a | 'Applic|ation' *|
|00002470| 2f 0a 20 20 20 20 20 20 | 20 20 54 52 5f 43 6c 6f |/. | TR_Clo|
|00002480| 73 65 54 72 69 74 6f 6e | 28 29 3b 0a 20 20 20 20 |seTriton|();. |
|00002490| 20 20 40 7d 0a 20 20 20 | 20 20 20 65 6c 73 65 0a | @}. | else.|
|000024a0| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|000024b0| 20 2f 2a 20 52 65 61 63 | 74 20 6f 6e 20 74 68 65 | /* Reac|t on the|
|000024c0| 20 65 72 72 6f 72 2e 2e | 2e 20 2a 2f 0a 20 20 20 | error..|. */. |
|000024d0| 20 20 20 40 7d 0a 20 20 | 20 20 20 20 72 65 74 75 | @}. | retu|
|000024e0| 72 6e 20 30 3b 0a 20 20 | 20 20 40 7d 0a 40 65 6e |rn 0;. | @}.@en|
|000024f0| 64 20 65 78 61 6d 70 6c | 65 0a 0a 40 6e 6f 64 65 |d exampl|e..@node|
|00002500| 20 54 55 54 5f 50 52 4f | 2c 20 54 55 54 5f 4d 45 | TUT_PRO|, TUT_ME|
|00002510| 4e 2c 20 54 55 54 5f 41 | 50 50 2c 20 54 6f 70 0a |N, TUT_A|PP, Top.|
|00002520| 40 73 65 63 74 69 6f 6e | 20 50 72 6f 6a 65 63 74 |@section| Project|
|00002530| 73 0a 40 63 69 6e 64 65 | 78 20 50 72 6f 6a 65 63 |s.@cinde|x Projec|
|00002540| 74 73 0a 0a 41 20 54 72 | 69 74 6f 6e 20 50 72 6f |ts..A Tr|iton Pro|
|00002550| 6a 65 63 74 20 69 73 20 | 74 68 65 20 6e 65 78 74 |ject is |the next|
|00002560| 20 73 6d 61 6c 6c 65 72 | 20 65 6e 74 69 74 79 20 | smaller| entity |
|00002570| 6f 66 20 61 20 54 72 69 | 74 6f 6e 20 47 55 49 2e |of a Tri|ton GUI.|
|00002580| 20 43 75 72 72 65 6e 74 | 6c 79 0a 61 20 70 72 6f | Current|ly.a pro|
|00002590| 6a 65 63 74 20 63 6f 6e | 74 61 69 6e 73 20 65 78 |ject con|tains ex|
|000025a0| 61 63 74 6c 79 20 6f 6e | 65 20 49 6e 74 75 69 74 |actly on|e Intuit|
|000025b0| 69 6f 6e 20 77 69 6e 64 | 6f 77 2c 20 62 75 74 20 |ion wind|ow, but |
|000025c0| 69 6e 20 66 75 74 75 72 | 65 20 76 65 72 73 69 6f |in futur|e versio|
|000025d0| 6e 73 0a 6f 66 20 54 72 | 69 74 6f 6e 20 69 74 20 |ns.of Tr|iton it |
|000025e0| 63 6f 75 6c 64 20 62 65 | 20 70 6f 73 73 69 62 6c |could be| possibl|
|000025f0| 65 20 74 6f 20 61 74 74 | 61 63 68 20 6d 6f 72 65 |e to att|ach more|
|00002600| 20 77 69 6e 64 6f 77 73 | 20 74 6f 20 61 20 70 72 | windows| to a pr|
|00002610| 6f 6a 65 63 74 2e 0a 55 | 70 6f 6e 20 6f 70 65 6e |oject..U|pon open|
|00002620| 69 6e 67 20 61 20 70 72 | 6f 6a 65 63 74 2c 20 79 |ing a pr|oject, y|
|00002630| 6f 75 20 68 61 76 65 20 | 74 6f 20 73 70 65 63 69 |ou have |to speci|
|00002640| 66 79 20 61 6c 6c 20 6f | 62 6a 65 63 74 73 20 77 |fy all o|bjects w|
|00002650| 68 69 63 68 20 61 72 65 | 20 74 6f 0a 62 65 20 64 |hich are| to.be d|
|00002660| 69 73 70 6c 61 79 65 64 | 20 69 6e 20 74 68 65 20 |isplayed| in the |
|00002670| 77 69 6e 64 6f 77 2c 20 | 74 68 65 20 77 69 6e 64 |window, |the wind|
|00002680| 6f 77 27 73 20 6d 65 6e | 75 20 61 6e 64 20 73 6f |ow's men|u and so|
|00002690| 6d 65 20 74 61 67 73 20 | 64 65 73 63 72 69 62 69 |me tags |describi|
|000026a0| 6e 67 0a 77 69 6e 64 6f | 77 20 70 72 6f 70 65 72 |ng.windo|w proper|
|000026b0| 74 69 65 73 2e 0a 0a 41 | 74 20 66 69 72 73 74 20 |ties...A|t first |
|000026c0| 79 6f 75 20 68 61 76 65 | 20 74 6f 20 73 70 65 63 |you have| to spec|
|000026d0| 69 66 79 20 74 68 65 20 | 77 69 6e 64 6f 77 20 70 |ify the |window p|
|000026e0| 72 6f 70 65 72 74 69 65 | 73 2c 20 74 68 65 6e 20 |ropertie|s, then |
|000026f0| 74 68 65 20 6d 65 6e 75 | 73 20 61 6e 64 0a 66 69 |the menu|s and.fi|
|00002700| 6e 61 6c 6c 79 20 6f 6e | 65 20 28 21 29 20 6f 62 |nally on|e (!) ob|
|00002710| 6a 65 63 74 2e 20 4e 6f | 72 6d 61 6c 6c 79 20 74 |ject. No|rmally t|
|00002720| 68 69 73 20 6f 62 6a 65 | 63 74 20 77 69 6c 6c 20 |his obje|ct will |
|00002730| 62 65 20 61 20 67 72 6f | 75 70 20 77 68 69 63 68 |be a gro|up which|
|00002740| 20 63 6f 6e 74 61 69 6e | 73 0a 6f 74 68 65 72 20 | contain|s.other |
|00002750| 6f 62 6a 65 63 74 73 20 | 6f 72 20 67 72 6f 75 70 |objects |or group|
|00002760| 73 2e 0a 0a 4e 6f 74 65 | 20 74 68 61 74 20 61 6c |s...Note| that al|
|00002770| 6c 20 74 61 67 73 20 61 | 72 65 20 6f 70 74 69 6f |l tags a|re optio|
|00002780| 6e 61 6c 2e 20 59 6f 75 | 20 6d 61 79 20 6a 75 73 |nal. You| may jus|
|00002790| 74 20 61 73 20 77 65 6c | 6c 0a 6f 70 65 6e 20 61 |t as wel|l.open a|
|000027a0| 20 77 69 6e 64 6f 77 20 | 77 69 74 68 6f 75 74 20 | window |without |
|000027b0| 61 6e 79 20 74 61 67 73 | 2e 20 54 68 69 73 20 77 |any tags|. This w|
|000027c0| 69 6c 6c 20 72 65 73 75 | 6c 74 20 69 6e 20 61 20 |ill resu|lt in a |
|000027d0| 73 6d 61 6c 6c 20 77 69 | 6e 64 6f 77 2c 20 63 6f |small wi|ndow, co|
|000027e0| 6e 73 69 73 74 69 6e 67 | 0a 6f 6e 6c 79 20 6f 66 |nsisting|.only of|
|000027f0| 20 74 68 65 20 63 6c 6f | 73 65 20 61 6e 64 20 64 | the clo|se and d|
|00002800| 65 70 74 68 20 67 61 64 | 67 65 74 20 61 6e 64 20 |epth gad|get and |
|00002810| 61 20 73 6d 61 6c 6c 20 | 64 72 61 67 67 69 6e 67 |a small |dragging|
|00002820| 20 62 61 72 2c 20 62 65 | 69 6e 67 20 6f 70 65 6e | bar, be|ing open|
|00002830| 65 64 0a 6f 76 65 72 20 | 74 68 65 20 64 65 66 61 |ed.over |the defa|
|00002840| 75 6c 74 20 70 75 62 6c | 69 63 20 73 63 72 65 65 |ult publ|ic scree|
|00002850| 6e 27 73 20 74 69 74 6c | 65 20 62 61 72 2e 0a 0a |n's titl|e bar...|
|00002860| 41 73 20 77 69 74 68 20 | 6e 61 6d 69 6e 67 20 54 |As with |naming T|
|00002870| 72 69 74 6f 6e 20 61 70 | 70 6c 69 63 61 74 69 6f |riton ap|plicatio|
|00002880| 6e 73 2c 0a 79 6f 75 20 | 73 68 6f 75 6c 64 20 67 |ns,.you |should g|
|00002890| 69 76 65 20 65 61 63 68 | 20 70 72 6f 6a 65 63 74 |ive each| project|
|000028a0| 20 61 74 20 6c 65 61 73 | 74 20 61 20 75 6e 69 71 | at leas|t a uniq|
|000028b0| 75 65 20 49 44 20 77 68 | 69 63 68 20 69 73 20 75 |ue ID wh|ich is u|
|000028c0| 73 65 64 20 62 79 20 54 | 72 69 74 6f 6e 0a 65 2e |sed by T|riton.e.|
|000028d0| 67 2e 20 66 6f 72 20 72 | 65 6d 65 6d 62 65 72 69 |g. for r|ememberi|
|000028e0| 6e 67 20 74 68 65 20 77 | 69 6e 64 6f 77 20 64 69 |ng the w|indow di|
|000028f0| 6d 65 6e 73 69 6f 6e 73 | 2e 0a 0a 4f 70 65 6e 69 |mensions|...Openi|
|00002900| 6e 67 20 61 6e 64 20 63 | 6c 6f 73 69 6e 67 20 61 |ng and c|losing a|
|00002910| 0a 70 72 6f 6a 65 63 74 | 20 77 69 74 68 6f 75 74 |.project| without|
|00002920| 20 61 6e 79 20 6f 62 6a | 65 63 74 73 20 61 6e 64 | any obj|ects and|
|00002930| 20 6d 65 6e 75 73 20 63 | 6f 75 6c 64 20 6c 6f 6f | menus c|ould loo|
|00002940| 6b 20 6c 69 6b 65 20 74 | 68 69 73 3a 0a 0a 40 65 |k like t|his:..@e|
|00002950| 78 61 6d 70 6c 65 0a 20 | 20 20 20 73 74 72 75 63 |xample. | struc|
|00002960| 74 20 54 61 67 49 74 65 | 6d 20 64 75 6d 6d 79 54 |t TagIte|m dummyT|
|00002970| 61 67 73 3d 0a 20 20 20 | 20 40 7b 0a 20 20 20 20 |ags=. | @{. |
|00002980| 20 20 54 52 57 49 5f 54 | 69 74 6c 65 2c 20 28 55 | TRWI_T|itle, (U|
|00002990| 4c 4f 4e 47 29 20 22 41 | 20 64 75 6d 6d 79 20 77 |LONG) "A| dummy w|
|000029a0| 69 6e 64 6f 77 22 2c 0a | 20 20 20 20 20 20 54 52 |indow",.| TR|
|000029b0| 57 49 5f 49 44 2c 20 20 | 20 20 20 20 20 20 20 20 |WI_ID, | |
|000029c0| 20 20 34 32 2c 0a 20 20 | 20 20 20 20 54 41 47 5f | 42,. | TAG_|
|000029d0| 45 4e 44 0a 20 20 20 20 | 40 7d 3b 0a 0a 20 20 20 |END. |@};.. |
|000029e0| 20 76 6f 69 64 20 64 75 | 6d 6d 79 46 75 6e 63 74 | void du|mmyFunct|
|000029f0| 69 6f 6e 28 76 6f 69 64 | 29 0a 20 20 20 20 40 7b |ion(void|). @{|
|00002a00| 0a 20 20 20 20 20 20 73 | 74 72 75 63 74 20 54 52 |. s|truct TR|
|00002a10| 5f 50 72 6f 6a 65 63 74 | 20 2a 64 75 6d 6d 79 50 |_Project| *dummyP|
|00002a20| 72 6f 6a 65 63 74 3b 0a | 0a 20 20 20 20 20 20 69 |roject;.|. i|
|00002a30| 66 28 64 75 6d 6d 79 50 | 72 6f 6a 65 63 74 3d 54 |f(dummyP|roject=T|
|00002a40| 52 5f 4f 70 65 6e 50 72 | 6f 6a 65 63 74 28 41 70 |R_OpenPr|oject(Ap|
|00002a50| 70 6c 69 63 61 74 69 6f | 6e 2c 64 75 6d 6d 79 54 |plicatio|n,dummyT|
|00002a60| 61 67 73 29 29 0a 20 20 | 20 20 20 20 40 7b 0a 20 |ags)). | @{. |
|00002a70| 20 20 20 20 20 20 20 2f | 2a 20 4f 70 65 6e 65 64 | /|* Opened|
|00002a80| 20 73 75 63 63 65 73 73 | 66 75 6c 6c 79 20 2a 2f | success|fully */|
|00002a90| 0a 20 20 20 20 20 20 20 | 20 54 52 5f 43 6c 6f 73 |. | TR_Clos|
|00002aa0| 65 50 72 6f 6a 65 63 74 | 28 64 75 6d 6d 79 50 72 |eProject|(dummyPr|
|00002ab0| 6f 6a 65 63 74 29 3b 0a | 20 20 20 20 20 20 40 7d |oject);.| @}|
|00002ac0| 0a 20 20 20 20 20 20 65 | 6c 73 65 0a 20 20 20 20 |. e|lse. |
|00002ad0| 20 20 40 7b 0a 20 20 20 | 20 20 20 20 20 2f 2a 20 | @{. | /* |
|00002ae0| 52 65 61 63 74 20 6f 6e | 20 74 68 65 20 65 72 72 |React on| the err|
|00002af0| 6f 72 2e 2e 2e 20 2a 2f | 0a 20 20 20 20 20 20 40 |or... */|. @|
|00002b00| 7d 0a 20 20 20 20 40 7d | 0a 40 65 6e 64 20 65 78 |}. @}|.@end ex|
|00002b10| 61 6d 70 6c 65 0a 0a 4f | 66 20 63 6f 75 72 73 65 |ample..O|f course|
|00002b20| 2c 20 74 68 69 73 20 77 | 61 79 20 6f 66 20 6f 70 |, this w|ay of op|
|00002b30| 65 6e 69 6e 67 20 61 20 | 70 72 6f 6a 65 63 74 20 |ening a |project |
|00002b40| 76 69 61 20 61 20 73 74 | 61 74 69 63 20 54 61 67 |via a st|atic Tag|
|00002b50| 49 74 65 6d 20 6c 69 73 | 74 20 64 6f 65 73 6e 27 |Item lis|t doesn'|
|00002b60| 74 0a 61 6c 6c 6f 77 20 | 69 6e 73 65 72 74 69 6f |t.allow |insertio|
|00002b70| 6e 20 6f 66 20 6f 62 6a | 65 63 74 20 70 61 72 61 |n of obj|ect para|
|00002b80| 6d 65 74 65 72 73 20 6f | 72 20 6c 6f 63 61 6c 69 |meters o|r locali|
|00002b90| 7a 65 64 20 73 74 72 69 | 6e 67 73 2e 20 53 69 6e |zed stri|ngs. Sin|
|00002ba0| 63 65 20 79 6f 75 20 6e | 65 65 64 20 74 68 65 73 |ce you n|eed thes|
|00002bb0| 65 0a 66 65 61 74 75 72 | 65 73 20 6d 6f 73 74 20 |e.featur|es most |
|00002bc0| 74 69 6d 65 73 2c 20 79 | 6f 75 20 73 68 6f 75 6c |times, y|ou shoul|
|00002bd0| 64 20 69 6e 73 74 65 61 | 64 20 75 73 65 20 61 20 |d instea|d use a |
|00002be0| 64 79 6e 61 6d 69 63 20 | 54 61 67 4c 69 73 74 20 |dynamic |TagList |
|00002bf0| 77 68 69 63 68 20 69 73 | 20 62 75 69 6c 74 0a 6f |which is| built.o|
|00002c00| 6e 20 74 68 65 20 73 74 | 61 63 6b 20 61 74 20 72 |n the st|ack at r|
|00002c10| 75 6e 74 69 6d 65 2e 20 | 42 65 20 73 75 72 65 20 |untime. |Be sure |
|00002c20| 74 6f 20 73 65 74 20 61 | 20 6c 61 72 67 65 20 65 |to set a| large e|
|00002c30| 6e 6f 75 67 68 20 73 74 | 61 63 6b 21 20 53 6f 6d |nough st|ack! Som|
|00002c40| 65 20 64 65 76 65 6c 6f | 70 6d 65 6e 74 0a 73 79 |e develo|pment.sy|
|00002c50| 73 74 65 6d 73 20 6f 66 | 66 65 72 20 61 75 74 6f |stems of|fer auto|
|00002c60| 6d 61 74 69 63 20 73 74 | 61 63 6b 20 73 65 74 74 |matic st|ack sett|
|00002c70| 69 6e 67 20 69 6e 20 74 | 68 65 69 72 20 73 74 61 |ing in t|heir sta|
|00002c80| 72 74 75 70 20 63 6f 64 | 65 2c 20 77 68 69 63 68 |rtup cod|e, which|
|00002c90| 20 63 6f 6d 65 73 0a 68 | 61 6e 64 79 20 69 6e 20 | comes.h|andy in |
|00002ca0| 74 68 6f 73 65 20 73 69 | 74 75 61 74 69 6f 6e 73 |those si|tuations|
|00002cb0| 2e 20 50 6c 65 61 73 65 | 20 64 6f 20 6e 6f 74 20 |. Please| do not |
|00002cc0| 72 65 6c 79 20 6f 6e 20 | 74 68 65 20 75 73 65 72 |rely on |the user|
|00002cd0| 20 74 6f 20 73 65 74 20 | 74 68 65 0a 73 74 61 63 | to set |the.stac|
|00002ce0| 6b 21 0a 0a 4e 6f 74 65 | 20 74 68 61 74 20 69 74 |k!..Note| that it|
|00002cf0| 20 69 73 20 63 75 72 72 | 65 6e 74 6c 79 20 6e 6f | is curr|ently no|
|00002d00| 74 20 70 6f 73 73 69 62 | 6c 65 20 74 6f 20 75 73 |t possib|le to us|
|00002d10| 65 20 40 63 6f 64 65 7b | 54 41 47 5f 4d 4f 52 45 |e @code{|TAG_MORE|
|00002d20| 7d 2c 0a 40 63 6f 64 65 | 7b 54 41 47 5f 53 4b 49 |},.@code|{TAG_SKI|
|00002d30| 50 7d 20 61 6e 64 20 40 | 63 6f 64 65 7b 54 41 47 |P} and @|code{TAG|
|00002d40| 5f 49 47 4e 4f 52 45 7d | 20 77 69 74 68 20 54 72 |_IGNORE}| with Tr|
|00002d50| 69 74 6f 6e 20 74 61 67 | 6c 69 73 74 73 2e 0a 0a |iton tag|lists...|
|00002d60| 41 6e 64 20 6e 6f 77 20 | 62 61 63 6b 20 74 6f 20 |And now |back to |
|00002d70| 6f 75 72 20 63 6f 64 65 | 2c 20 74 68 69 73 20 74 |our code|, this t|
|00002d80| 69 6d 65 20 77 69 74 68 | 20 61 20 64 79 6e 61 6d |ime with| a dynam|
|00002d90| 69 63 20 6c 69 73 74 2e | 20 49 6d 61 67 69 6e 65 |ic list.| Imagine|
|00002da0| 20 61 20 66 75 6e 63 74 | 69 6f 6e 0a 40 63 6f 64 | a funct|ion.@cod|
|00002db0| 65 7b 53 54 52 50 54 52 | 20 47 65 74 4c 6f 63 53 |e{STRPTR| GetLocS|
|00002dc0| 74 72 28 69 6e 74 20 6e | 75 6d 29 7d 20 77 68 69 |tr(int n|um)} whi|
|00002dd0| 63 68 20 67 69 76 65 73 | 20 79 6f 75 20 61 20 6c |ch gives| you a l|
|00002de0| 6f 63 61 6c 69 7a 65 64 | 20 73 74 72 69 6e 67 2e |ocalized| string.|
|00002df0| 0a 0a 40 65 78 61 6d 70 | 6c 65 0a 20 20 20 20 76 |..@examp|le. v|
|00002e00| 6f 69 64 20 64 75 6d 6d | 79 46 75 6e 63 74 69 6f |oid dumm|yFunctio|
|00002e10| 6e 28 76 6f 69 64 29 0a | 20 20 20 20 40 7b 0a 20 |n(void).| @{. |
|00002e20| 20 20 20 20 20 73 74 72 | 75 63 74 20 54 52 5f 50 | str|uct TR_P|
|00002e30| 72 6f 6a 65 63 74 20 2a | 64 75 6d 6d 79 50 72 6f |roject *|dummyPro|
|00002e40| 6a 65 63 74 3b 0a 0a 20 | 20 20 20 20 20 69 66 28 |ject;.. | if(|
|00002e50| 64 75 6d 6d 79 50 72 6f | 6a 65 63 74 3d 54 52 5f |dummyPro|ject=TR_|
|00002e60| 4f 70 65 6e 50 72 6f 6a | 65 63 74 54 61 67 73 28 |OpenProj|ectTags(|
|00002e70| 41 70 70 6c 69 63 61 74 | 69 6f 6e 2c 0a 20 20 20 |Applicat|ion,. |
|00002e80| 20 20 20 20 20 54 52 57 | 49 5f 54 69 74 6c 65 2c | TRW|I_Title,|
|00002e90| 20 28 55 4c 4f 4e 47 29 | 20 47 65 74 4c 6f 63 53 | (ULONG)| GetLocS|
|00002ea0| 74 72 28 4d 53 47 5f 57 | 49 4e 54 49 54 4c 45 5f |tr(MSG_W|INTITLE_|
|00002eb0| 44 55 4d 4d 59 29 2c 0a | 20 20 20 20 20 20 20 20 |DUMMY),.| |
|00002ec0| 54 52 57 49 5f 49 44 2c | 20 20 20 20 20 20 20 20 |TRWI_ID,| |
|00002ed0| 20 20 20 20 34 32 2c 0a | 20 20 20 20 20 20 20 20 | 42,.| |
|00002ee0| 54 41 47 5f 45 4e 44 29 | 29 0a 20 20 20 20 20 20 |TAG_END)|). |
|00002ef0| 40 7b 0a 20 20 20 20 20 | 20 20 20 2f 2a 20 4f 70 |@{. | /* Op|
|00002f00| 65 6e 65 64 20 73 75 63 | 63 65 73 73 66 75 6c 6c |ened suc|cessfull|
|00002f10| 79 20 2a 2f 0a 20 20 20 | 20 20 20 20 20 54 52 5f |y */. | TR_|
|00002f20| 43 6c 6f 73 65 50 72 6f | 6a 65 63 74 28 64 75 6d |ClosePro|ject(dum|
|00002f30| 6d 79 50 72 6f 6a 65 63 | 74 29 3b 0a 20 20 20 20 |myProjec|t);. |
|00002f40| 20 20 40 7d 0a 20 20 20 | 20 20 20 65 6c 73 65 0a | @}. | else.|
|00002f50| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|00002f60| 20 2f 2a 20 52 65 61 63 | 74 20 6f 6e 20 74 68 65 | /* Reac|t on the|
|00002f70| 20 65 72 72 6f 72 2e 2e | 2e 20 2a 2f 0a 20 20 20 | error..|. */. |
|00002f80| 20 20 20 40 7d 0a 20 20 | 20 20 40 7d 0a 40 65 6e | @}. | @}.@en|
|00002f90| 64 20 65 78 61 6d 70 6c | 65 0a 0a 54 68 65 20 49 |d exampl|e..The I|
|00002fa0| 44 20 34 32 20 69 6e 20 | 74 68 65 20 61 62 6f 76 |D 42 in |the abov|
|00002fb0| 65 20 65 78 61 6d 70 6c | 65 73 20 68 61 73 20 62 |e exampl|es has b|
|00002fc0| 65 65 6e 20 63 68 6f 73 | 65 6e 20 72 61 6e 64 6f |een chos|en rando|
|00002fd0| 6d 6c 79 2e 20 54 68 69 | 73 20 69 73 20 6e 6f 0a |mly. Thi|s is no.|
|00002fe0| 70 72 6f 62 6c 65 6d 20 | 61 73 20 6c 6f 6e 67 20 |problem |as long |
|00002ff0| 61 73 20 79 6f 75 20 73 | 74 69 63 6b 20 74 6f 20 |as you s|tick to |
|00003000| 74 68 69 73 20 49 44 20 | 69 6e 20 66 75 74 75 72 |this ID |in futur|
|00003010| 65 20 75 70 64 61 74 65 | 73 20 6f 66 20 79 6f 75 |e update|s of you|
|00003020| 72 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 2e 0a 4f |r applic|ation..O|
|00003030| 74 68 65 72 77 69 73 65 | 20 74 68 65 20 77 69 6e |therwise| the win|
|00003040| 64 6f 77 20 64 69 6d 65 | 6e 73 69 6f 6e 73 20 77 |dow dime|nsions w|
|00003050| 6f 75 6c 64 20 62 65 20 | 77 72 6f 6e 67 20 61 6e |ould be |wrong an|
|00003060| 64 20 74 68 65 20 75 73 | 65 72 20 77 6f 75 6c 64 |d the us|er would|
|00003070| 20 68 61 76 65 20 74 6f | 0a 61 64 6a 75 73 74 20 | have to|.adjust |
|00003080| 74 68 65 6d 20 61 67 61 | 69 6e 2e 0a 0a 49 6e 20 |them aga|in...In |
|00003090| 6f 72 64 65 72 20 74 6f | 20 6e 6f 74 20 75 73 65 |order to| not use|
|000030a0| 20 49 44 73 20 74 77 69 | 63 65 2c 20 69 74 20 63 | IDs twi|ce, it c|
|000030b0| 61 6e 20 62 65 20 75 73 | 65 66 75 6c 20 74 6f 20 |an be us|eful to |
|000030c0| 65 6e 75 6d 65 72 61 74 | 65 20 74 68 65 6d 3a 0a |enumerat|e them:.|
|000030d0| 0a 40 65 78 61 6d 70 6c | 65 0a 20 20 20 20 65 6e |.@exampl|e. en|
|000030e0| 75 6d 20 77 69 6e 64 6f | 77 49 44 73 20 40 7b 57 |um windo|wIDs @{W|
|000030f0| 49 4e 49 44 5f 44 55 4d | 4d 59 3d 31 2c 20 57 49 |INID_DUM|MY=1, WI|
|00003100| 4e 49 44 5f 46 4f 4f 2c | 20 57 49 4e 49 44 5f 42 |NID_FOO,| WINID_B|
|00003110| 41 52 40 7d 3b 0a 40 65 | 6e 64 20 65 78 61 6d 70 |AR@};.@e|nd examp|
|00003120| 6c 65 0a 0a 4e 6f 74 65 | 20 74 68 61 74 20 77 69 |le..Note| that wi|
|00003130| 6e 64 6f 77 20 49 44 73 | 20 6d 75 73 74 20 62 65 |ndow IDs| must be|
|00003140| 20 64 69 66 66 65 72 65 | 6e 74 20 66 72 6f 6d 20 | differe|nt from |
|00003150| 30 2e 20 30 20 69 73 20 | 65 71 75 61 6c 20 74 6f |0. 0 is |equal to|
|00003160| 0a 6e 6f 20 49 44 20 61 | 74 20 61 6c 6c 2e 0a 0a |.no ID a|t all...|
|00003170| 53 65 65 20 74 68 65 20 | 61 75 74 6f 64 6f 63 20 |See the |autodoc |
|00003180| 63 6c 69 70 20 40 63 6f | 64 65 7b 74 72 69 74 6f |clip @co|de{trito|
|00003190| 6e 2e 6c 69 62 72 61 72 | 79 2f 54 52 5f 4f 70 65 |n.librar|y/TR_Ope|
|000031a0| 6e 50 72 6f 6a 65 63 74 | 28 29 7d 20 66 6f 72 20 |nProject|()} for |
|000031b0| 64 65 74 61 69 6c 73 0a | 61 62 6f 75 74 20 74 68 |details.|about th|
|000031c0| 65 20 73 75 70 70 6f 72 | 74 65 64 20 74 61 67 73 |e suppor|ted tags|
|000031d0| 2e 0a 0a 40 6e 6f 64 65 | 20 54 55 54 5f 4d 45 4e |...@node| TUT_MEN|
|000031e0| 2c 20 54 55 54 5f 4f 42 | 4a 2c 20 54 55 54 5f 50 |, TUT_OB|J, TUT_P|
|000031f0| 52 4f 2c 20 54 6f 70 0a | 40 73 65 63 74 69 6f 6e |RO, Top.|@section|
|00003200| 20 4d 65 6e 75 73 0a 40 | 63 69 6e 64 65 78 20 4d | Menus.@|cindex M|
|00003210| 65 6e 75 73 0a 0a 41 6e | 79 20 70 72 6f 6a 65 63 |enus..An|y projec|
|00003220| 74 20 64 65 66 69 6e 69 | 74 6f 6e 20 6d 61 79 20 |t defini|ton may |
|00003230| 63 6f 6e 74 61 69 6e 20 | 6d 65 6e 75 73 2e 20 54 |contain |menus. T|
|00003240| 68 65 20 6d 65 6e 75 20 | 74 61 67 73 20 6d 75 73 |he menu |tags mus|
|00003250| 74 20 66 6f 6c 6c 6f 77 | 0a 74 68 65 20 77 69 6e |t follow|.the win|
|00003260| 64 6f 77 20 74 61 67 73 | 20 69 6d 6d 65 64 69 61 |dow tags| immedia|
|00003270| 74 65 6c 79 2c 20 62 65 | 66 6f 72 65 20 74 68 65 |tely, be|fore the|
|00003280| 20 6f 62 6a 65 63 74 20 | 74 61 67 73 2e 20 49 66 | object |tags. If|
|00003290| 20 61 20 6d 65 6e 75 20 | 68 61 73 0a 61 6e 20 6f | a menu |has.an o|
|000032a0| 62 6a 65 63 74 20 49 44 | 2c 20 74 68 65 20 54 52 |bject ID|, the TR|
|000032b0| 41 54 5f 49 44 20 74 61 | 67 20 6d 75 73 74 20 62 |AT_ID ta|g must b|
|000032c0| 65 20 74 68 65 20 6c 61 | 73 74 20 6f 6e 65 20 69 |e the la|st one i|
|000032d0| 6e 20 74 68 65 20 6d 65 | 6e 75 0a 64 65 66 69 6e |n the me|nu.defin|
|000032e0| 69 74 69 6f 6e 2e 0a 0a | 4f 62 6a 65 63 74 20 49 |ition...|Object I|
|000032f0| 44 73 20 61 72 65 20 6d | 6f 72 65 20 74 68 61 6e |Ds are m|ore than|
|00003300| 20 50 72 6f 6a 65 63 74 | 20 49 44 73 2e 20 50 72 | Project| IDs. Pr|
|00003310| 6f 6a 65 63 74 20 49 44 | 73 20 61 72 65 0a 75 73 |oject ID|s are.us|
|00003320| 65 64 20 6f 6e 6c 79 20 | 69 6e 74 65 72 6e 61 6c |ed only |internal|
|00003330| 6c 79 20 62 79 20 54 72 | 69 74 6f 6e 2e 20 41 73 |ly by Tr|iton. As|
|00003340| 20 61 6e 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | an appl|ication |
|00003350| 70 72 6f 67 72 61 6d 6d | 65 72 2c 20 79 6f 75 0a |programm|er, you.|
|00003360| 68 61 76 65 20 74 6f 20 | 72 65 66 65 72 65 6e 63 |have to |referenc|
|00003370| 65 20 50 72 6f 6a 65 63 | 74 73 20 62 79 20 61 20 |e Projec|ts by a |
|00003380| 70 6f 69 6e 74 65 72 20 | 74 6f 20 74 68 65 69 72 |pointer |to their|
|00003390| 20 40 63 6f 64 65 7b 73 | 74 72 75 63 74 20 54 52 | @code{s|truct TR|
|000033a0| 5f 50 72 6f 6a 65 63 74 | 7d 2e 0a 4f 62 6a 65 63 |_Project|}..Objec|
|000033b0| 74 73 20 69 6e 73 74 65 | 61 64 20 61 72 65 20 72 |ts inste|ad are r|
|000033c0| 65 66 65 72 65 6e 63 65 | 64 20 6f 6e 6c 79 20 74 |eference|d only t|
|000033d0| 68 72 6f 75 67 68 0a 6f | 62 6a 65 63 74 20 49 44 |hrough.o|bject ID|
|000033e0| 73 2e 20 54 68 65 20 73 | 61 6d 65 20 69 73 20 74 |s. The s|ame is t|
|000033f0| 72 75 65 20 66 6f 72 20 | 6d 65 6e 75 73 2c 20 77 |rue for |menus, w|
|00003400| 68 69 63 68 20 75 73 65 | 20 6f 72 64 69 6e 61 72 |hich use| ordinar|
|00003410| 79 20 6f 62 6a 65 63 74 | 20 49 44 73 2e 0a 0a 41 |y object| IDs...A|
|00003420| 20 74 79 70 69 63 61 6c | 20 6d 65 6e 75 20 64 65 | typical| menu de|
|00003430| 66 69 6e 74 69 6f 6e 20 | 63 6f 75 6c 64 20 6c 6f |fintion |could lo|
|00003440| 6f 6b 20 6c 69 6b 65 20 | 74 68 69 73 3a 0a 0a 40 |ok like |this:..@|
|00003450| 65 78 61 6d 70 6c 65 0a | 20 20 20 20 54 52 5f 4f |example.| TR_O|
|00003460| 70 65 6e 50 72 6f 6a 65 | 63 74 54 61 67 73 28 2e |penProje|ctTags(.|
|00003470| 2e 2e 0a 20 20 20 20 20 | 20 54 52 4d 4e 5f 54 69 |... | TRMN_Ti|
|00003480| 74 6c 65 2c 20 20 20 28 | 55 4c 4f 4e 47 29 20 22 |tle, (|ULONG) "|
|00003490| 50 72 6f 6a 65 63 74 22 | 2c 0a 20 20 20 20 20 20 |Project"|,. |
|000034a0| 20 20 54 52 4d 4e 5f 49 | 74 65 6d 2c 20 20 28 55 | TRMN_I|tem, (U|
|000034b0| 4c 4f 4e 47 29 20 22 3f | 5f 41 62 6f 75 74 22 2c |LONG) "?|_About",|
|000034c0| 20 20 20 20 20 20 20 54 | 52 41 54 5f 49 44 2c 20 | T|RAT_ID, |
|000034d0| 31 2c 0a 20 20 20 20 20 | 20 20 20 54 52 4d 4e 5f |1,. | TRMN_|
|000034e0| 49 74 65 6d 2c 20 20 28 | 55 4c 4f 4e 47 29 20 54 |Item, (|ULONG) T|
|000034f0| 52 4d 4e 5f 42 41 52 4c | 41 42 45 4c 2c 20 20 20 |RMN_BARL|ABEL, |
|00003500| 54 52 41 54 5f 49 44 2c | 20 32 2c 0a 20 20 20 20 |TRAT_ID,| 2,. |
|00003510| 20 20 20 20 54 52 4d 4e | 5f 49 74 65 6d 2c 20 20 | TRMN|_Item, |
|00003520| 28 55 4c 4f 4e 47 29 20 | 22 51 5f 51 75 69 74 22 |(ULONG) |"Q_Quit"|
|00003530| 2c 20 20 20 20 20 20 20 | 20 54 52 41 54 5f 49 44 |, | TRAT_ID|
|00003540| 2c 20 33 2c 0a 20 20 20 | 20 20 20 2e 2e 2e 29 3b |, 3,. | ...);|
|00003550| 0a 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 0a 54 |.@end ex|ample..T|
|00003560| 68 65 20 74 69 74 6c 65 | 20 6f 66 20 61 20 6d 65 |he title| of a me|
|00003570| 6e 75 20 69 74 65 6d 20 | 6f 72 20 73 75 62 2d 69 |nu item |or sub-i|
|00003580| 74 65 6d 20 63 61 6e 20 | 62 65 20 40 63 6f 64 65 |tem can |be @code|
|00003590| 7b 54 52 4d 53 5f 42 41 | 52 4c 41 42 45 4c 7d 0a |{TRMS_BA|RLABEL}.|
|000035a0| 74 6f 20 69 6e 73 65 72 | 74 20 61 20 73 74 61 6e |to inser|t a stan|
|000035b0| 64 61 72 64 20 73 65 70 | 61 72 61 74 6f 72 20 62 |dard sep|arator b|
|000035c0| 61 72 2e 20 4b 65 79 62 | 6f 61 72 64 20 73 68 6f |ar. Keyb|oard sho|
|000035d0| 72 74 63 75 74 73 20 63 | 61 6e 20 62 65 0a 73 70 |rtcuts c|an be.sp|
|000035e0| 65 63 69 66 69 65 64 20 | 62 79 20 62 65 67 69 6e |ecified |by begin|
|000035f0| 6e 69 6e 67 20 74 68 65 | 20 6d 65 6e 75 20 6c 61 |ning the| menu la|
|00003600| 62 65 6c 20 77 69 74 68 | 20 74 68 65 20 73 68 6f |bel with| the sho|
|00003610| 72 74 63 75 74 20 6b 65 | 79 0a 66 6f 6c 6c 6f 77 |rtcut ke|y.follow|
|00003620| 65 64 20 62 79 20 61 6e | 20 75 6e 64 65 72 73 63 |ed by an| undersc|
|00003630| 6f 72 65 20 63 68 61 72 | 61 63 74 65 72 20 61 6e |ore char|acter an|
|00003640| 64 20 74 68 65 20 72 65 | 61 6c 20 6d 65 6e 75 20 |d the re|al menu |
|00003650| 6c 61 62 65 6c 2e 0a 54 | 68 65 73 65 20 73 69 6d |label..T|hese sim|
|00003660| 70 6c 65 20 73 68 6f 72 | 74 63 75 74 73 20 28 77 |ple shor|tcuts (w|
|00003670| 69 74 68 20 74 68 65 20 | 72 69 67 68 74 20 41 6d |ith the |right Am|
|00003680| 69 67 61 20 6b 65 79 29 | 20 61 72 65 20 70 72 6f |iga key)| are pro|
|00003690| 63 65 73 73 65 64 0a 61 | 75 74 6f 6d 61 74 69 63 |cessed.a|utomatic|
|000036a0| 61 6c 6c 79 2e 20 59 6f | 75 20 63 61 6e 20 63 72 |ally. Yo|u can cr|
|000036b0| 65 61 74 65 20 61 20 73 | 6f 2d 63 61 6c 6c 65 64 |eate a s|o-called|
|000036c0| 20 27 65 78 74 65 6e 64 | 65 64 20 73 68 6f 72 74 | 'extend|ed short|
|000036d0| 63 75 74 27 0a 62 79 20 | 73 74 61 72 74 69 6e 67 |cut'.by |starting|
|000036e0| 20 61 20 6c 61 62 65 6c | 20 77 69 74 68 20 61 6e | a label| with an|
|000036f0| 20 75 6e 64 65 72 73 63 | 6f 72 65 20 63 68 61 72 | undersc|ore char|
|00003700| 61 63 74 65 72 2c 20 74 | 68 65 6e 20 74 68 65 0a |acter, t|hen the.|
|00003710| 74 65 78 74 20 66 6f 72 | 20 74 68 65 20 73 68 6f |text for| the sho|
|00003720| 72 74 63 75 74 2c 20 61 | 6e 6f 74 68 65 72 20 75 |rtcut, a|nother u|
|00003730| 6e 64 65 72 73 63 6f 72 | 65 20 61 6e 64 20 74 68 |nderscor|e and th|
|00003740| 65 20 6d 65 6e 75 20 6c | 61 62 65 6c 2e 0a 54 68 |e menu l|abel..Th|
|00003750| 65 73 65 20 65 78 74 65 | 6e 64 65 64 20 73 68 6f |ese exte|nded sho|
|00003760| 72 74 63 75 74 73 20 61 | 72 65 20 6f 6e 6c 79 20 |rtcuts a|re only |
|00003770| 64 69 73 70 6c 61 79 65 | 64 20 77 69 74 68 20 41 |displaye|d with A|
|00003780| 6d 69 67 61 4f 53 20 33 | 2e 30 0a 6f 72 20 68 69 |migaOS 3|.0.or hi|
|00003790| 67 68 65 72 20 61 6e 64 | 20 74 68 65 79 20 61 72 |gher and| they ar|
|000037a0| 65 20 6e 6f 74 20 6d 61 | 6e 61 67 65 64 20 61 75 |e not ma|naged au|
|000037b0| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 2e 20 59 6f 75 |tomatica|lly. You|
|000037c0| 20 68 61 76 65 20 74 6f | 0a 6c 69 73 74 65 6e 20 | have to|.listen |
|000037d0| 74 6f 20 69 6e 63 6f 6d | 69 6e 67 20 6b 65 79 62 |to incom|ing keyb|
|000037e0| 6f 61 72 64 20 65 76 65 | 6e 74 73 20 69 6e 20 6f |oard eve|nts in o|
|000037f0| 72 64 65 72 20 74 6f 20 | 68 61 6e 64 6c 65 0a 74 |rder to |handle.t|
|00003800| 68 65 73 65 20 73 68 6f | 72 74 63 75 74 73 20 79 |hese sho|rtcuts y|
|00003810| 6f 75 72 73 65 6c 66 2e | 0a 0a 53 65 65 20 74 68 |ourself.|..See th|
|00003820| 65 20 40 63 6f 64 65 7b | 4d 65 6e 75 73 7d 20 77 |e @code{|Menus} w|
|00003830| 69 6e 64 6f 77 20 6f 66 | 20 74 68 65 20 54 72 69 |indow of| the Tri|
|00003840| 74 6f 6e 20 64 65 6d 6f | 20 61 70 70 6c 69 63 61 |ton demo| applica|
|00003850| 74 69 6f 6e 20 66 6f 72 | 20 61 0a 6d 6f 72 65 20 |tion for| a.more |
|00003860| 64 65 74 61 69 6c 65 64 | 20 65 78 61 6d 70 6c 65 |detailed| example|
|00003870| 20 6f 6e 20 6d 65 6e 75 | 73 2e 0a 0a 40 6e 6f 64 | on menu|s...@nod|
|00003880| 65 20 54 55 54 5f 4f 42 | 4a 2c 20 54 55 54 5f 4c |e TUT_OB|J, TUT_L|
|00003890| 41 59 2c 20 54 55 54 5f | 4d 45 4e 2c 20 54 6f 70 |AY, TUT_|MEN, Top|
|000038a0| 0a 40 73 65 63 74 69 6f | 6e 20 4f 62 6a 65 63 74 |.@sectio|n Object|
|000038b0| 73 0a 40 63 69 6e 64 65 | 78 20 4f 62 6a 65 63 74 |s.@cinde|x Object|
|000038c0| 73 0a 0a 54 68 65 20 68 | 65 61 72 74 20 6f 66 20 |s..The h|eart of |
|000038d0| 65 76 65 72 79 20 54 72 | 69 74 6f 6e 20 47 55 49 |every Tr|iton GUI|
|000038e0| 20 69 73 20 6f 62 6a 65 | 63 74 73 2e 20 43 75 72 | is obje|cts. Cur|
|000038f0| 72 65 6e 74 6c 79 20 6f | 6e 6c 79 20 69 6e 73 74 |rently o|nly inst|
|00003900| 61 6e 63 65 73 0a 6f 66 | 20 73 75 62 63 6c 61 73 |ances.of| subclas|
|00003910| 73 65 73 20 6f 66 20 74 | 68 65 20 40 63 6f 64 65 |ses of t|he @code|
|00003920| 7b 44 69 73 70 6c 61 79 | 4f 62 6a 65 63 74 7d 20 |{Display|Object} |
|00003930| 63 6c 61 73 73 20 63 61 | 6e 20 62 65 20 63 72 65 |class ca|n be cre|
|00003940| 61 74 65 64 2e 0a 40 78 | 72 65 66 7b 49 4e 54 5f |ated..@x|ref{INT_|
|00003950| 43 4c 41 2c 20 43 6c 61 | 73 73 20 54 72 65 65 2c |CLA, Cla|ss Tree,|
|00003960| 20 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 20 2d 20 | Introdu|ction - |
|00003970| 43 6c 61 73 73 20 54 72 | 65 65 7d 2c 20 66 6f 72 |Class Tr|ee}, for|
|00003980| 20 61 20 73 68 6f 72 74 | 20 6c 69 73 74 0a 6f 66 | a short| list.of|
|00003990| 20 61 6c 6c 20 63 6c 61 | 73 73 65 73 2e 20 44 65 | all cla|sses. De|
|000039a0| 74 61 69 6c 65 64 20 64 | 65 73 63 72 69 70 74 69 |tailed d|escripti|
|000039b0| 6f 6e 73 20 63 61 6e 20 | 62 65 20 66 6f 75 6e 64 |ons can |be found|
|000039c0| 20 69 6e 20 74 68 65 20 | 61 75 74 6f 64 6f 63 73 | in the |autodocs|
|000039d0| 2e 0a 0a 4f 62 6a 65 63 | 74 73 20 61 72 65 20 63 |...Objec|ts are c|
|000039e0| 72 65 61 74 65 64 20 62 | 79 20 69 6e 73 65 72 74 |reated b|y insert|
|000039f0| 69 6e 67 20 61 6e 20 6f | 62 6a 65 63 74 20 74 61 |ing an o|bject ta|
|00003a00| 67 20 69 6e 74 6f 20 61 | 20 70 72 6f 6a 65 63 74 |g into a| project|
|00003a10| 20 64 65 66 69 6e 69 74 | 69 6f 6e 2e 0a 46 6f 72 | definit|ion..For|
|00003a20| 20 65 78 61 6d 70 6c 65 | 2c 20 61 20 63 68 65 63 | example|, a chec|
|00003a30| 6b 65 64 20 43 68 65 63 | 6b 42 6f 78 20 6f 62 6a |ked Chec|kBox obj|
|00003a40| 65 63 74 20 77 69 74 68 | 20 61 6e 20 49 44 20 6f |ect with| an ID o|
|00003a50| 66 20 39 39 20 63 61 6e | 20 62 65 20 63 72 65 61 |f 99 can| be crea|
|00003a60| 74 65 64 0a 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ted.the |followin|
|00003a70| 67 20 77 61 79 3a 0a 0a | 40 65 78 61 6d 70 6c 65 |g way:..|@example|
|00003a80| 0a 20 20 20 20 54 52 4f | 42 5f 43 68 65 63 6b 42 |. TRO|B_CheckB|
|00003a90| 6f 78 2c 20 20 20 4e 55 | 4c 4c 2c 0a 20 20 20 20 |ox, NU|LL,. |
|00003aa0| 20 20 54 52 41 54 5f 56 | 61 6c 75 65 2c 20 20 20 | TRAT_V|alue, |
|00003ab0| 20 28 55 4c 4f 4e 47 29 | 20 54 52 55 45 2c 0a 20 | (ULONG)| TRUE,. |
|00003ac0| 20 20 20 20 20 54 52 41 | 54 5f 49 44 2c 20 20 20 | TRA|T_ID, |
|00003ad0| 20 20 20 20 39 39 2c 0a | 40 65 6e 64 20 65 78 61 | 99,.|@end exa|
|00003ae0| 6d 70 6c 65 0a 0a 41 6c | 6c 20 61 76 61 69 6c 61 |mple..Al|l availa|
|00003af0| 62 6c 65 20 74 61 67 73 | 20 61 72 65 20 6c 69 73 |ble tags| are lis|
|00003b00| 74 65 64 20 69 6e 20 74 | 68 65 20 61 75 74 6f 64 |ted in t|he autod|
|00003b10| 6f 63 73 2e 20 54 68 65 | 20 40 63 6f 64 65 7b 3c |ocs. The| @code{<|
|00003b20| 44 65 66 61 75 6c 74 3e | 7d 20 74 61 67 27 73 0a |Default>|} tag's.|
|00003b30| 76 61 6c 75 65 20 68 61 | 73 20 74 6f 20 62 65 20 |value ha|s to be |
|00003b40| 69 6e 73 65 72 74 65 64 | 20 64 69 72 65 63 74 6c |inserted| directl|
|00003b50| 79 20 69 6e 20 74 68 65 | 20 40 63 6f 64 65 7b 54 |y in the| @code{T|
|00003b60| 52 4f 42 5f 3c 43 6c 61 | 73 73 3e 7d 20 74 61 67 |ROB_<Cla|ss>} tag|
|00003b70| 20 61 73 20 69 74 73 0a | 64 61 74 61 2e 20 41 6c | as its.|data. Al|
|00003b80| 6c 20 6f 74 68 65 72 20 | 74 61 67 73 20 61 72 65 |l other |tags are|
|00003b90| 20 69 6e 73 65 72 74 65 | 64 20 6e 6f 72 6d 61 6c | inserte|d normal|
|00003ba0| 6c 79 20 61 66 74 65 72 | 20 74 68 65 20 69 6e 69 |ly after| the ini|
|00003bb0| 74 69 61 6c 20 63 6c 61 | 73 73 20 74 61 67 2e 0a |tial cla|ss tag..|
|00003bc0| 0a 40 63 69 6e 64 65 78 | 20 4e 6f 74 69 66 69 63 |.@cindex| Notific|
|00003bd0| 61 74 69 6f 6e 0a 40 63 | 69 6e 64 65 78 20 4c 69 |ation.@c|index Li|
|00003be0| 6e 6b 69 6e 67 0a 40 73 | 74 72 6f 6e 67 7b 4e 6f |nking.@s|trong{No|
|00003bf0| 74 65 3a 7d 20 49 74 20 | 69 73 20 75 73 65 66 75 |te:} It |is usefu|
|00003c00| 6c 20 74 6f 20 40 63 6f | 64 65 7b 65 6e 75 6d 7d |l to @co|de{enum}|
|00003c10| 65 72 61 74 65 20 6f 62 | 6a 65 63 74 20 49 44 73 |erate ob|ject IDs|
|00003c20| 20 61 73 20 77 69 74 68 | 0a 70 72 6f 6a 65 63 74 | as with|.project|
|00003c30| 20 49 44 73 2e 20 42 75 | 74 20 69 6e 20 63 6f 6e | IDs. Bu|t in con|
|00003c40| 74 72 61 73 74 20 74 6f | 20 70 72 6f 6a 65 63 74 |trast to| project|
|00003c50| 20 49 44 73 2c 20 6f 62 | 6a 65 63 74 20 49 44 73 | IDs, ob|ject IDs|
|00003c60| 20 6d 61 79 20 62 65 20 | 75 73 65 64 0a 6d 6f 72 | may be |used.mor|
|00003c70| 65 20 74 68 61 6e 20 6f | 6e 63 65 2e 20 49 66 20 |e than o|nce. If |
|00003c80| 79 6f 75 20 75 73 65 20 | 61 6e 20 6f 62 6a 65 63 |you use |an objec|
|00003c90| 74 20 49 44 20 73 65 76 | 65 72 61 6c 20 74 69 6d |t ID sev|eral tim|
|00003ca0| 65 73 20 77 69 74 68 69 | 6e 20 74 68 65 20 73 61 |es withi|n the sa|
|00003cb0| 6d 65 0a 70 72 6f 6a 65 | 63 74 2c 20 74 68 65 20 |me.proje|ct, the |
|00003cc0| 6f 62 6a 65 63 74 73 20 | 77 69 74 68 20 74 68 61 |objects |with tha|
|00003cd0| 74 20 49 44 20 77 69 6c | 6c 20 62 65 20 6c 69 6e |t ID wil|l be lin|
|00003ce0| 6b 65 64 20 74 6f 67 65 | 74 68 65 72 20 61 6e 64 |ked toge|ther and|
|00003cf0| 20 77 68 65 6e 65 76 65 | 72 0a 61 6e 20 61 74 74 | wheneve|r.an att|
|00003d00| 72 69 62 75 74 65 20 28 | 6f 6e 6c 79 20 73 65 6c |ribute (|only sel|
|00003d10| 65 63 74 65 64 20 61 74 | 74 72 69 62 75 74 65 73 |ected at|tributes|
|00003d20| 2c 20 6e 6f 74 61 62 6c | 79 20 40 63 6f 64 65 7b |, notabl|y @code{|
|00003d30| 54 52 41 54 5f 56 61 6c | 75 65 7d 21 29 20 6f 66 |TRAT_Val|ue}!) of|
|00003d40| 0a 6f 6e 65 20 6f 62 6a | 65 63 74 20 63 68 61 6e |.one obj|ect chan|
|00003d50| 67 65 73 2c 20 74 68 69 | 73 20 63 68 61 6e 67 65 |ges, thi|s change|
|00003d60| 20 77 69 6c 6c 20 62 65 | 20 62 72 6f 61 64 63 61 | will be| broadca|
|00003d70| 73 74 20 74 6f 20 61 6c | 6c 20 6f 74 68 65 72 20 |st to al|l other |
|00003d80| 6f 62 6a 65 63 74 73 0a | 77 69 74 68 20 74 68 61 |objects.|with tha|
|00003d90| 74 20 49 44 20 61 73 20 | 69 66 20 79 6f 75 20 68 |t ID as |if you h|
|00003da0| 61 64 20 6e 6f 74 69 66 | 69 65 64 20 74 68 65 6d |ad notif|ied them|
|00003db0| 20 79 6f 75 72 73 65 6c | 66 20 77 69 74 68 0a 40 | yoursel|f with.@|
|00003dc0| 63 6f 64 65 7b 54 52 5f | 53 65 74 41 74 74 72 69 |code{TR_|SetAttri|
|00003dd0| 62 75 74 65 28 29 7d 2e | 20 54 68 69 73 20 69 73 |bute()}.| This is|
|00003de0| 20 70 61 72 74 69 63 75 | 6c 61 72 6c 79 20 75 73 | particu|larly us|
|00003df0| 65 66 75 6c 20 74 6f 20 | 6c 69 6e 6b 20 61 0a 43 |eful to |link a.C|
|00003e00| 68 65 63 6b 42 6f 78 20 | 67 61 64 67 65 74 20 61 |heckBox |gadget a|
|00003e10| 6e 64 20 61 20 63 68 65 | 63 6b 61 62 6c 65 20 6d |nd a che|ckable m|
|00003e20| 65 6e 75 20 69 74 65 6d | 20 74 6f 67 65 74 68 65 |enu item| togethe|
|00003e30| 72 2e 0a 0a 53 65 65 20 | 74 68 65 20 40 63 6f 64 |r...See |the @cod|
|00003e40| 65 7b 43 6f 6e 6e 65 63 | 74 69 6f 6e 73 7d 20 77 |e{Connec|tions} w|
|00003e50| 69 6e 64 6f 77 20 6f 66 | 20 74 68 65 20 54 72 69 |indow of| the Tri|
|00003e60| 74 6f 6e 20 64 65 6d 6f | 20 61 70 70 6c 69 63 61 |ton demo| applica|
|00003e70| 74 69 6f 6e 20 66 6f 72 | 20 61 0a 6d 6f 72 65 20 |tion for| a.more |
|00003e80| 64 65 74 61 69 6c 65 64 | 20 65 78 61 6d 70 6c 65 |detailed| example|
|00003e90| 20 6f 6e 20 61 74 74 72 | 69 62 75 74 65 20 62 72 | on attr|ibute br|
|00003ea0| 6f 61 64 63 61 73 74 69 | 6e 67 2e 0a 0a 40 6e 6f |oadcasti|ng...@no|
|00003eb0| 64 65 20 54 55 54 5f 4c | 41 59 2c 20 54 55 54 5f |de TUT_L|AY, TUT_|
|00003ec0| 4d 41 43 2c 20 54 55 54 | 5f 4f 42 4a 2c 20 54 6f |MAC, TUT|_OBJ, To|
|00003ed0| 70 0a 40 73 65 63 74 69 | 6f 6e 20 4c 61 79 6f 75 |p.@secti|on Layou|
|00003ee0| 74 0a 40 63 69 6e 64 65 | 78 20 4c 61 79 6f 75 74 |t.@cinde|x Layout|
|00003ef0| 0a 0a 54 72 69 74 6f 6e | 27 73 20 6c 61 79 6f 75 |..Triton|'s layou|
|00003f00| 74 20 65 6e 67 69 6e 65 | 20 69 73 20 69 6d 70 6c |t engine| is impl|
|00003f10| 65 6d 65 6e 74 65 64 20 | 74 68 72 6f 75 67 68 20 |emented |through |
|00003f20| 74 68 65 20 40 63 6f 64 | 65 7b 47 72 6f 75 70 7d |the @cod|e{Group}|
|00003f30| 0a 63 6c 61 73 73 2e 20 | 40 63 6f 64 65 7b 53 70 |.class. |@code{Sp|
|00003f40| 61 63 65 7d 20 6f 62 6a | 65 63 74 73 20 61 6c 73 |ace} obj|ects als|
|00003f50| 6f 20 70 6c 61 79 20 61 | 6e 20 69 6d 70 6f 72 74 |o play a|n import|
|00003f60| 61 6e 74 20 72 6f 6c 65 | 20 62 65 63 61 75 73 65 |ant role| because|
|00003f70| 20 28 61 70 61 72 74 0a | 66 72 6f 6d 20 61 20 66 | (apart.|from a f|
|00003f80| 65 77 20 65 78 63 65 70 | 74 69 6f 6e 73 29 20 67 |ew excep|tions) g|
|00003f90| 72 6f 75 70 73 20 64 6f | 6e 27 74 20 63 6f 6e 74 |roups do|n't cont|
|00003fa0| 61 69 6e 20 61 6e 79 20 | 27 65 6d 70 74 79 27 20 |ain any |'empty' |
|00003fb0| 73 70 61 63 65 2e 20 49 | 6e 73 74 65 61 64 0a 74 |space. I|nstead.t|
|00003fc0| 68 69 73 20 73 70 61 63 | 65 20 69 73 20 63 6f 76 |his spac|e is cov|
|00003fd0| 65 72 65 64 20 62 79 20 | 69 6e 73 74 61 6e 63 65 |ered by |instance|
|00003fe0| 73 20 6f 66 20 63 6c 61 | 73 73 20 40 63 6f 64 65 |s of cla|ss @code|
|00003ff0| 7b 53 70 61 63 65 7d 2e | 20 53 65 65 20 74 68 65 |{Space}.| See the|
|00004000| 0a 65 78 61 6d 70 6c 65 | 20 62 65 6c 6f 77 20 66 |.example| below f|
|00004010| 6f 72 20 64 65 74 61 69 | 6c 73 20 61 62 6f 75 74 |or detai|ls about|
|00004020| 20 73 70 61 63 65 73 2e | 0a 0a 40 63 6f 64 65 7b | spaces.|..@code{|
|00004030| 47 72 6f 75 70 7d 20 6f | 62 6a 65 63 74 73 20 63 |Group} o|bjects c|
|00004040| 61 6e 20 63 72 65 61 74 | 65 20 62 6f 74 68 20 76 |an creat|e both v|
|00004050| 65 72 74 69 63 61 6c 20 | 61 6e 64 20 68 6f 72 69 |ertical |and hori|
|00004060| 7a 6f 6e 74 61 6c 20 67 | 72 6f 75 70 73 2c 0a 64 |zontal g|roups,.d|
|00004070| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 77 68 65 74 |epending| on whet|
|00004080| 68 65 72 20 74 68 65 79 | 20 61 72 65 20 63 72 65 |her they| are cre|
|00004090| 61 74 65 64 20 77 69 74 | 68 20 40 63 6f 64 65 7b |ated wit|h @code{|
|000040a0| 54 52 47 52 5f 56 65 72 | 74 7d 20 6f 72 0a 40 63 |TRGR_Ver|t} or.@c|
|000040b0| 6f 64 65 7b 54 52 47 52 | 5f 48 6f 72 69 7a 7d 2e |ode{TRGR|_Horiz}.|
|000040c0| 0a 0a 46 6f 75 72 20 64 | 69 66 66 65 72 65 6e 74 |..Four d|ifferent|
|000040d0| 20 6c 61 79 6f 75 74 20 | 74 79 70 65 73 20 61 72 | layout |types ar|
|000040e0| 65 20 61 76 61 69 6c 61 | 62 6c 65 20 66 6f 72 20 |e availa|ble for |
|000040f0| 65 61 63 68 20 69 6e 73 | 74 61 6e 63 65 0a 6f 66 |each ins|tance.of|
|00004100| 20 40 63 6f 64 65 7b 47 | 72 6f 75 70 7d 20 28 61 | @code{G|roup} (a|
|00004110| 64 6a 75 73 74 61 62 6c | 65 20 77 69 74 68 20 74 |djustabl|e with t|
|00004120| 68 65 20 67 72 6f 75 70 | 20 66 6c 61 67 73 29 2e |he group| flags).|
|00004130| 20 54 68 65 79 20 61 66 | 66 65 63 74 0a 74 68 65 | They af|fect.the|
|00004140| 20 70 72 69 6d 61 72 79 | 20 64 69 72 65 63 74 69 | primary| directi|
|00004150| 6f 6e 20 6f 6e 6c 79 3a | 0a 0a 40 65 6e 75 6d 65 |on only:|..@enume|
|00004160| 72 61 74 65 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |rate.@it|em.@code|
|00004170| 7b 54 52 47 52 5f 50 52 | 4f 50 53 48 41 52 45 7d |{TRGR_PR|OPSHARE}|
|00004180| 3a 20 45 78 70 61 6e 64 | 73 20 61 6c 6c 20 6f 62 |: Expand|s all ob|
|00004190| 6a 65 63 74 73 20 70 72 | 6f 70 6f 72 74 69 6f 6e |jects pr|oportion|
|000041a0| 61 6c 6c 79 20 74 6f 20 | 74 68 65 69 72 0a 6d 69 |ally to |their.mi|
|000041b0| 6e 69 6d 75 6d 20 73 69 | 7a 65 2e 20 41 6c 6c 20 |nimum si|ze. All |
|000041c0| 73 70 61 63 65 73 20 72 | 65 74 61 69 6e 20 74 68 |spaces r|etain th|
|000041d0| 65 69 72 20 6d 69 6e 69 | 6d 75 6d 20 73 69 7a 65 |eir mini|mum size|
|000041e0| 20 61 6e 64 20 61 72 65 | 20 6e 6f 74 20 72 65 73 | and are| not res|
|000041f0| 69 7a 61 62 6c 65 2e 0a | 4e 6f 6e 2d 72 65 73 69 |izable..|Non-resi|
|00004200| 7a 61 62 6c 65 20 6e 6f | 6e 2d 73 70 61 63 65 20 |zable no|n-space |
|00004210| 6f 62 6a 65 63 74 73 20 | 64 6f 20 61 6c 73 6f 20 |objects |do also |
|00004220| 72 65 74 61 69 6e 20 74 | 68 65 69 72 20 6d 69 6e |retain t|heir min|
|00004230| 69 6d 75 6d 20 73 69 7a | 65 73 0a 28 77 65 6c 6c |imum siz|es.(well|
|00004240| 2c 20 74 68 65 79 20 64 | 6f 6e 27 74 20 72 65 61 |, they d|on't rea|
|00004250| 6c 6c 79 20 68 61 76 65 | 20 61 20 63 68 6f 69 63 |lly have| a choic|
|00004260| 65 2c 20 64 6f 20 74 68 | 65 79 3f 20 3b 29 2e 0a |e, do th|ey? ;)..|
|00004270| 40 69 74 65 6d 0a 40 63 | 6f 64 65 7b 54 52 47 52 |@item.@c|ode{TRGR|
|00004280| 5f 45 51 55 41 4c 53 48 | 41 52 45 7d 3a 20 53 61 |_EQUALSH|ARE}: Sa|
|00004290| 6d 65 20 61 73 20 40 63 | 6f 64 65 7b 54 52 47 52 |me as @c|ode{TRGR|
|000042a0| 5f 50 52 4f 50 53 48 41 | 52 45 7d 20 65 78 63 65 |_PROPSHA|RE} exce|
|000042b0| 70 74 20 74 68 61 74 20 | 61 6c 6c 20 6e 6f 6e 2d |pt that |all non-|
|000042c0| 73 70 61 63 65 0a 6f 62 | 6a 65 63 74 73 20 68 61 |space.ob|jects ha|
|000042d0| 76 65 20 74 68 65 20 73 | 61 6d 65 20 73 69 7a 65 |ve the s|ame size|
|000042e0| 2e 20 54 68 65 69 72 20 | 6d 69 6e 69 6d 75 6d 20 |. Their |minimum |
|000042f0| 73 69 7a 65 20 65 71 75 | 61 6c 73 20 74 68 65 20 |size equ|als the |
|00004300| 62 69 67 67 65 73 74 20 | 6d 69 6e 69 6d 75 6d 20 |biggest |minimum |
|00004310| 73 69 7a 65 0a 6f 66 20 | 74 68 65 20 69 6e 64 69 |size.of |the indi|
|00004320| 76 69 64 75 61 6c 20 6f | 62 6a 65 63 74 73 2e 0a |vidual o|bjects..|
|00004330| 40 69 74 65 6d 0a 40 63 | 6f 64 65 7b 54 52 47 52 |@item.@c|ode{TRGR|
|00004340| 5f 50 52 4f 50 53 50 41 | 43 45 53 7d 3a 20 41 6c |_PROPSPA|CES}: Al|
|00004350| 6c 20 6e 6f 6e 2d 73 70 | 61 63 65 20 6f 62 6a 65 |l non-sp|ace obje|
|00004360| 63 74 73 20 72 65 74 61 | 69 6e 20 74 68 65 69 72 |cts reta|in their|
|00004370| 20 6d 69 6e 69 6d 75 6d | 20 73 69 7a 65 73 20 61 | minimum| sizes a|
|00004380| 6c 6c 0a 74 68 65 20 74 | 69 6d 65 20 61 6e 64 20 |ll.the t|ime and |
|00004390| 64 6f 20 6e 6f 74 20 67 | 65 74 20 73 74 72 65 74 |do not g|et stret|
|000043a0| 63 68 65 64 2e 20 49 6e | 73 74 65 61 64 20 74 68 |ched. In|stead th|
|000043b0| 65 20 73 70 61 63 65 73 | 20 61 72 65 20 73 74 72 |e spaces| are str|
|000043c0| 65 74 63 68 65 64 0a 70 | 72 6f 70 6f 72 74 69 6f |etched.p|roportio|
|000043d0| 6e 61 6c 6c 79 20 74 6f | 20 74 68 65 69 72 20 6d |nally to| their m|
|000043e0| 69 6e 69 6d 75 6d 20 73 | 69 7a 65 73 2e 0a 40 69 |inimum s|izes..@i|
|000043f0| 74 65 6d 0a 40 63 6f 64 | 65 7b 54 52 47 52 5f 41 |tem.@cod|e{TRGR_A|
|00004400| 52 52 41 59 7d 3a 20 54 | 68 69 73 20 67 72 6f 75 |RRAY}: T|his grou|
|00004410| 70 20 62 75 69 6c 64 73 | 20 74 68 65 20 74 6f 70 |p builds| the top|
|00004420| 20 67 72 6f 75 70 20 6f | 66 20 61 6e 20 61 72 72 | group o|f an arr|
|00004430| 61 79 2e 20 49 6e 20 6f | 72 64 65 72 0a 74 6f 20 |ay. In o|rder.to |
|00004440| 63 72 65 61 74 65 20 61 | 6e 20 61 72 72 61 79 2c |create a|n array,|
|00004450| 20 79 6f 75 20 68 61 76 | 65 20 74 6f 20 73 65 74 | you hav|e to set|
|00004460| 20 75 70 20 61 6e 20 6f | 75 74 65 72 20 40 63 6f | up an o|uter @co|
|00004470| 64 65 7b 54 52 47 52 5f | 41 52 52 41 59 7d 20 67 |de{TRGR_|ARRAY} g|
|00004480| 72 6f 75 70 0a 28 68 6f | 72 69 7a 6f 6e 74 61 6c |roup.(ho|rizontal|
|00004490| 20 66 6f 72 20 61 20 63 | 6f 6c 75 6d 6e 20 61 72 | for a c|olumn ar|
|000044a0| 72 61 79 2c 20 76 65 72 | 74 69 63 61 6c 20 66 6f |ray, ver|tical fo|
|000044b0| 72 20 61 20 6c 69 6e 65 | 20 61 72 72 61 79 29 20 |r a line| array) |
|000044c0| 61 6e 64 20 66 69 6c 6c | 20 69 74 0a 77 69 74 68 |and fill| it.with|
|000044d0| 20 73 69 6e 67 6c 65 20 | 6f 62 6a 65 63 74 73 20 | single |objects |
|000044e0| 28 6e 6f 74 61 62 6c 79 | 20 73 70 61 63 65 73 29 |(notably| spaces)|
|000044f0| 20 6f 72 20 40 63 6f 64 | 65 7b 54 52 47 52 5f 50 | or @cod|e{TRGR_P|
|00004500| 52 4f 50 53 48 41 52 45 | 7d 20 67 72 6f 75 70 73 |ROPSHARE|} groups|
|00004510| 20 69 6e 0a 74 68 65 20 | 6f 70 70 6f 73 69 74 65 | in.the |opposite|
|00004520| 20 64 69 72 65 63 74 69 | 6f 6e 2e 20 41 6c 6c 20 | directi|on. All |
|00004530| 65 6c 65 6d 65 6e 74 73 | 20 6f 66 20 74 68 65 20 |elements| of the |
|00004540| 69 6e 6e 65 72 20 67 72 | 6f 75 70 73 20 77 69 6c |inner gr|oups wil|
|00004550| 6c 20 62 65 20 61 6c 69 | 67 6e 65 64 0a 74 6f 20 |l be ali|gned.to |
|00004560| 62 75 69 6c 64 20 61 6e | 20 61 72 72 61 79 2e 20 |build an| array. |
|00004570| 49 6e 6e 65 72 20 67 72 | 6f 75 70 73 20 77 68 69 |Inner gr|oups whi|
|00004580| 63 68 20 68 61 76 65 20 | 74 68 65 20 66 6c 61 67 |ch have |the flag|
|00004590| 20 40 63 6f 64 65 7b 54 | 52 47 52 5f 49 4e 44 45 | @code{T|RGR_INDE|
|000045a0| 50 7d 20 73 65 74 0a 77 | 69 6c 6c 20 6e 6f 74 20 |P} set.w|ill not |
|000045b0| 62 65 20 61 6c 69 67 6e | 65 64 2e 20 54 68 69 73 |be align|ed. This|
|000045c0| 20 66 6c 61 67 20 69 73 | 20 6d 61 69 6e 6c 79 20 | flag is| mainly |
|000045d0| 75 73 65 64 20 74 6f 20 | 69 6e 73 65 72 74 20 6e |used to |insert n|
|000045e0| 61 6d 65 64 20 73 65 70 | 61 72 61 74 6f 72 20 62 |amed sep|arator b|
|000045f0| 61 72 73 0a 28 63 72 65 | 61 74 65 64 20 77 69 74 |ars.(cre|ated wit|
|00004600| 68 20 40 63 6f 64 65 7b | 54 52 4f 42 5f 4c 69 6e |h @code{|TROB_Lin|
|00004610| 65 7d 20 61 6e 64 20 40 | 63 6f 64 65 7b 54 52 4f |e} and @|code{TRO|
|00004620| 42 5f 54 65 78 74 7d 29 | 20 69 6e 74 6f 20 61 6e |B_Text})| into an|
|00004630| 20 61 72 72 61 79 2e 0a | 40 65 6e 64 20 65 6e 75 | array..|@end enu|
|00004640| 6d 65 72 61 74 65 0a 0a | 43 75 72 72 65 6e 74 6c |merate..|Currentl|
|00004650| 79 20 74 68 65 20 6f 6e | 6c 79 20 6f 62 6a 65 63 |y the on|ly objec|
|00004660| 74 73 20 77 68 69 63 68 | 20 61 72 65 20 74 72 65 |ts which| are tre|
|00004670| 61 74 65 64 20 61 73 20 | 73 70 61 63 65 73 20 69 |ated as |spaces i|
|00004680| 6e 20 74 68 65 20 61 62 | 6f 76 65 20 73 63 68 65 |n the ab|ove sche|
|00004690| 6d 65 0a 61 72 65 20 69 | 6e 73 74 61 6e 63 65 73 |me.are i|nstances|
|000046a0| 20 6f 66 20 63 6c 61 73 | 73 20 40 63 6f 64 65 7b | of clas|s @code{|
|000046b0| 53 70 61 63 65 7d 2e 0a | 0a 54 68 65 20 62 65 68 |Space}..|.The beh|
|000046c0| 61 76 69 6f 75 72 20 6f | 66 20 74 68 65 20 67 72 |aviour o|f the gr|
|000046d0| 6f 75 70 20 69 6e 20 69 | 74 73 20 73 65 63 6f 6e |oup in i|ts secon|
|000046e0| 64 61 72 79 20 64 69 72 | 65 63 74 69 6f 6e 20 63 |dary dir|ection c|
|000046f0| 61 6e 20 62 65 20 63 68 | 61 6e 67 65 64 2c 20 74 |an be ch|anged, t|
|00004700| 6f 6f 2e 0a 54 77 6f 20 | 61 64 64 69 74 69 6f 6e |oo..Two |addition|
|00004710| 61 6c 20 66 6c 61 67 73 | 20 61 72 65 20 61 76 61 |al flags| are ava|
|00004720| 69 6c 61 62 6c 65 20 66 | 6f 72 20 74 68 61 74 20 |ilable f|or that |
|00004730| 70 75 72 70 6f 73 65 2e | 20 49 6e 20 6d 6f 73 74 |purpose.| In most|
|00004740| 20 63 61 73 65 73 20 79 | 6f 75 20 6d 61 79 0a 77 | cases y|ou may.w|
|00004750| 61 6e 74 20 74 6f 20 73 | 65 74 20 62 6f 74 68 20 |ant to s|et both |
|00004760| 6f 66 20 74 68 65 6d 3a | 0a 0a 40 65 6e 75 6d 65 |of them:|..@enume|
|00004770| 72 61 74 65 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |rate.@it|em.@code|
|00004780| 7b 54 52 47 52 5f 41 4c | 49 47 4e 7d 3a 20 41 6c |{TRGR_AL|IGN}: Al|
|00004790| 6c 20 72 65 73 69 7a 61 | 62 6c 65 20 6f 62 6a 65 |l resiza|ble obje|
|000047a0| 63 74 73 20 28 69 2e 65 | 2e 20 72 65 73 69 7a 61 |cts (i.e|. resiza|
|000047b0| 62 6c 65 20 69 6e 20 74 | 68 65 20 73 65 63 6f 6e |ble in t|he secon|
|000047c0| 64 61 72 79 0a 64 69 6d | 65 6e 73 69 6f 6e 20 6f |dary.dim|ension o|
|000047d0| 66 20 74 68 65 20 67 72 | 6f 75 70 29 20 61 72 65 |f the gr|oup) are|
|000047e0| 20 73 74 72 65 63 68 74 | 65 64 20 74 6f 20 66 69 | strecht|ed to fi|
|000047f0| 74 20 74 68 65 20 66 75 | 6c 6c 20 73 70 61 63 65 |t the fu|ll space|
|00004800| 20 6f 63 63 75 70 69 65 | 64 20 62 79 0a 74 68 65 | occupie|d by.the|
|00004810| 20 67 72 6f 75 70 2e 0a | 40 69 74 65 6d 0a 40 63 | group..|@item.@c|
|00004820| 6f 64 65 7b 54 52 47 52 | 5f 43 45 4e 54 45 52 7d |ode{TRGR|_CENTER}|
|00004830| 3a 20 41 6c 6c 20 6e 6f | 6e 2d 72 65 73 69 7a 61 |: All no|n-resiza|
|00004840| 62 6c 65 20 6f 62 6a 65 | 63 74 73 20 61 72 65 20 |ble obje|cts are |
|00004850| 63 65 6e 74 65 72 65 64 | 20 69 6e 20 74 68 65 20 |centered| in the |
|00004860| 67 72 6f 75 70 2e 0a 57 | 69 74 68 6f 75 74 20 74 |group..W|ithout t|
|00004870| 68 69 73 20 66 6c 61 67 | 20 74 68 65 79 20 67 65 |his flag| they ge|
|00004880| 74 20 61 6c 69 67 6e 65 | 64 20 74 6f 20 74 68 65 |t aligne|d to the|
|00004890| 20 6c 65 66 74 20 6f 72 | 20 74 6f 70 20 62 6f 72 | left or| top bor|
|000048a0| 64 65 72 2e 0a 40 65 6e | 64 20 65 6e 75 6d 65 72 |der..@en|d enumer|
|000048b0| 61 74 65 0a 0a 49 74 20 | 69 73 20 61 6c 73 6f 20 |ate..It |is also |
|000048c0| 70 6f 73 73 69 62 6c 65 | 20 74 6f 20 6b 65 65 70 |possible| to keep|
|000048d0| 20 61 20 67 72 6f 75 70 | 20 61 74 20 69 74 73 20 | a group| at its |
|000048e0| 6d 69 6e 69 6d 75 6d 20 | 73 69 7a 65 20 61 6e 64 |minimum |size and|
|000048f0| 20 6e 6f 77 20 61 6c 6c | 6f 77 0a 69 74 20 74 6f | now all|ow.it to|
|00004900| 20 62 65 20 73 74 72 65 | 74 63 68 65 64 20 69 6e | be stre|tched in|
|00004910| 20 65 69 74 68 65 72 20 | 6f 72 20 62 6f 74 68 20 | either |or both |
|00004920| 64 69 72 65 63 74 69 6f | 6e 73 2e 20 54 68 69 73 |directio|ns. This|
|00004930| 20 63 61 6e 20 62 65 20 | 61 63 63 6f 6d 70 6c 69 | can be |accompli|
|00004940| 73 68 65 64 0a 77 69 74 | 68 20 74 68 65 20 40 63 |shed.wit|h the @c|
|00004950| 6f 64 65 7b 54 52 47 52 | 5f 46 49 58 48 4f 52 49 |ode{TRGR|_FIXHORI|
|00004960| 5a 7d 20 61 6e 64 20 40 | 63 6f 64 65 7b 54 52 47 |Z} and @|code{TRG|
|00004970| 52 5f 46 49 58 56 45 52 | 54 7d 20 66 6c 61 67 73 |R_FIXVER|T} flags|
|00004980| 2e 0a 0a 41 20 67 72 6f | 75 70 20 63 61 6e 20 62 |...A gro|up can b|
|00004990| 65 20 63 72 65 61 74 65 | 64 20 6c 69 6b 65 20 61 |e create|d like a|
|000049a0| 6e 79 20 6f 74 68 65 72 | 20 6f 62 6a 65 63 74 2e |ny other| object.|
|000049b0| 20 49 74 20 74 61 6b 65 | 73 20 6f 74 68 65 72 20 | It take|s other |
|000049c0| 6f 62 6a 65 63 74 73 0a | 61 73 20 69 74 73 20 61 |objects.|as its a|
|000049d0| 72 67 75 6d 65 6e 74 73 | 2e 20 45 76 65 72 79 20 |rguments|. Every |
|000049e0| 67 72 6f 75 70 20 68 61 | 73 20 74 6f 20 62 65 20 |group ha|s to be |
|000049f0| 74 65 72 6d 69 6e 61 74 | 65 64 20 77 69 74 68 20 |terminat|ed with |
|00004a00| 61 20 40 63 6f 64 65 7b | 54 52 47 52 5f 45 6e 64 |a @code{|TRGR_End|
|00004a10| 7d 0a 74 61 67 2e 20 41 | 20 74 79 70 69 63 61 6c |}.tag. A| typical|
|00004a20| 20 68 6f 72 69 7a 6f 6e | 74 61 6c 20 67 72 6f 75 | horizon|tal grou|
|00004a30| 70 2c 20 77 68 69 63 68 | 20 63 6f 6e 74 61 69 6e |p, which| contain|
|00004a40| 73 20 61 20 43 68 65 63 | 6b 42 6f 78 2c 20 61 20 |s a Chec|kBox, a |
|00004a50| 73 70 61 63 65 20 61 6e | 64 0a 61 67 61 69 6e 20 |space an|d.again |
|00004a60| 61 20 43 68 65 63 6b 42 | 6f 78 2c 20 77 6f 75 6c |a CheckB|ox, woul|
|00004a70| 64 20 6c 6f 6f 6b 20 6c | 69 6b 65 20 74 68 69 73 |d look l|ike this|
|00004a80| 3a 0a 0a 40 65 78 61 6d | 70 6c 65 0a 20 20 20 20 |:..@exam|ple. |
|00004a90| 54 52 47 52 5f 48 6f 72 | 69 7a 2c 20 20 20 20 20 |TRGR_Hor|iz, |
|00004aa0| 20 54 52 47 52 5f 50 52 | 4f 50 53 48 41 52 45 7c | TRGR_PR|OPSHARE||
|00004ab0| 54 52 47 52 5f 41 4c 49 | 47 4e 7c 54 52 47 52 5f |TRGR_ALI|GN|TRGR_|
|00004ac0| 43 45 4e 54 45 52 2c 0a | 0a 20 20 20 20 20 20 54 |CENTER,.|. T|
|00004ad0| 52 4f 42 5f 43 68 65 63 | 6b 42 6f 78 2c 20 30 2c |ROB_Chec|kBox, 0,|
|00004ae0| 0a 20 20 20 20 20 20 20 | 20 54 52 41 54 5f 49 44 |. | TRAT_ID|
|00004af0| 2c 20 20 20 20 20 31 2c | 0a 0a 20 20 20 20 20 20 |, 1,|.. |
|00004b00| 54 52 4f 42 5f 53 70 61 | 63 65 2c 20 20 20 20 54 |TROB_Spa|ce, T|
|00004b10| 52 53 54 5f 4e 4f 52 4d | 41 4c 2c 0a 0a 20 20 20 |RST_NORM|AL,.. |
|00004b20| 20 20 20 54 52 4f 42 5f | 43 68 65 63 6b 42 6f 78 | TROB_|CheckBox|
|00004b30| 2c 20 30 2c 0a 20 20 20 | 20 20 20 20 20 54 52 41 |, 0,. | TRA|
|00004b40| 54 5f 56 61 6c 75 65 2c | 20 20 54 52 55 45 2c 0a |T_Value,| TRUE,.|
|00004b50| 20 20 20 20 20 20 20 20 | 54 52 41 54 5f 49 44 2c | |TRAT_ID,|
|00004b60| 20 20 20 20 20 32 2c 0a | 0a 20 20 20 20 20 20 54 | 2,.|. T|
|00004b70| 52 47 52 5f 45 6e 64 2c | 20 20 20 20 20 20 30 0a |RGR_End,| 0.|
|00004b80| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 0a 53 65 |@end exa|mple..Se|
|00004b90| 65 20 74 68 65 20 40 63 | 6f 64 65 7b 47 72 6f 75 |e the @c|ode{Grou|
|00004ba0| 70 73 7d 20 77 69 6e 64 | 6f 77 20 6f 66 20 74 68 |ps} wind|ow of th|
|00004bb0| 65 20 54 72 69 74 6f 6e | 20 64 65 6d 6f 20 61 70 |e Triton| demo ap|
|00004bc0| 70 6c 69 63 61 74 69 6f | 6e 20 66 6f 72 20 61 0a |plicatio|n for a.|
|00004bd0| 6d 6f 72 65 20 64 65 74 | 61 69 6c 65 64 20 65 78 |more det|ailed ex|
|00004be0| 61 6d 70 6c 65 20 6f 6e | 20 67 72 6f 75 70 73 20 |ample on| groups |
|00004bf0| 61 6e 64 20 61 72 72 61 | 79 73 2e 0a 0a 40 6e 6f |and arra|ys...@no|
|00004c00| 64 65 20 54 55 54 5f 4d | 41 43 2c 20 54 55 54 5f |de TUT_M|AC, TUT_|
|00004c10| 50 4f 4c 2c 20 54 55 54 | 5f 4c 41 59 2c 20 54 6f |POL, TUT|_LAY, To|
|00004c20| 70 0a 40 73 65 63 74 69 | 6f 6e 20 4d 61 63 72 6f |p.@secti|on Macro|
|00004c30| 73 0a 40 63 69 6e 64 65 | 78 20 4d 61 63 72 6f 73 |s.@cinde|x Macros|
|00004c40| 0a 0a 54 68 65 20 43 20 | 68 65 61 64 65 72 20 66 |..The C |header f|
|00004c50| 69 6c 65 20 40 66 69 6c | 65 7b 44 65 76 65 6c 6f |ile @fil|e{Develo|
|00004c60| 70 65 72 2f 49 6e 63 6c | 75 64 65 2f 6c 69 62 72 |per/Incl|ude/libr|
|00004c70| 61 72 69 65 73 2f 74 72 | 69 74 6f 6e 2e 68 7d 20 |aries/tr|iton.h} |
|00004c80| 63 6f 6e 74 61 69 6e 73 | 0a 6d 61 6e 79 20 6d 61 |contains|.many ma|
|00004c90| 63 72 6f 20 64 65 66 69 | 6e 69 74 69 6f 6e 73 20 |cro defi|nitions |
|00004ca0| 77 68 69 63 68 20 6d 61 | 6b 65 20 63 72 65 61 74 |which ma|ke creat|
|00004cb0| 69 6e 67 20 61 20 54 72 | 69 74 6f 6e 20 47 55 49 |ing a Tr|iton GUI|
|00004cc0| 20 6d 75 63 68 0a 65 61 | 73 69 65 72 2e 20 57 69 | much.ea|sier. Wi|
|00004cd0| 74 68 20 74 68 65 20 68 | 65 6c 70 20 6f 66 20 74 |th the h|elp of t|
|00004ce0| 68 65 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 |he prepr|ocessor |
|00004cf0| 40 63 6f 64 65 7b 4d 61 | 63 32 45 7d 2c 20 74 68 |@code{Ma|c2E}, th|
|00004d00| 65 73 65 20 6d 61 63 72 | 6f 73 0a 61 72 65 20 61 |ese macr|os.are a|
|00004d10| 6c 73 6f 20 61 76 61 69 | 6c 61 62 6c 65 20 69 6e |lso avai|lable in|
|00004d20| 20 40 63 6f 64 65 7b 41 | 6d 69 67 61 45 7d 2e 20 | @code{A|migaE}. |
|00004d30| 4f 74 68 65 72 20 6c 61 | 6e 67 75 61 67 65 73 20 |Other la|nguages |
|00004d40| 6f 72 20 63 6f 6d 70 69 | 6c 65 72 73 20 6d 61 79 |or compi|lers may|
|00004d50| 0a 73 75 70 70 6f 72 74 | 20 73 69 6d 69 6c 61 72 |.support| similar|
|00004d60| 20 6f 72 20 64 69 66 66 | 65 72 65 6e 74 20 6d 61 | or diff|erent ma|
|00004d70| 63 72 6f 73 20 6f 72 20 | 6e 6f 6e 65 20 61 74 20 |cros or |none at |
|00004d80| 61 6c 6c 2e 20 49 66 20 | 6e 6f 20 6d 61 63 72 6f |all. If |no macro|
|00004d90| 73 20 61 72 65 0a 61 76 | 61 69 6c 61 62 6c 65 20 |s are.av|ailable |
|00004da0| 69 6e 20 79 6f 75 72 20 | 64 65 76 65 6c 6f 70 6d |in your |developm|
|00004db0| 65 6e 74 20 73 79 73 74 | 65 6d 2c 20 79 6f 75 20 |ent syst|em, you |
|00004dc0| 68 61 76 65 20 74 6f 20 | 64 6f 20 69 74 20 74 68 |have to |do it th|
|00004dd0| 65 20 74 72 61 64 69 74 | 69 6f 6e 61 6c 0a 77 61 |e tradit|ional.wa|
|00004de0| 79 2e 20 49 66 20 79 6f | 75 20 63 61 6e 20 75 73 |y. If yo|u can us|
|00004df0| 65 20 6d 61 63 72 6f 73 | 2c 20 75 73 65 20 74 68 |e macros|, use th|
|00004e00| 65 6d 2e 0a 0a 54 68 65 | 20 73 74 61 74 69 63 20 |em...The| static |
|00004e10| 74 61 67 6c 69 73 74 20 | 64 65 66 69 6e 69 74 69 |taglist |definiti|
|00004e20| 6f 6e 20 63 61 6e 20 62 | 65 20 77 72 69 74 74 65 |on can b|e writte|
|00004e30| 6e 20 61 20 62 69 74 20 | 73 69 6d 70 6c 65 72 20 |n a bit |simpler |
|00004e40| 77 69 74 68 20 6d 61 63 | 72 6f 73 3a 0a 0a 40 65 |with mac|ros:..@e|
|00004e50| 78 61 6d 70 6c 65 0a 20 | 20 20 20 50 72 6f 6a 65 |xample. | Proje|
|00004e60| 63 74 44 65 66 69 6e 69 | 74 69 6f 6e 28 64 75 6d |ctDefini|tion(dum|
|00004e70| 6d 79 54 61 67 73 29 0a | 20 20 20 20 40 7b 0a 20 |myTags).| @{. |
|00004e80| 20 20 20 20 20 2f 2a 20 | 49 6e 73 65 72 74 20 70 | /* |Insert p|
|00004e90| 72 6f 6a 65 63 74 20 74 | 61 67 73 20 68 65 72 65 |roject t|ags here|
|00004ea0| 20 2a 2f 0a 20 20 20 20 | 40 7d 3b 0a 40 65 6e 64 | */. |@};.@end|
|00004eb0| 20 65 78 61 6d 70 6c 65 | 0a 0a 42 75 74 20 74 68 | example|..But th|
|00004ec0| 65 20 6d 61 69 6e 20 75 | 73 65 20 66 6f 72 20 6d |e main u|se for m|
|00004ed0| 61 63 72 6f 73 20 61 72 | 65 20 74 68 65 20 74 61 |acros ar|e the ta|
|00004ee0| 67 73 20 74 68 65 6d 73 | 65 6c 76 65 73 2e 20 46 |gs thems|elves. F|
|00004ef0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 74 68 65 20 |or examp|le, the |
|00004f00| 74 61 67 73 0a 66 72 6f | 6d 20 74 68 65 20 64 75 |tags.fro|m the du|
|00004f10| 6d 6d 79 20 77 69 6e 64 | 6f 77 20 65 78 61 6d 70 |mmy wind|ow examp|
|00004f20| 6c 65 20 28 73 65 65 20 | 40 72 65 66 7b 54 55 54 |le (see |@ref{TUT|
|00004f30| 5f 50 52 4f 2c 20 50 72 | 6f 6a 65 63 74 73 2c 20 |_PRO, Pr|ojects, |
|00004f40| 54 75 74 6f 72 69 61 6c | 20 2d 20 50 72 6f 6a 65 |Tutorial| - Proje|
|00004f50| 63 74 73 7d 29 0a 77 6f | 75 6c 64 20 6c 6f 6f 6b |cts}).wo|uld look|
|00004f60| 20 6c 69 6b 65 20 74 68 | 69 73 3a 0a 0a 40 65 78 | like th|is:..@ex|
|00004f70| 61 6d 70 6c 65 0a 20 20 | 20 20 20 20 57 69 6e 64 |ample. | Wind|
|00004f80| 6f 77 54 69 74 6c 65 28 | 22 41 20 64 75 6d 6d 79 |owTitle(|"A dummy|
|00004f90| 20 77 69 6e 64 6f 77 22 | 29 2c 0a 20 20 20 20 20 | window"|),. |
|00004fa0| 20 57 69 6e 64 6f 77 49 | 44 28 34 32 29 2c 0a 20 | WindowI|D(42),. |
|00004fb0| 20 20 20 20 20 45 6e 64 | 50 72 6f 6a 65 63 74 0a | End|Project.|
|00004fc0| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 0a 48 61 |@end exa|mple..Ha|
|00004fd0| 76 65 20 61 20 6c 6f 6f | 6b 20 61 74 20 74 68 65 |ve a loo|k at the|
|00004fe0| 20 6d 61 63 72 6f 20 64 | 65 66 69 6e 69 74 69 6f | macro d|efinitio|
|00004ff0| 6e 73 20 61 6e 64 20 74 | 68 65 20 73 75 70 70 6c |ns and t|he suppl|
|00005000| 69 65 64 20 64 65 6d 6f | 20 61 70 70 6c 69 63 61 |ied demo| applica|
|00005010| 74 69 6f 6e 73 0a 66 6f | 72 20 6d 6f 72 65 20 64 |tions.fo|r more d|
|00005020| 65 74 61 69 6c 65 64 20 | 69 6e 66 6f 72 6d 61 74 |etailed |informat|
|00005030| 69 6f 6e 20 61 62 6f 75 | 74 20 74 68 65 20 6d 61 |ion abou|t the ma|
|00005040| 63 72 6f 73 2e 0a 0a 40 | 6e 6f 64 65 20 54 55 54 |cros...@|node TUT|
|00005050| 5f 50 4f 4c 2c 20 54 55 | 54 5f 4d 45 53 2c 20 54 |_POL, TU|T_MES, T|
|00005060| 55 54 5f 4d 41 43 2c 20 | 54 6f 70 0a 40 73 65 63 |UT_MAC, |Top.@sec|
|00005070| 74 69 6f 6e 20 50 6f 6c | 6c 69 6e 67 20 4c 6f 6f |tion Pol|ling Loo|
|00005080| 70 0a 40 63 69 6e 64 65 | 78 20 50 6f 6c 6c 69 6e |p.@cinde|x Pollin|
|00005090| 67 20 4c 6f 6f 70 0a 40 | 63 69 6e 64 65 78 20 4c |g Loop.@|cindex L|
|000050a0| 6f 6f 70 2c 20 50 6f 6c | 6c 69 6e 67 0a 0a 41 66 |oop, Pol|ling..Af|
|000050b0| 74 65 72 20 63 72 65 61 | 74 69 6e 67 20 61 20 47 |ter crea|ting a G|
|000050c0| 55 49 20 79 6f 75 20 68 | 61 76 65 20 74 6f 20 68 |UI you h|ave to h|
|000050d0| 61 6e 64 6c 65 20 75 73 | 65 72 20 69 6e 70 75 74 |andle us|er input|
|000050e0| 2e 20 49 6e 20 6f 72 64 | 65 72 20 74 6f 20 61 63 |. In ord|er to ac|
|000050f0| 63 6f 6d 70 6c 69 73 68 | 0a 74 68 69 73 20 74 61 |complish|.this ta|
|00005100| 73 6b 2c 20 54 72 69 74 | 6f 6e 20 6f 66 66 65 72 |sk, Trit|on offer|
|00005110| 73 20 61 20 70 6f 6c 6c | 69 6e 67 20 73 79 73 74 |s a poll|ing syst|
|00005120| 65 6d 20 77 68 69 63 68 | 20 72 65 73 65 6d 62 6c |em which| resembl|
|00005130| 65 73 20 74 68 65 20 49 | 6e 74 75 69 74 69 6f 6e |es the I|ntuition|
|00005140| 0a 49 44 43 4d 50 20 70 | 6f 6c 6c 69 6e 67 20 73 |.IDCMP p|olling s|
|00005150| 79 73 74 65 6d 2e 20 41 | 20 62 61 73 69 63 20 70 |ystem. A| basic p|
|00005160| 6f 6c 6c 69 6e 67 20 6c | 6f 6f 70 20 6c 6f 6f 6b |olling l|oop look|
|00005170| 73 20 6c 69 6b 65 20 74 | 68 69 73 3a 0a 0a 40 65 |s like t|his:..@e|
|00005180| 78 61 6d 70 6c 65 0a 20 | 20 20 20 76 6f 69 64 20 |xample. | void |
|00005190| 68 61 6e 64 6c 65 44 75 | 6d 6d 79 57 69 6e 64 6f |handleDu|mmyWindo|
|000051a0| 77 28 76 6f 69 64 29 0a | 20 20 20 20 40 7b 0a 20 |w(void).| @{. |
|000051b0| 20 20 20 20 20 42 4f 4f | 4c 20 63 6c 6f 73 65 4d | BOO|L closeM|
|000051c0| 65 3d 46 41 4c 53 45 3b | 0a 20 20 20 20 20 20 73 |e=FALSE;|. s|
|000051d0| 74 72 75 63 74 20 54 52 | 5f 4d 65 73 73 61 67 65 |truct TR|_Message|
|000051e0| 20 2a 74 72 4d 73 67 3b | 0a 0a 20 20 20 20 20 20 | *trMsg;|.. |
|000051f0| 2f 2a 20 4f 70 65 6e 20 | 74 68 65 20 77 69 6e 64 |/* Open |the wind|
|00005200| 6f 77 2e 2e 2e 20 2a 2f | 0a 0a 20 20 20 20 20 20 |ow... */|.. |
|00005210| 77 68 69 6c 65 28 21 63 | 6c 6f 73 65 4d 65 29 0a |while(!c|loseMe).|
|00005220| 20 20 20 20 20 20 40 7b | 0a 20 20 20 20 20 20 20 | @{|. |
|00005230| 20 54 52 5f 57 61 69 74 | 28 41 70 70 6c 69 63 61 | TR_Wait|(Applica|
|00005240| 74 69 6f 6e 2c 4e 55 4c | 4c 29 3b 0a 20 20 20 20 |tion,NUL|L);. |
|00005250| 20 20 20 20 77 68 69 6c | 65 28 74 72 4d 73 67 3d | whil|e(trMsg=|
|00005260| 54 52 5f 47 65 74 4d 73 | 67 28 41 70 70 6c 69 63 |TR_GetMs|g(Applic|
|00005270| 61 74 69 6f 6e 29 29 0a | 20 20 20 20 20 20 20 20 |ation)).| |
|00005280| 40 7b 0a 20 20 20 20 20 | 20 20 20 20 20 73 77 69 |@{. | swi|
|00005290| 74 63 68 28 74 72 4d 73 | 67 2d 3e 74 72 6d 5f 43 |tch(trMs|g->trm_C|
|000052a0| 6c 61 73 73 29 0a 20 20 | 20 20 20 20 20 20 20 20 |lass). | |
|000052b0| 40 7b 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 63 |@{. | c|
|000052c0| 61 73 65 20 54 52 4d 53 | 5f 43 4c 4f 53 45 57 49 |ase TRMS|_CLOSEWI|
|000052d0| 4e 44 4f 57 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |NDOW:. | |
|000052e0| 20 20 20 20 63 6c 6f 73 | 65 4d 65 3d 54 52 55 45 | clos|eMe=TRUE|
|000052f0| 3b 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |;. | |
|00005300| 62 72 65 61 6b 3b 0a 0a | 20 20 20 20 20 20 20 20 |break;..| |
|00005310| 20 20 20 20 63 61 73 65 | 20 54 52 4d 53 5f 41 43 | case| TRMS_AC|
|00005320| 54 49 4f 4e 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |TION:. | |
|00005330| 20 20 20 20 73 77 69 74 | 63 68 28 74 72 6d 73 67 | swit|ch(trmsg|
|00005340| 2d 3e 74 72 6d 5f 49 44 | 29 0a 20 20 20 20 20 20 |->trm_ID|). |
|00005350| 20 20 20 20 20 20 20 20 | 40 7b 0a 20 20 20 20 20 | |@{. |
|00005360| 20 20 20 20 20 20 20 20 | 20 20 20 63 61 73 65 20 | | case |
|00005370| 49 44 5f 46 4f 4f 3a 0a | 20 20 20 20 20 20 20 20 |ID_FOO:.| |
|00005380| 20 20 20 20 20 20 20 20 | 20 20 2f 2a 20 44 6f 20 | | /* Do |
|00005390| 73 6f 6d 65 74 68 69 6e | 67 2e 2e 2e 20 2a 2f 0a |somethin|g... */.|
|000053a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000053b0| 20 20 62 72 65 61 6b 3b | 0a 20 20 20 20 20 20 20 | break;|. |
|000053c0| 20 20 20 20 20 20 20 20 | 20 63 61 73 65 20 49 44 | | case ID|
|000053d0| 5f 42 41 52 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |_BAR:. | |
|000053e0| 20 20 20 20 20 20 20 20 | 2f 2a 20 44 6f 20 73 6f | |/* Do so|
|000053f0| 6d 65 74 68 69 6e 67 2e | 2e 2e 20 2a 2f 0a 20 20 |mething.|.. */. |
|00005400| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005410| 62 72 65 61 6b 3b 0a 20 | 20 20 20 20 20 20 20 20 |break;. | |
|00005420| 20 20 20 20 20 40 7d 0a | 20 20 20 20 20 20 20 20 | @}.| |
|00005430| 20 20 20 20 20 20 62 72 | 65 61 6b 3b 0a 0a 20 20 | br|eak;.. |
|00005440| 20 20 20 20 20 20 20 20 | 20 20 63 61 73 65 20 54 | | case T|
|00005450| 52 4d 53 5f 4e 45 57 56 | 41 4c 55 45 3a 0a 20 20 |RMS_NEWV|ALUE:. |
|00005460| 20 20 20 20 20 20 20 20 | 20 20 20 20 73 77 69 74 | | swit|
|00005470| 63 68 28 74 72 4d 73 67 | 2d 3e 74 72 6d 5f 49 44 |ch(trMsg|->trm_ID|
|00005480| 29 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |). | |
|00005490| 40 7b 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |@{. | |
|000054a0| 20 20 20 2f 2a 20 4e 65 | 77 20 76 61 6c 75 65 20 | /* Ne|w value |
|000054b0| 69 73 20 69 6e 20 74 72 | 4d 73 67 2d 3e 74 72 6d |is in tr|Msg->trm|
|000054c0| 5f 44 61 74 61 20 2a 2f | 0a 0a 20 20 20 20 20 20 |_Data */|.. |
|000054d0| 20 20 20 20 20 20 20 20 | 20 20 63 61 73 65 20 49 | | case I|
|000054e0| 44 5f 4d 59 43 48 45 43 | 4b 42 4f 58 3a 0a 20 20 |D_MYCHEC|KBOX:. |
|000054f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005500| 2f 2a 20 44 6f 20 73 6f | 6d 65 74 68 69 6e 67 2e |/* Do so|mething.|
|00005510| 2e 2e 20 2a 2f 0a 20 20 | 20 20 20 20 20 20 20 20 |.. */. | |
|00005520| 20 20 20 20 20 20 20 20 | 62 72 65 61 6b 3b 0a 20 | |break;. |
|00005530| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 63 | | c|
|00005540| 61 73 65 20 49 44 5f 4d | 59 53 4c 49 44 45 52 3a |ase ID_M|YSLIDER:|
|00005550| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00005560| 20 20 20 2f 2a 20 44 6f | 20 73 6f 6d 65 74 68 69 | /* Do| somethi|
|00005570| 6e 67 2e 2e 2e 20 2a 2f | 0a 20 20 20 20 20 20 20 |ng... */|. |
|00005580| 20 20 20 20 20 20 20 20 | 20 20 20 62 72 65 61 6b | | break|
|00005590| 3b 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |;. | |
|000055a0| 40 7d 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |@}. | |
|000055b0| 20 62 72 65 61 6b 3b 0a | 0a 20 20 20 20 20 20 20 | break;.|. |
|000055c0| 20 20 20 20 20 63 61 73 | 65 20 54 52 4d 53 5f 45 | cas|e TRMS_E|
|000055d0| 52 52 4f 52 3a 0a 20 20 | 20 20 20 20 20 20 20 20 |RROR:. | |
|000055e0| 20 20 20 20 70 75 74 73 | 28 54 52 5f 47 65 74 45 | puts|(TR_GetE|
|000055f0| 72 72 6f 72 53 74 72 69 | 6e 67 28 74 72 4d 73 67 |rrorStri|ng(trMsg|
|00005600| 2d 3e 74 72 6d 5f 44 61 | 74 61 29 29 3b 0a 20 20 |->trm_Da|ta));. |
|00005610| 20 20 20 20 20 20 20 20 | 20 20 20 20 62 72 65 61 | | brea|
|00005620| 6b 3b 0a 20 20 20 20 20 | 20 20 20 20 20 40 7d 0a |k;. | @}.|
|00005630| 20 20 20 20 20 20 20 20 | 20 20 54 52 5f 52 65 70 | | TR_Rep|
|00005640| 6c 79 4d 73 67 28 74 72 | 4d 73 67 29 3b 0a 20 20 |lyMsg(tr|Msg);. |
|00005650| 20 20 20 20 20 20 40 7d | 0a 20 20 20 20 20 20 40 | @}|. @|
|00005660| 7d 0a 0a 20 20 20 20 20 | 20 2f 2a 20 43 6c 6f 73 |}.. | /* Clos|
|00005670| 65 20 74 68 65 20 77 69 | 6e 64 6f 77 2e 2e 2e 20 |e the wi|ndow... |
|00005680| 2a 2f 0a 20 20 20 20 40 | 7d 0a 40 65 6e 64 20 65 |*/. @|}.@end e|
|00005690| 78 61 6d 70 6c 65 0a 0a | 40 73 74 72 6f 6e 67 7b |xample..|@strong{|
|000056a0| 4e 6f 74 65 3a 7d 20 44 | 6f 6e 27 74 20 66 6f 72 |Note:} D|on't for|
|000056b0| 67 65 74 20 74 6f 20 72 | 65 70 6c 79 20 61 6c 6c |get to r|eply all|
|000056c0| 20 6d 65 73 73 61 67 65 | 73 21 0a 0a 59 6f 75 20 | message|s!..You |
|000056d0| 63 6f 75 6c 64 20 61 64 | 64 20 61 20 40 63 6f 64 |could ad|d a @cod|
|000056e0| 65 7b 73 77 69 74 63 68 | 28 29 7d 20 66 6f 72 20 |e{switch|()} for |
|000056f0| 74 68 65 20 70 72 6f 6a | 65 63 74 20 77 68 69 63 |the proj|ect whic|
|00005700| 68 20 73 65 6e 74 20 74 | 68 65 20 6d 65 73 73 61 |h sent t|he messa|
|00005710| 67 65 20 69 66 0a 79 6f | 75 20 68 61 76 65 20 6d |ge if.yo|u have m|
|00005720| 6f 72 65 20 74 68 61 6e | 20 6f 6e 65 20 70 72 6f |ore than| one pro|
|00005730| 6a 65 63 74 20 6f 70 65 | 6e 65 64 2c 20 62 75 74 |ject ope|ned, but|
|00005740| 20 61 20 62 65 74 74 65 | 72 20 77 61 79 20 69 73 | a bette|r way is|
|00005750| 20 74 6f 20 75 73 65 20 | 75 6e 69 71 75 65 0a 6f | to use |unique.o|
|00005760| 62 6a 65 63 74 20 49 44 | 73 2e 20 54 68 69 73 20 |bject ID|s. This |
|00005770| 64 6f 65 73 20 61 6c 73 | 6f 20 79 69 65 6c 64 20 |does als|o yield |
|00005780| 74 68 65 20 61 64 76 61 | 6e 74 61 67 65 20 74 68 |the adva|ntage th|
|00005790| 61 74 20 6d 6f 76 69 6e | 67 20 61 6e 20 6f 62 6a |at movin|g an obj|
|000057a0| 65 63 74 20 66 72 6f 6d | 0a 6f 6e 65 20 77 69 6e |ect from|.one win|
|000057b0| 64 6f 77 20 74 6f 20 61 | 6e 6f 74 68 65 72 20 64 |dow to a|nother d|
|000057c0| 6f 65 73 20 6e 6f 74 20 | 72 65 71 75 69 72 65 20 |oes not |require |
|000057d0| 61 6e 79 20 63 68 61 6e | 67 65 20 69 6e 20 74 68 |any chan|ge in th|
|000057e0| 65 20 6d 65 73 73 61 67 | 65 20 68 61 6e 64 6c 69 |e messag|e handli|
|000057f0| 6e 67 2e 0a 0a 49 74 20 | 69 73 20 63 75 72 72 65 |ng...It |is curre|
|00005800| 6e 74 6c 79 20 6e 6f 74 | 20 76 65 72 79 20 77 65 |ntly not| very we|
|00005810| 6c 6c 20 64 6f 63 75 6d | 65 6e 74 65 64 20 77 68 |ll docum|ented wh|
|00005820| 69 63 68 20 6d 65 73 73 | 61 67 65 73 20 61 72 65 |ich mess|ages are|
|00005830| 20 73 65 6e 74 20 62 79 | 20 74 68 65 0a 64 69 66 | sent by| the.dif|
|00005840| 66 65 72 65 6e 74 20 6f | 62 6a 65 63 74 73 2e 20 |ferent o|bjects. |
|00005850| 41 73 20 61 20 67 65 6e | 65 72 61 6c 20 72 75 6c |As a gen|eral rul|
|00005860| 65 2c 20 61 63 74 69 76 | 61 74 65 61 62 6c 65 20 |e, activ|ateable |
|00005870| 6f 62 6a 65 63 74 73 20 | 73 65 6e 64 20 40 63 6f |objects |send @co|
|00005880| 64 65 7b 54 52 4d 53 5f | 41 43 54 49 4f 4e 7d 0a |de{TRMS_|ACTION}.|
|00005890| 61 6e 64 20 6f 62 6a 65 | 63 74 73 20 77 68 69 63 |and obje|cts whic|
|000058a0| 68 20 68 61 76 65 20 61 | 20 40 63 6f 64 65 7b 54 |h have a| @code{T|
|000058b0| 52 41 54 5f 56 61 6c 75 | 65 7d 20 6f 72 20 61 20 |RAT_Valu|e} or a |
|000058c0| 73 69 6d 69 6c 61 72 20 | 6d 6f 64 69 66 69 61 62 |similar |modifiab|
|000058d0| 6c 65 20 61 74 74 72 69 | 62 75 74 65 2c 0a 73 65 |le attri|bute,.se|
|000058e0| 6e 64 20 40 63 6f 64 65 | 7b 54 52 4d 53 5f 4e 45 |nd @code|{TRMS_NE|
|000058f0| 57 56 41 4c 55 45 7d 2e | 0a 0a 48 65 72 65 20 69 |WVALUE}.|..Here i|
|00005900| 73 20 61 20 6d 6f 72 65 | 20 64 65 74 61 69 6c 65 |s a more| detaile|
|00005910| 64 20 64 65 73 63 72 69 | 70 74 69 6f 6e 20 6f 66 |d descri|ption of|
|00005920| 20 74 68 65 20 6d 65 73 | 73 61 67 65 20 74 79 70 | the mes|sage typ|
|00005930| 65 73 3a 0a 0a 40 69 74 | 65 6d 69 7a 65 20 40 62 |es:..@it|emize @b|
|00005940| 75 6c 6c 65 74 0a 40 69 | 74 65 6d 0a 40 63 6f 64 |ullet.@i|tem.@cod|
|00005950| 65 7b 54 52 4d 53 5f 43 | 4c 4f 53 45 57 49 4e 44 |e{TRMS_C|LOSEWIND|
|00005960| 4f 57 7d 3a 20 54 68 65 | 20 75 73 65 72 20 68 61 |OW}: The| user ha|
|00005970| 73 20 70 72 65 73 73 65 | 64 20 74 68 65 20 63 6c |s presse|d the cl|
|00005980| 6f 73 65 20 67 61 64 67 | 65 74 20 6f 72 20 74 68 |ose gadg|et or th|
|00005990| 65 20 40 63 6f 64 65 7b | 45 73 63 7d 20 6b 65 79 |e @code{|Esc} key|
|000059a0| 0a 28 69 66 20 69 74 20 | 68 61 73 6e 27 74 20 62 |.(if it |hasn't b|
|000059b0| 65 65 6e 20 64 69 73 61 | 62 6c 65 64 20 77 69 74 |een disa|bled wit|
|000059c0| 68 20 40 63 6f 64 65 7b | 54 52 57 46 5f 4e 4f 45 |h @code{|TRWF_NOE|
|000059d0| 53 43 43 4c 4f 53 45 7d | 29 2e 0a 40 69 74 65 6d |SCCLOSE}|)..@item|
|000059e0| 0a 40 63 6f 64 65 7b 54 | 52 4d 53 5f 45 52 52 4f |.@code{T|RMS_ERRO|
|000059f0| 52 7d 3a 20 41 6e 20 65 | 72 72 6f 72 20 6f 63 63 |R}: An e|rror occ|
|00005a00| 75 72 65 64 2e 20 40 63 | 6f 64 65 7b 54 52 5f 4d |ured. @c|ode{TR_M|
|00005a10| 65 73 73 61 67 65 2e 74 | 72 6d 5f 44 61 74 61 7d |essage.t|rm_Data}|
|00005a20| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 65 72 | contain|s the er|
|00005a30| 72 6f 72 0a 63 6f 64 65 | 2e 20 59 6f 75 20 63 61 |ror.code|. You ca|
|00005a40| 6e 20 75 73 65 20 40 63 | 6f 64 65 7b 54 52 5f 47 |n use @c|ode{TR_G|
|00005a50| 65 74 45 72 72 6f 72 53 | 74 72 69 6e 67 28 29 7d |etErrorS|tring()}|
|00005a60| 20 74 6f 20 67 65 6e 65 | 72 61 74 65 20 61 20 75 | to gene|rate a u|
|00005a70| 73 65 72 2d 72 65 61 64 | 61 62 6c 65 20 65 72 72 |ser-read|able err|
|00005a80| 6f 72 0a 6d 65 73 73 61 | 67 65 20 66 72 6f 6d 20 |or.messa|ge from |
|00005a90| 74 68 69 73 20 65 72 72 | 6f 72 20 63 6f 64 65 2e |this err|or code.|
|00005aa0| 0a 40 69 74 65 6d 0a 40 | 63 6f 64 65 7b 54 52 4d |.@item.@|code{TRM|
|00005ab0| 53 5f 4e 45 57 56 41 4c | 55 45 7d 3a 20 41 6e 20 |S_NEWVAL|UE}: An |
|00005ac0| 6f 62 6a 65 63 74 27 73 | 20 61 74 74 72 69 62 75 |object's| attribu|
|00005ad0| 74 65 20 68 61 73 20 63 | 68 61 6e 67 65 64 2e 20 |te has c|hanged. |
|00005ae0| 40 63 6f 64 65 7b 54 52 | 5f 4d 65 73 73 61 67 65 |@code{TR|_Message|
|00005af0| 2e 74 72 6d 5f 44 61 74 | 61 7d 20 63 6f 6e 74 61 |.trm_Dat|a} conta|
|00005b00| 69 6e 73 0a 74 68 65 20 | 6e 65 77 20 76 61 6c 75 |ins.the |new valu|
|00005b10| 65 20 66 6f 72 20 74 68 | 65 20 61 74 74 72 69 62 |e for th|e attrib|
|00005b20| 75 74 65 2e 0a 40 69 74 | 65 6d 0a 40 63 6f 64 65 |ute..@it|em.@code|
|00005b30| 7b 54 52 4d 53 5f 41 43 | 54 49 4f 4e 7d 3a 20 41 |{TRMS_AC|TION}: A|
|00005b40| 6e 20 6f 62 6a 65 63 74 | 20 68 61 73 20 62 65 65 |n object| has bee|
|00005b50| 6e 20 61 63 74 69 76 61 | 74 65 64 20 73 6f 6d 65 |n activa|ted some|
|00005b60| 68 6f 77 20 28 65 2e 67 | 2e 20 61 20 62 75 74 74 |how (e.g|. a butt|
|00005b70| 6f 6e 20 68 61 73 20 62 | 65 65 6e 20 70 72 65 73 |on has b|een pres|
|00005b80| 73 65 64 0a 6f 72 20 69 | 74 73 20 6b 65 79 62 6f |sed.or i|ts keybo|
|00005b90| 61 72 64 20 73 68 6f 72 | 74 63 75 74 20 77 61 73 |ard shor|tcut was|
|00005ba0| 20 75 73 65 64 20 69 6e | 73 74 65 61 64 29 2e 0a | used in|stead)..|
|00005bb0| 40 69 74 65 6d 0a 40 63 | 6f 64 65 7b 54 52 4d 53 |@item.@c|ode{TRMS|
|00005bc0| 5f 49 43 4f 4e 44 52 4f | 50 50 45 44 7d 3a 20 41 |_ICONDRO|PPED}: A|
|00005bd0| 6e 20 69 63 6f 6e 20 68 | 61 73 20 62 65 65 6e 20 |n icon h|as been |
|00005be0| 64 72 6f 70 70 65 64 20 | 6f 76 65 72 20 61 20 77 |dropped |over a w|
|00005bf0| 69 6e 64 6f 77 2e 0a 59 | 6f 75 20 77 69 6c 6c 20 |indow..Y|ou will |
|00005c00| 67 65 74 20 74 68 69 73 | 20 6d 65 73 73 61 67 65 |get this| message|
|00005c10| 20 6f 6e 6c 79 20 69 66 | 20 61 6e 20 6f 62 6a 65 | only if| an obje|
|00005c20| 63 74 20 69 6e 20 79 6f | 75 72 0a 77 69 6e 64 6f |ct in yo|ur.windo|
|00005c30| 77 20 72 65 61 63 74 73 | 20 6f 6e 20 64 72 6f 70 |w reacts| on drop|
|00005c40| 70 65 64 20 69 63 6f 6e | 73 20 6f 72 20 79 6f 75 |ped icon|s or you|
|00005c50| 20 61 73 6b 20 64 69 72 | 65 63 74 6c 79 20 66 6f | ask dir|ectly fo|
|00005c60| 72 20 69 74 20 62 79 0a | 73 70 65 63 69 66 79 69 |r it by.|specifyi|
|00005c70| 6e 67 20 74 68 65 20 70 | 72 6f 6a 65 63 74 20 66 |ng the p|roject f|
|00005c80| 6c 61 67 20 40 63 6f 64 | 65 7b 54 52 57 46 5f 41 |lag @cod|e{TRWF_A|
|00005c90| 50 50 57 49 4e 44 4f 57 | 7d 2e 20 4f 74 68 65 72 |PPWINDOW|}. Other|
|00005ca0| 77 69 73 65 0a 57 6f 72 | 6b 62 65 6e 63 68 20 77 |wise.Wor|kbench w|
|00005cb0| 69 6c 6c 20 6e 6f 74 20 | 61 6c 6c 6f 77 20 79 6f |ill not |allow yo|
|00005cc0| 75 20 74 6f 20 64 72 6f | 70 20 69 63 6f 6e 73 20 |u to dro|p icons |
|00005cd0| 6f 76 65 72 20 61 20 54 | 72 69 74 6f 6e 20 77 69 |over a T|riton wi|
|00005ce0| 6e 64 6f 77 2e 0a 40 63 | 6f 64 65 7b 54 52 5f 4d |ndow..@c|ode{TR_M|
|00005cf0| 65 73 73 61 67 65 2e 74 | 72 6d 5f 49 44 7d 20 63 |essage.t|rm_ID} c|
|00005d00| 6f 6e 74 61 69 6e 73 20 | 74 68 65 20 49 44 20 6f |ontains |the ID o|
|00005d10| 66 20 74 68 65 20 6f 62 | 6a 65 63 74 20 6f 76 65 |f the ob|ject ove|
|00005d20| 72 20 77 68 69 63 68 20 | 74 68 65 0a 69 63 6f 6e |r which |the.icon|
|00005d30| 20 77 61 73 20 64 72 6f | 70 70 65 64 20 6f 72 20 | was dro|pped or |
|00005d40| 30 20 69 66 20 69 74 20 | 77 61 73 20 64 72 6f 70 |0 if it |was drop|
|00005d50| 70 65 64 20 6f 76 65 72 | 20 61 6e 20 6f 62 6a 65 |ped over| an obje|
|00005d60| 63 74 20 77 69 74 68 6f | 75 74 20 61 6e 20 49 44 |ct witho|ut an ID|
|00005d70| 2e 0a 40 63 6f 64 65 7b | 54 52 5f 4d 65 73 73 61 |..@code{|TR_Messa|
|00005d80| 67 65 2e 74 72 6d 5f 44 | 61 74 61 7d 20 63 6f 6e |ge.trm_D|ata} con|
|00005d90| 74 61 69 6e 73 20 61 20 | 70 6f 69 6e 74 65 72 20 |tains a |pointer |
|00005da0| 74 6f 20 74 68 65 20 40 | 63 6f 64 65 7b 73 74 72 |to the @|code{str|
|00005db0| 75 63 74 20 41 70 70 4d | 65 73 73 61 67 65 7d 0a |uct AppM|essage}.|
|00005dc0| 77 68 69 63 68 20 77 61 | 73 20 73 65 6e 74 20 62 |which wa|s sent b|
|00005dd0| 79 20 57 6f 72 6b 62 65 | 6e 63 68 2e 0a 40 69 74 |y Workbe|nch..@it|
|00005de0| 65 6d 0a 40 63 6f 64 65 | 7b 54 52 4d 53 5f 4b 45 |em.@code|{TRMS_KE|
|00005df0| 59 50 52 45 53 53 45 44 | 7d 3a 20 41 20 6b 65 79 |YPRESSED|}: A key|
|00005e00| 20 68 61 73 20 62 65 65 | 6e 20 70 72 65 73 73 65 | has bee|n presse|
|00005e10| 64 20 61 6e 64 20 54 72 | 69 74 6f 6e 20 77 61 73 |d and Tr|iton was|
|00005e20| 20 75 6e 61 62 6c 65 20 | 74 6f 0a 69 64 65 6e 74 | unable |to.ident|
|00005e30| 69 66 79 20 69 74 20 28 | 65 2e 67 2e 20 61 73 20 |ify it (|e.g. as |
|00005e40| 61 20 6b 65 79 62 6f 61 | 72 64 20 73 68 6f 72 74 |a keyboa|rd short|
|00005e50| 63 75 74 29 2e 0a 40 63 | 6f 64 65 7b 54 52 5f 4d |cut)..@c|ode{TR_M|
|00005e60| 65 73 73 61 67 65 2e 74 | 72 6d 5f 44 61 74 61 7d |essage.t|rm_Data}|
|00005e70| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 41 53 | contain|s the AS|
|00005e80| 43 49 49 20 63 6f 64 65 | 20 28 69 66 20 61 76 61 |CII code| (if ava|
|00005e90| 69 6c 61 62 6c 65 2c 0a | 6f 74 68 65 72 77 69 73 |ilable,.|otherwis|
|00005ea0| 65 20 30 29 2c 0a 40 63 | 6f 64 65 7b 54 52 5f 4d |e 0),.@c|ode{TR_M|
|00005eb0| 65 73 73 61 67 65 2e 74 | 72 6d 5f 43 6f 64 65 7d |essage.t|rm_Code}|
|00005ec0| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 52 61 | contain|s the Ra|
|00005ed0| 77 4b 65 79 20 63 6f 64 | 65 20 61 6e 64 20 40 63 |wKey cod|e and @c|
|00005ee0| 6f 64 65 7b 54 52 5f 4d | 65 73 73 61 67 65 2e 74 |ode{TR_M|essage.t|
|00005ef0| 72 6d 5f 51 75 61 6c 69 | 66 69 65 72 7d 0a 74 68 |rm_Quali|fier}.th|
|00005f00| 65 20 71 75 61 6c 69 66 | 69 65 72 20 62 69 74 73 |e qualif|ier bits|
|00005f10| 2e 0a 40 69 74 65 6d 0a | 40 63 6f 64 65 7b 54 52 |..@item.|@code{TR|
|00005f20| 4d 53 5f 48 45 4c 50 7d | 3a 20 54 68 65 20 75 73 |MS_HELP}|: The us|
|00005f30| 65 72 20 72 65 71 75 65 | 73 74 73 20 68 65 6c 70 |er reque|sts help|
|00005f40| 20 66 6f 72 20 74 68 65 | 20 6f 62 6a 65 63 74 20 | for the| object |
|00005f50| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 40 63 6f |specifie|d by @co|
|00005f60| 64 65 7b 54 52 5f 4d 65 | 73 73 61 67 65 2e 74 72 |de{TR_Me|ssage.tr|
|00005f70| 6d 5f 49 44 7d 0a 6f 72 | 20 66 6f 72 20 74 68 65 |m_ID}.or| for the|
|00005f80| 20 77 68 6f 6c 65 20 77 | 69 6e 64 6f 77 20 69 66 | whole w|indow if|
|00005f90| 20 74 68 65 20 49 44 20 | 69 73 20 30 2e 0a 40 65 | the ID |is 0..@e|
|00005fa0| 6e 64 20 69 74 65 6d 69 | 7a 65 0a 0a 41 20 64 65 |nd itemi|ze..A de|
|00005fb0| 73 63 72 69 70 74 69 6f | 6e 20 6f 66 20 61 6c 6c |scriptio|n of all|
|00005fc0| 20 66 69 65 6c 64 73 20 | 6f 66 20 74 68 65 20 40 | fields |of the @|
|00005fd0| 63 6f 64 65 7b 54 52 5f | 4d 65 73 73 61 67 65 7d |code{TR_|Message}|
|00005fe0| 20 73 74 72 75 63 74 75 | 72 65 20 63 61 6e 20 62 | structu|re can b|
|00005ff0| 65 20 66 6f 75 6e 64 20 | 69 6e 0a 74 68 65 20 43 |e found |in.the C|
|00006000| 20 68 65 61 64 65 72 20 | 66 69 6c 65 20 40 66 69 | header |file @fi|
|00006010| 6c 65 7b 44 65 76 65 6c | 6f 70 65 72 2f 49 6e 63 |le{Devel|oper/Inc|
|00006020| 6c 75 64 65 2f 6c 69 62 | 72 61 72 69 65 73 2f 74 |lude/lib|raries/t|
|00006030| 72 69 74 6f 6e 2e 68 7d | 2e 0a 0a 40 6e 6f 64 65 |riton.h}|...@node|
|00006040| 20 54 55 54 5f 4d 45 53 | 2c 20 54 55 54 5f 48 45 | TUT_MES|, TUT_HE|
|00006050| 4c 2c 20 54 55 54 5f 50 | 4f 4c 2c 20 54 6f 70 0a |L, TUT_P|OL, Top.|
|00006060| 40 73 65 63 74 69 6f 6e | 20 4d 65 73 73 61 67 65 |@section| Message|
|00006070| 73 0a 40 63 69 6e 64 65 | 78 20 53 65 74 0a 40 63 |s.@cinde|x Set.@c|
|00006080| 69 6e 64 65 78 20 47 65 | 74 0a 40 63 69 6e 64 65 |index Ge|t.@cinde|
|00006090| 78 20 4d 65 73 73 61 67 | 65 0a 40 63 69 6e 64 65 |x Messag|e.@cinde|
|000060a0| 78 20 41 74 74 72 69 62 | 75 74 65 0a 40 63 69 6e |x Attrib|ute.@cin|
|000060b0| 64 65 78 20 51 75 65 72 | 79 0a 40 63 69 6e 64 65 |dex Quer|y.@cinde|
|000060c0| 78 20 4d 6f 64 69 66 79 | 0a 0a 53 6f 6d 65 74 69 |x Modify|..Someti|
|000060d0| 6d 65 73 20 79 6f 75 20 | 6d 61 79 20 77 69 73 68 |mes you |may wish|
|000060e0| 20 74 6f 20 71 75 65 72 | 79 20 61 6e 20 6f 62 6a | to quer|y an obj|
|000060f0| 65 63 74 27 73 20 61 74 | 74 72 69 62 75 74 65 20 |ect's at|tribute |
|00006100| 64 69 72 65 63 74 6c 79 | 0a 77 69 74 68 6f 75 74 |directly|.without|
|00006110| 20 77 61 69 74 69 6e 67 | 20 69 6e 20 61 20 70 6f | waiting| in a po|
|00006120| 6c 6c 69 6e 67 20 6c 6f | 6f 70 20 61 6e 64 20 74 |lling lo|op and t|
|00006130| 68 65 6e 20 73 74 6f 72 | 69 6e 67 20 69 74 73 20 |hen stor|ing its |
|00006140| 76 61 6c 75 65 20 73 6f | 6d 65 77 68 65 72 65 0a |value so|mewhere.|
|00006150| 65 6c 73 65 2e 20 54 68 | 69 73 20 69 73 20 65 73 |else. Th|is is es|
|00006160| 70 65 63 69 61 6c 6c 79 | 20 75 73 65 66 75 6c 20 |pecially| useful |
|00006170| 66 6f 72 20 73 74 72 69 | 6e 67 20 67 61 64 67 65 |for stri|ng gadge|
|00006180| 74 73 2e 20 59 6f 75 20 | 73 68 6f 75 6c 64 0a 40 |ts. You |should.@|
|00006190| 65 6d 70 68 7b 6e 6f 74 | 7d 20 72 65 61 64 20 74 |emph{not|} read t|
|000061a0| 68 65 69 72 20 63 6f 6e | 74 65 6e 74 73 20 77 68 |heir con|tents wh|
|000061b0| 65 6e 20 79 6f 75 20 72 | 65 63 65 69 76 65 20 61 |en you r|eceive a|
|000061c0| 20 40 63 6f 64 65 7b 54 | 52 4d 53 5f 4e 45 57 56 | @code{T|RMS_NEWV|
|000061d0| 41 4c 55 45 7d 0a 6d 65 | 73 73 61 67 65 2c 20 62 |ALUE}.me|ssage, b|
|000061e0| 65 63 61 75 73 65 20 69 | 74 20 69 73 20 70 6f 73 |ecause i|t is pos|
|000061f0| 73 69 62 6c 65 20 74 6f | 20 65 78 69 74 20 61 20 |sible to| exit a |
|00006200| 73 74 72 69 6e 67 20 67 | 61 64 67 65 74 20 77 69 |string g|adget wi|
|00006210| 74 68 6f 75 74 0a 74 72 | 69 67 67 65 72 69 6e 67 |thout.tr|iggering|
|00006220| 20 73 75 63 68 20 61 20 | 6d 65 73 73 61 67 65 2e | such a |message.|
|00006230| 20 49 6e 73 74 65 61 64 | 20 79 6f 75 20 68 61 76 | Instead| you hav|
|00006240| 65 20 74 6f 20 72 65 61 | 64 20 74 68 65 20 63 6f |e to rea|d the co|
|00006250| 6e 74 65 6e 74 73 0a 64 | 69 72 65 63 74 6c 79 20 |ntents.d|irectly |
|00006260| 62 65 66 6f 72 65 20 79 | 6f 75 20 6e 65 65 64 20 |before y|ou need |
|00006270| 74 68 65 6d 2e 0a 0a 41 | 74 74 72 69 62 75 74 65 |them...A|ttribute|
|00006280| 73 20 63 61 6e 20 62 65 | 20 72 65 61 64 20 77 69 |s can be| read wi|
|00006290| 74 68 20 74 68 65 20 40 | 63 6f 64 65 7b 54 52 5f |th the @|code{TR_|
|000062a0| 47 65 74 41 74 74 72 69 | 62 75 74 65 28 29 7d 20 |GetAttri|bute()} |
|000062b0| 66 75 6e 63 74 69 6f 6e | 2c 0a 77 68 69 63 68 20 |function|,.which |
|000062c0| 77 69 6c 6c 20 72 65 74 | 75 72 6e 20 74 68 65 20 |will ret|urn the |
|000062d0| 76 61 6c 75 65 20 6f 66 | 20 61 6e 20 6f 62 6a 65 |value of| an obje|
|000062e0| 63 74 27 73 20 6f 72 20 | 70 72 6f 6a 65 63 74 27 |ct's or |project'|
|000062f0| 73 20 61 74 74 72 69 62 | 75 74 65 2e 0a 53 70 65 |s attrib|ute..Spe|
|00006300| 63 69 66 79 20 74 68 65 | 20 6f 62 6a 65 63 74 27 |cify the| object'|
|00006310| 73 20 49 44 20 6f 72 20 | 30 20 66 6f 72 20 61 20 |s ID or |0 for a |
|00006320| 70 72 6f 6a 65 63 74 20 | 61 74 74 72 69 62 75 74 |project |attribut|
|00006330| 65 2e 20 59 6f 75 20 63 | 61 6e 20 67 65 74 0a 74 |e. You c|an get.t|
|00006340| 68 65 20 64 65 66 61 75 | 6c 74 20 61 74 74 72 69 |he defau|lt attri|
|00006350| 62 75 74 65 20 6f 66 20 | 61 6e 20 6f 62 6a 65 63 |bute of |an objec|
|00006360| 74 20 62 79 20 73 65 74 | 74 69 6e 67 20 40 63 6f |t by set|ting @co|
|00006370| 64 65 7b 41 74 74 72 69 | 62 75 74 65 7d 20 74 6f |de{Attri|bute} to|
|00006380| 0a 30 2e 20 4f 74 68 65 | 72 77 69 73 65 20 73 65 |.0. Othe|rwise se|
|00006390| 74 20 69 74 20 74 6f 20 | 61 6e 20 61 74 74 72 69 |t it to |an attri|
|000063a0| 62 75 74 65 20 74 61 67 | 2e 20 43 68 65 63 6b 61 |bute tag|. Checka|
|000063b0| 62 6c 65 20 6d 65 6e 75 | 20 69 74 65 6d 73 20 73 |ble menu| items s|
|000063c0| 75 70 70 6f 72 74 0a 74 | 68 65 20 40 63 6f 64 65 |upport.t|he @code|
|000063d0| 7b 54 52 41 54 5f 56 61 | 6c 75 65 7d 20 61 74 74 |{TRAT_Va|lue} att|
|000063e0| 72 69 62 75 74 65 20 77 | 68 69 63 68 20 69 73 20 |ribute w|hich is |
|000063f0| 73 65 74 20 74 6f 20 30 | 20 69 66 20 74 68 65 20 |set to 0| if the |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
