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

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 43 79 63 6c 65 2e 6d |\section|{Cycle.m|
|00000010| 75 69 7d 0a 0a 43 79 63 | 6c 65 20 63 6c 61 73 73 |ui}..Cyc|le class|
|00000020| 20 67 65 6e 65 72 61 74 | 65 73 20 74 68 65 20 77 | generat|es the w|
|00000030| 65 6c 6c 20 6b 6e 6f 77 | 6e 20 63 79 63 6c 65 20 |ell know|n cycle |
|00000040| 67 61 64 67 65 74 73 2e | 0a 48 6f 77 65 76 65 72 |gadgets.|.However|
|00000050| 2c 20 4d 55 49 20 63 79 | 63 6c 65 20 67 61 64 67 |, MUI cy|cle gadg|
|00000060| 65 74 73 20 66 65 61 74 | 75 72 65 20 61 20 28 63 |ets feat|ure a (c|
|00000070| 6f 6e 66 69 67 75 72 61 | 62 6c 65 29 0a 70 6f 70 |onfigura|ble).pop|
|00000080| 75 70 20 6d 65 6e 75 20 | 74 6f 20 61 76 6f 69 64 |up menu |to avoid|
|00000090| 20 63 6c 69 63 6b 69 6e | 67 20 74 68 72 6f 75 67 | clickin|g throug|
|000000a0| 68 20 6d 61 6e 79 20 65 | 6e 74 72 69 65 73 2e 0a |h many e|ntries..|
|000000b0| 0a 5c 73 75 62 73 65 63 | 74 69 6f 6e 5b 4d 55 49 |.\subsec|tion[MUI|
|000000c0| 41 5c 5f 43 79 63 6c 65 | 5c 5f 41 63 74 69 76 65 |A\_Cycle|\_Active|
|000000d0| 5d 7b 4d 55 49 41 5c 5f | 43 79 63 6c 65 5c 5f 41 |]{MUIA\_|Cycle\_A|
|000000e0| 63 74 69 76 65 20 2d 2d | 20 28 56 34 29 20 5b 49 |ctive --| (V4) [I|
|000000f0| 53 47 5d 2c 20 4c 4f 4e | 47 7d 0a 0a 53 50 45 43 |SG], LON|G}..SPEC|
|00000100| 49 41 4c 20 49 4e 50 55 | 54 53 0a 4d 55 49 56 5c |IAL INPU|TS.MUIV\|
|00000110| 5f 43 79 63 6c 65 5c 5f | 41 63 74 69 76 65 5c 5f |_Cycle\_|Active\_|
|00000120| 4e 65 78 74 0a 4d 55 49 | 56 5c 5f 43 79 63 6c 65 |Next.MUI|V\_Cycle|
|00000130| 5c 5f 41 63 74 69 76 65 | 5c 5f 50 72 65 76 0a 0a |\_Active|\_Prev..|
|00000140| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|00000150| 46 55 4e 43 54 49 4f 4e | 7d 0a 54 68 69 73 20 61 |FUNCTION|}.This a|
|00000160| 74 74 72 69 62 75 74 65 | 73 20 64 65 66 69 6e 65 |ttribute|s define|
|00000170| 73 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |s the nu|mber of |
|00000180| 74 68 65 20 61 63 74 69 | 76 65 0a 65 6e 74 72 79 |the acti|ve.entry|
|00000190| 20 69 6e 20 74 68 65 20 | 63 79 63 6c 65 20 67 61 | in the |cycle ga|
|000001a0| 64 67 65 74 73 2e 20 56 | 61 6c 69 64 20 72 61 6e |dgets. V|alid ran|
|000001b0| 67 65 20 69 73 20 66 72 | 6f 6d 0a 30 20 66 6f 72 |ge is fr|om.0 for|
|000001c0| 20 74 68 65 20 66 69 72 | 73 74 20 65 6e 74 72 79 | the fir|st entry|
|000001d0| 20 74 6f 20 4e 75 6d 45 | 6e 74 72 69 65 73 2d 31 | to NumE|ntries-1|
|000001e0| 20 66 6f 72 20 74 68 65 | 20 6c 61 73 74 2e 0a 0a | for the| last...|
|000001f0| 53 65 74 74 69 6e 67 20 | 4d 55 49 41 5c 5f 43 79 |Setting |MUIA\_Cy|
|00000200| 63 6c 65 5c 5f 41 63 74 | 69 76 65 20 63 61 75 73 |cle\_Act|ive caus|
|00000210| 65 73 20 74 68 65 20 67 | 61 64 67 65 74 20 74 6f |es the g|adget to|
|00000220| 0a 62 65 20 75 70 64 61 | 74 65 64 2e 20 4f 6e 20 |.be upda|ted. On |
|00000230| 74 68 65 20 6f 74 68 65 | 72 20 68 61 6e 64 2c 20 |the othe|r hand, |
|00000240| 77 68 65 6e 20 74 68 65 | 20 75 73 65 72 0a 70 6c |when the| user.pl|
|00000250| 61 79 73 20 61 72 6f 75 | 6e 64 20 77 69 74 68 20 |ays arou|nd with |
|00000260| 74 68 65 20 67 61 64 67 | 65 74 2c 20 4d 55 49 41 |the gadg|et, MUIA|
|00000270| 5c 5f 43 79 63 6c 65 5c | 5f 41 63 74 69 76 65 0a |\_Cycle\|_Active.|
|00000280| 77 69 6c 6c 20 61 6c 77 | 61 79 73 20 72 65 66 6c |will alw|ays refl|
|00000290| 65 63 74 73 20 74 68 65 | 20 63 75 72 72 65 6e 74 |ects the| current|
|000002a0| 20 73 74 61 74 65 2e 0a | 0a 55 73 69 6e 67 20 4d | state..|.Using M|
|000002b0| 55 49 56 5c 5f 43 79 63 | 6c 65 5c 5f 41 63 74 69 |UIV\_Cyc|le\_Acti|
|000002c0| 76 65 5c 5f 4e 65 78 74 | 20 61 6e 64 20 4d 55 49 |ve\_Next| and MUI|
|000002d0| 56 5c 5f 43 79 63 6c 65 | 5c 5f 41 63 74 69 76 65 |V\_Cycle|\_Active|
|000002e0| 5c 5f 50 72 65 76 0a 61 | 73 20 61 74 74 72 69 62 |\_Prev.a|s attrib|
|000002f0| 75 74 65 20 76 61 6c 75 | 65 20 64 75 72 69 6e 67 |ute valu|e during|
|00000300| 20 73 65 74 20 63 61 75 | 73 65 73 20 74 68 65 20 | set cau|ses the |
|00000310| 67 61 64 67 65 74 20 74 | 6f 0a 63 79 63 6c 65 20 |gadget t|o.cycle |
|00000320| 74 68 72 6f 75 67 68 20 | 69 74 73 20 65 6e 74 72 |through |its entr|
|00000330| 69 65 73 20 69 6e 20 74 | 68 65 20 67 69 76 65 6e |ies in t|he given|
|00000340| 20 64 69 72 65 63 74 69 | 6f 6e 2e 0a 0a 5c 73 75 | directi|on...\su|
|00000350| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 45 58 41 |bsubsect|ion*{EXA|
|00000360| 4d 50 4c 45 7d 0a 5c 73 | 6d 61 6c 6c 0a 5c 62 65 |MPLE}.\s|mall.\be|
|00000370| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 73 65 |gin{verb|atim}.se|
|00000380| 74 28 63 79 63 6c 65 6f | 62 6a 2c 4d 55 49 41 5f |t(cycleo|bj,MUIA_|
|00000390| 43 79 63 6c 65 5f 41 63 | 74 69 76 65 2c 33 29 3b |Cycle_Ac|tive,3);|
|000003a0| 0a 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |..\end{v|erbatim}|
|000003b0| 0a 5c 6e 6f 72 6d 61 6c | 73 69 7a 65 0a 5c 73 75 |.\normal|size.\su|
|000003c0| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 53 45 45 |bsubsect|ion*{SEE|
|000003d0| 20 41 4c 53 4f 7d 0a 4d | 55 49 41 5c 5f 43 79 63 | ALSO}.M|UIA\_Cyc|
|000003e0| 6c 65 5c 5f 45 6e 74 72 | 69 65 73 0a 0a 5c 73 75 |le\_Entr|ies..\su|
|000003f0| 62 73 65 63 74 69 6f 6e | 5b 4d 55 49 41 5c 5f 43 |bsection|[MUIA\_C|
|00000400| 79 63 6c 65 5c 5f 45 6e | 74 72 69 65 73 5d 7b 4d |ycle\_En|tries]{M|
|00000410| 55 49 41 5c 5f 43 79 63 | 6c 65 5c 5f 45 6e 74 72 |UIA\_Cyc|le\_Entr|
|00000420| 69 65 73 20 2d 2d 20 28 | 56 34 29 20 5b 49 2e 2e |ies -- (|V4) [I..|
|00000430| 5d 2c 20 53 54 52 50 54 | 52 20 24 5c 61 73 74 24 |], STRPT|R $\ast$|
|00000440| 7d 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |}..\subs|ubsectio|
|00000450| 6e 2a 7b 46 55 4e 43 54 | 49 4f 4e 7d 0a 48 65 72 |n*{FUNCT|ION}.Her|
|00000460| 65 20 79 6f 75 20 63 61 | 6e 20 64 65 66 69 6e 65 |e you ca|n define|
|00000470| 20 77 68 61 74 20 65 6e | 74 72 69 65 73 20 73 68 | what en|tries sh|
|00000480| 61 6c 6c 20 62 65 20 64 | 69 73 70 6c 61 79 65 64 |all be d|isplayed|
|00000490| 0a 69 6e 20 79 6f 75 72 | 20 63 79 63 6c 65 20 67 |.in your| cycle g|
|000004a0| 61 64 67 65 74 2e 20 59 | 6f 75 20 6d 75 73 74 20 |adget. Y|ou must |
|000004b0| 73 75 70 70 6c 79 20 61 | 20 70 6f 69 6e 74 65 72 |supply a| pointer|
|000004c0| 20 74 6f 0a 61 20 73 74 | 72 69 6e 67 20 61 72 72 | to.a st|ring arr|
|000004d0| 61 79 2c 20 63 6f 6e 74 | 61 69 6e 69 6e 67 20 6f |ay, cont|aining o|
|000004e0| 6e 65 20 65 6e 74 72 79 | 20 66 6f 72 20 65 61 63 |ne entry| for eac|
|000004f0| 68 20 69 74 65 6d 0a 61 | 6e 64 20 74 65 72 6d 69 |h item.a|nd termi|
|00000500| 6e 61 74 65 64 20 77 69 | 74 68 20 61 20 4e 55 4c |nated wi|th a NUL|
|00000510| 4c 2e 0a 0a 52 65 6d 65 | 6d 62 65 72 20 74 68 61 |L...Reme|mber tha|
|00000520| 74 20 63 79 63 6c 65 20 | 67 61 64 67 65 74 20 65 |t cycle |gadget e|
|00000530| 6e 74 72 69 65 73 20 6d | 61 79 20 63 6f 6e 74 61 |ntries m|ay conta|
|00000540| 69 6e 20 61 6e 79 0a 74 | 65 78 74 20 66 6f 72 6d |in any.t|ext form|
|00000550| 61 74 74 69 6e 67 20 63 | 6f 64 65 20 73 75 63 68 |atting c|ode such|
|00000560| 20 61 73 20 62 6f 6c 64 | 2c 20 69 74 61 6c 69 63 | as bold|, italic|
|00000570| 20 6f 72 0a 75 6e 64 65 | 72 6c 69 6e 65 64 20 63 | or.unde|rlined c|
|00000580| 68 61 72 61 63 74 65 72 | 73 2e 0a 0a 43 79 63 6c |haracter|s...Cycl|
|00000590| 65 20 67 61 64 67 65 74 | 73 20 73 65 74 20 74 68 |e gadget|s set th|
|000005a0| 65 20 70 72 65 70 61 72 | 73 65 20 73 74 72 69 6e |e prepar|se strin|
|000005b0| 67 20 66 6f 72 20 61 6c | 6c 20 65 6e 74 72 69 65 |g for al|l entrie|
|000005c0| 73 0a 74 6f 20 27 27 24 | 5c 62 61 63 6b 73 6c 61 |s.to ''$|\backsla|
|000005d0| 73 68 24 33 33 63 27 27 | 2c 20 74 68 69 73 20 6d |sh$33c''|, this m|
|000005e0| 65 61 6e 73 20 74 68 61 | 74 20 74 68 65 79 20 77 |eans tha|t they w|
|000005f0| 69 6c 6c 20 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |ill auto|maticall|
|00000600| 79 0a 61 70 70 65 61 72 | 20 63 65 6e 74 65 72 65 |y.appear| centere|
|00000610| 64 2e 20 4f 66 20 63 6f | 75 72 73 65 20 79 6f 75 |d. Of co|urse you|
|00000620| 20 63 61 6e 20 6f 76 65 | 72 72 69 64 65 20 74 68 | can ove|rride th|
|00000630| 69 73 20 62 79 0a 73 69 | 6d 70 6c 79 20 70 72 65 |is by.si|mply pre|
|00000640| 63 65 64 69 6e 67 20 79 | 6f 75 72 20 65 6e 74 72 |ceding y|our entr|
|00000650| 69 65 73 20 77 69 74 68 | 20 6f 77 6e 20 66 6f 72 |ies with| own for|
|00000660| 6d 61 74 74 69 6e 67 20 | 63 6f 64 65 2e 0a 0a 5c |matting |code...\|
|00000670| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 45 |subsubse|ction*{E|
|00000680| 58 41 4d 50 4c 45 7d 0a | 5c 73 6d 61 6c 6c 0a 5c |XAMPLE}.|\small.\|
|00000690| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|000006a0| 73 74 61 74 69 63 20 63 | 6f 6e 73 74 20 63 68 61 |static c|onst cha|
|000006b0| 72 20 2a 43 59 41 5f 47 | 72 6f 75 70 54 69 74 6c |r *CYA_G|roupTitl|
|000006c0| 65 43 6f 6c 6f 72 5b 5d | 20 3d 0a 7b 0a 20 20 20 |eColor[]| =.{.   |
|000006d0| 22 6e 6f 72 6d 61 6c 22 | 2c 0a 20 20 20 22 68 69 |"normal"|,.   "hi|
|000006e0| 67 68 6c 69 67 68 74 22 | 2c 0a 20 20 20 22 33 2d |ghlight"|,.   "3-|
|000006f0| 64 69 6d 65 6e 73 69 6f | 6e 61 6c 22 2c 0a 20 20 |dimensio|nal",.  |
|00000700| 20 4e 55 4c 4c 0a 7d 3b | 0a 0a 20 20 20 20 20 20 | NULL.};|..      |
|00000710| 20 20 43 59 5f 54 69 74 | 6c 65 20 3d 20 43 79 63 |  CY_Tit|le = Cyc|
|00000720| 6c 65 4f 62 6a 65 63 74 | 2c 0a 20 20 20 4d 55 49 |leObject|,.   MUI|
|00000730| 41 5f 43 79 63 6c 65 5f | 45 6e 74 72 69 65 73 2c |A_Cycle_|Entries,|
|00000740| 20 43 59 41 5f 47 72 6f | 75 70 54 69 74 6c 65 43 | CYA_Gro|upTitleC|
|00000750| 6f 6c 6f 72 2c 0a 20 20 | 20 45 6e 64 3b 0a 0a 5c |olor,.  | End;..\|
|00000760| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 0a 5c 6e |end{verb|atim}.\n|
|00000770| 6f 72 6d 61 6c 73 69 7a | 65 0a 5c 73 75 62 73 75 |ormalsiz|e.\subsu|
|00000780| 62 73 65 63 74 69 6f 6e | 2a 7b 53 45 45 20 41 4c |bsection|*{SEE AL|
|00000790| 53 4f 7d 0a 4d 55 49 41 | 5c 5f 43 79 63 6c 65 5c |SO}.MUIA|\_Cycle\|
|000007a0| 5f 41 63 74 69 76 65 2c | 20 4d 55 49 41 5c 5f 54 |_Active,| MUIA\_T|
|000007b0| 65 78 74 5c 5f 43 6f 6e | 74 65 6e 74 73 0a 0a 0a |ext\_Con|tents...|
|000007c0| 0a                      |                         |.       |        |
+--------+-------------------------+-------------------------+--------+--------+