Home » Archimedes archive » Archimedes World » AW-1992-08.adf » AWaug92 » !AWaug92/Goodies/WimpGloss/!WimpGloss/Wimp/Icons
!AWaug92/Goodies/WimpGloss/!WimpGloss/Wimp/Icons
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
Tape/disk: | Home » Archimedes archive » Archimedes World » AW-1992-08.adf » AWaug92 |
Filename: | !AWaug92/Goodies/WimpGloss/!WimpGloss/Wimp/Icons |
Read OK: | ✔ |
File size: | 0A4E bytes |
Load address: | 0000 |
Exec address: | 0000 |
File contents
DEF FNWimp_IconBar(Sprite$) REM This function places the sprite, specified by the REM variable Sprite$, on the icon bar (right). E.g. REM Bar_Icon%=FNWimp_IconBar("!task") REM The sprite is loaded from the Wimp sprite pool and REM the value returned is the icon handle. LOCAL icon% wimp%!0=-1 wimp%!4=0 : wimp%!8=0 wimp%!12=68 : wimp%!16=68 wimp%!20=&3002 $(wimp%+24)=Sprite$ SYS "Wimp_CreateIcon",,wimp% TO icon% =icon% : DEF PROCWimp_IconCaret(window%,icon%,chars%) REM|This procedure places the caret in the writeable REM|icon whose number is icon%, contained in the REM|window whose handle is window%. REM| REM|The caret is placed chars% characters to the left. SYS "Wimp_SetCaretPosition",window%,icon%,,,-1,chars% ENDPROC : DEF FNWimp_IconText(window%,icon%) REM The value of this function is a string containing REM the text contents of the INDIRECTED icon whose REM handle is icon% and whose window handle is window% REM REM If icon% is not INDIRECTED an error is generated. wimp%!0=window% : wimp%!4=icon% SYS "Wimp_GetIconState",,wimp% IF ((wimp%!24) AND &100)=0 ERROR 1,"Icon isn't indirected" =$(wimp%!28) : DEF FNWimp_IconValidation(window%,icon%) REM The value of this function is the validation REM string for the icon whose handle is icon% plotted REM in the window whose handle is window%. REM REM See Programmer's Reference Manual page 1184. wimp%!0=window% : wimp%!4=icon% SYS "Wimp_GetIconState",,wimp% IF ((wimp%!24) AND &100)=0 ERROR 1,"Icon isn't indirected" =$(wimp%!32) : DEF PROCWimp_IconDisable(window%,icon%) REM A call to this procedure renders the specified REM icon unable to be selected by clicking with the REM mouse etc. REM [ window%, icon% are the relevant window and icon REM handles ]. wimp%!0=window% : wimp%!4=icon% wimp%!8=1<<22 : wimp%!12=1<<22 SYS "Wimp_SetIconState",,wimp% ENDPROC : DEF PROCWimp_IconEnable(window%,icon%) REM This call has the OPPOSITE effect to the REM IconDisable procedure. REM REM I.e. it enables the relevant icon to be REM selectable. wimp%!0=window% : wimp%!4=icon% wimp%!8=0 : wimp%!12=1<<22 SYS "Wimp_SetIconState",,wimp% ENDPROC : DEF PROCWimp_IconPutText(window%,icon%,text$) REM A call to this procedure places the string given REM by the variable text$ in the INDIRECTED icon whose REM handle is icon%, contained in the window whose REM handle is window%. REM wimp%!0=window% : wimp%!4=icon% SYS "Wimp_GetIconState",,wimp% IF ((wimp%!24) AND &100)=0 ERROR 1,"Icon isn't indirected" $(wimp%!28)=text$ wimp%!0=window% : wimp%!4=icon% wimp%!8=0 : wimp%!12=0 SYS "Wimp_SetIconState",,wimp% ENDPROC REM| The only variable used is wimp%
00000000 44 45 46 20 46 4e 57 69 6d 70 5f 49 63 6f 6e 42 |DEF FNWimp_IconB| 00000010 61 72 28 53 70 72 69 74 65 24 29 0a 52 45 4d 20 |ar(Sprite$).REM | 00000020 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 70 6c |This function pl| 00000030 61 63 65 73 20 74 68 65 20 73 70 72 69 74 65 2c |aces the sprite,| 00000040 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 | specified by th| 00000050 65 0a 52 45 4d 20 76 61 72 69 61 62 6c 65 20 53 |e.REM variable S| 00000060 70 72 69 74 65 24 2c 20 6f 6e 20 74 68 65 20 69 |prite$, on the i| 00000070 63 6f 6e 20 62 61 72 20 28 72 69 67 68 74 29 2e |con bar (right).| 00000080 20 45 2e 67 2e 0a 52 45 4d 20 20 20 20 20 20 20 | E.g..REM | 00000090 20 42 61 72 5f 49 63 6f 6e 25 3d 46 4e 57 69 6d | Bar_Icon%=FNWim| 000000a0 70 5f 49 63 6f 6e 42 61 72 28 22 21 74 61 73 6b |p_IconBar("!task| 000000b0 22 29 0a 52 45 4d 20 54 68 65 20 73 70 72 69 74 |").REM The sprit| 000000c0 65 20 69 73 20 6c 6f 61 64 65 64 20 66 72 6f 6d |e is loaded from| 000000d0 20 74 68 65 20 57 69 6d 70 20 73 70 72 69 74 65 | the Wimp sprite| 000000e0 20 70 6f 6f 6c 20 61 6e 64 0a 52 45 4d 20 74 68 | pool and.REM th| 000000f0 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 |e value returned| 00000100 20 69 73 20 74 68 65 20 69 63 6f 6e 20 68 61 6e | is the icon han| 00000110 64 6c 65 2e 0a 4c 4f 43 41 4c 20 69 63 6f 6e 25 |dle..LOCAL icon%| 00000120 0a 77 69 6d 70 25 21 30 3d 2d 31 0a 77 69 6d 70 |.wimp%!0=-1.wimp| 00000130 25 21 34 3d 30 20 20 20 20 20 3a 20 77 69 6d 70 |%!4=0 : wimp| 00000140 25 21 38 3d 30 0a 77 69 6d 70 25 21 31 32 3d 36 |%!8=0.wimp%!12=6| 00000150 38 20 3a 20 77 69 6d 70 25 21 31 36 3d 36 38 0a |8 : wimp%!16=68.| 00000160 77 69 6d 70 25 21 32 30 3d 26 33 30 30 32 0a 24 |wimp%!20=&3002.$| 00000170 28 77 69 6d 70 25 2b 32 34 29 3d 53 70 72 69 74 |(wimp%+24)=Sprit| 00000180 65 24 0a 53 59 53 20 22 57 69 6d 70 5f 43 72 65 |e$.SYS "Wimp_Cre| 00000190 61 74 65 49 63 6f 6e 22 2c 2c 77 69 6d 70 25 20 |ateIcon",,wimp% | 000001a0 54 4f 20 69 63 6f 6e 25 0a 3d 69 63 6f 6e 25 0a |TO icon%.=icon%.| 000001b0 3a 0a 44 45 46 20 50 52 4f 43 57 69 6d 70 5f 49 |:.DEF PROCWimp_I| 000001c0 63 6f 6e 43 61 72 65 74 28 77 69 6e 64 6f 77 25 |conCaret(window%| 000001d0 2c 69 63 6f 6e 25 2c 63 68 61 72 73 25 29 0a 52 |,icon%,chars%).R| 000001e0 45 4d 7c 54 68 69 73 20 70 72 6f 63 65 64 75 72 |EM|This procedur| 000001f0 65 20 70 6c 61 63 65 73 20 74 68 65 20 63 61 72 |e places the car| 00000200 65 74 20 69 6e 20 74 68 65 20 77 72 69 74 65 61 |et in the writea| 00000210 62 6c 65 0a 52 45 4d 7c 69 63 6f 6e 20 77 68 6f |ble.REM|icon who| 00000220 73 65 20 6e 75 6d 62 65 72 20 69 73 20 69 63 6f |se number is ico| 00000230 6e 25 2c 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e |n%, contained in| 00000240 20 74 68 65 20 0a 52 45 4d 7c 77 69 6e 64 6f 77 | the .REM|window| 00000250 20 77 68 6f 73 65 20 68 61 6e 64 6c 65 20 69 73 | whose handle is| 00000260 20 77 69 6e 64 6f 77 25 2e 0a 52 45 4d 7c 0a 52 | window%..REM|.R| 00000270 45 4d 7c 54 68 65 20 63 61 72 65 74 20 69 73 20 |EM|The caret is | 00000280 70 6c 61 63 65 64 20 63 68 61 72 73 25 20 63 68 |placed chars% ch| 00000290 61 72 61 63 74 65 72 73 20 74 6f 20 74 68 65 20 |aracters to the | 000002a0 6c 65 66 74 2e 0a 53 59 53 20 22 57 69 6d 70 5f |left..SYS "Wimp_| 000002b0 53 65 74 43 61 72 65 74 50 6f 73 69 74 69 6f 6e |SetCaretPosition| 000002c0 22 2c 77 69 6e 64 6f 77 25 2c 69 63 6f 6e 25 2c |",window%,icon%,| 000002d0 2c 2c 2d 31 2c 63 68 61 72 73 25 0a 45 4e 44 50 |,,-1,chars%.ENDP| 000002e0 52 4f 43 0a 3a 0a 44 45 46 20 46 4e 57 69 6d 70 |ROC.:.DEF FNWimp| 000002f0 5f 49 63 6f 6e 54 65 78 74 28 77 69 6e 64 6f 77 |_IconText(window| 00000300 25 2c 69 63 6f 6e 25 29 0a 52 45 4d 20 54 68 65 |%,icon%).REM The| 00000310 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 66 | value of this f| 00000320 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 73 74 72 |unction is a str| 00000330 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 52 |ing containing.R| 00000340 45 4d 20 74 68 65 20 74 65 78 74 20 63 6f 6e 74 |EM the text cont| 00000350 65 6e 74 73 20 6f 66 20 74 68 65 20 49 4e 44 49 |ents of the INDI| 00000360 52 45 43 54 45 44 20 69 63 6f 6e 20 77 68 6f 73 |RECTED icon whos| 00000370 65 0a 52 45 4d 20 68 61 6e 64 6c 65 20 69 73 20 |e.REM handle is | 00000380 69 63 6f 6e 25 20 61 6e 64 20 77 68 6f 73 65 20 |icon% and whose | 00000390 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 69 73 |window handle is| 000003a0 20 77 69 6e 64 6f 77 25 0a 52 45 4d 0a 52 45 4d | window%.REM.REM| 000003b0 20 49 66 20 69 63 6f 6e 25 20 69 73 20 6e 6f 74 | If icon% is not| 000003c0 20 49 4e 44 49 52 45 43 54 45 44 20 61 6e 20 65 | INDIRECTED an e| 000003d0 72 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 65 |rror is generate| 000003e0 64 2e 0a 77 69 6d 70 25 21 30 3d 77 69 6e 64 6f |d..wimp%!0=windo| 000003f0 77 25 20 3a 20 77 69 6d 70 25 21 34 3d 69 63 6f |w% : wimp%!4=ico| 00000400 6e 25 0a 53 59 53 20 22 57 69 6d 70 5f 47 65 74 |n%.SYS "Wimp_Get| 00000410 49 63 6f 6e 53 74 61 74 65 22 2c 2c 77 69 6d 70 |IconState",,wimp| 00000420 25 0a 49 46 20 28 28 77 69 6d 70 25 21 32 34 29 |%.IF ((wimp%!24)| 00000430 20 41 4e 44 20 26 31 30 30 29 3d 30 20 45 52 52 | AND &100)=0 ERR| 00000440 4f 52 20 31 2c 22 49 63 6f 6e 20 69 73 6e 27 74 |OR 1,"Icon isn't| 00000450 20 69 6e 64 69 72 65 63 74 65 64 22 0a 3d 24 28 | indirected".=$(| 00000460 77 69 6d 70 25 21 32 38 29 0a 3a 0a 44 45 46 20 |wimp%!28).:.DEF | 00000470 46 4e 57 69 6d 70 5f 49 63 6f 6e 56 61 6c 69 64 |FNWimp_IconValid| 00000480 61 74 69 6f 6e 28 77 69 6e 64 6f 77 25 2c 69 63 |ation(window%,ic| 00000490 6f 6e 25 29 0a 52 45 4d 20 54 68 65 20 76 61 6c |on%).REM The val| 000004a0 75 65 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74 |ue of this funct| 000004b0 69 6f 6e 20 69 73 20 74 68 65 20 76 61 6c 69 64 |ion is the valid| 000004c0 61 74 69 6f 6e 0a 52 45 4d 20 73 74 72 69 6e 67 |ation.REM string| 000004d0 20 66 6f 72 20 74 68 65 20 69 63 6f 6e 20 77 68 | for the icon wh| 000004e0 6f 73 65 20 68 61 6e 64 6c 65 20 69 73 20 69 63 |ose handle is ic| 000004f0 6f 6e 25 20 70 6c 6f 74 74 65 64 0a 52 45 4d 20 |on% plotted.REM | 00000500 69 6e 20 74 68 65 20 77 69 6e 64 6f 77 20 77 68 |in the window wh| 00000510 6f 73 65 20 68 61 6e 64 6c 65 20 69 73 20 77 69 |ose handle is wi| 00000520 6e 64 6f 77 25 2e 0a 52 45 4d 0a 52 45 4d 20 20 |ndow%..REM.REM | 00000530 20 20 20 20 20 20 53 65 65 20 50 72 6f 67 72 61 | See Progra| 00000540 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 |mmer's Reference| 00000550 20 4d 61 6e 75 61 6c 20 70 61 67 65 20 31 31 38 | Manual page 118| 00000560 34 2e 0a 77 69 6d 70 25 21 30 3d 77 69 6e 64 6f |4..wimp%!0=windo| 00000570 77 25 20 3a 20 77 69 6d 70 25 21 34 3d 69 63 6f |w% : wimp%!4=ico| 00000580 6e 25 0a 53 59 53 20 22 57 69 6d 70 5f 47 65 74 |n%.SYS "Wimp_Get| 00000590 49 63 6f 6e 53 74 61 74 65 22 2c 2c 77 69 6d 70 |IconState",,wimp| 000005a0 25 0a 49 46 20 28 28 77 69 6d 70 25 21 32 34 29 |%.IF ((wimp%!24)| 000005b0 20 41 4e 44 20 26 31 30 30 29 3d 30 20 45 52 52 | AND &100)=0 ERR| 000005c0 4f 52 20 31 2c 22 49 63 6f 6e 20 69 73 6e 27 74 |OR 1,"Icon isn't| 000005d0 20 69 6e 64 69 72 65 63 74 65 64 22 0a 3d 24 28 | indirected".=$(| 000005e0 77 69 6d 70 25 21 33 32 29 0a 3a 0a 44 45 46 20 |wimp%!32).:.DEF | 000005f0 50 52 4f 43 57 69 6d 70 5f 49 63 6f 6e 44 69 73 |PROCWimp_IconDis| 00000600 61 62 6c 65 28 77 69 6e 64 6f 77 25 2c 69 63 6f |able(window%,ico| 00000610 6e 25 29 0a 52 45 4d 20 41 20 63 61 6c 6c 20 74 |n%).REM A call t| 00000620 6f 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 |o this procedure| 00000630 20 72 65 6e 64 65 72 73 20 74 68 65 20 73 70 65 | renders the spe| 00000640 63 69 66 69 65 64 0a 52 45 4d 20 69 63 6f 6e 20 |cified.REM icon | 00000650 75 6e 61 62 6c 65 20 74 6f 20 62 65 20 73 65 6c |unable to be sel| 00000660 65 63 74 65 64 20 62 79 20 63 6c 69 63 6b 69 6e |ected by clickin| 00000670 67 20 77 69 74 68 20 74 68 65 0a 52 45 4d 20 6d |g with the.REM m| 00000680 6f 75 73 65 20 65 74 63 2e 0a 52 45 4d 20 5b 20 |ouse etc..REM [ | 00000690 77 69 6e 64 6f 77 25 2c 20 69 63 6f 6e 25 20 61 |window%, icon% a| 000006a0 72 65 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 |re the relevant | 000006b0 77 69 6e 64 6f 77 20 61 6e 64 20 69 63 6f 6e 0a |window and icon.| 000006c0 52 45 4d 20 20 20 68 61 6e 64 6c 65 73 20 5d 2e |REM handles ].| 000006d0 0a 77 69 6d 70 25 21 30 3d 77 69 6e 64 6f 77 25 |.wimp%!0=window%| 000006e0 20 3a 20 77 69 6d 70 25 21 34 3d 69 63 6f 6e 25 | : wimp%!4=icon%| 000006f0 0a 77 69 6d 70 25 21 38 3d 31 3c 3c 32 32 20 20 |.wimp%!8=1<<22 | 00000700 20 3a 20 77 69 6d 70 25 21 31 32 3d 31 3c 3c 32 | : wimp%!12=1<<2| 00000710 32 0a 53 59 53 20 22 57 69 6d 70 5f 53 65 74 49 |2.SYS "Wimp_SetI| 00000720 63 6f 6e 53 74 61 74 65 22 2c 2c 77 69 6d 70 25 |conState",,wimp%| 00000730 0a 45 4e 44 50 52 4f 43 0a 3a 0a 44 45 46 20 50 |.ENDPROC.:.DEF P| 00000740 52 4f 43 57 69 6d 70 5f 49 63 6f 6e 45 6e 61 62 |ROCWimp_IconEnab| 00000750 6c 65 28 77 69 6e 64 6f 77 25 2c 69 63 6f 6e 25 |le(window%,icon%| 00000760 29 0a 52 45 4d 20 54 68 69 73 20 63 61 6c 6c 20 |).REM This call | 00000770 68 61 73 20 74 68 65 20 4f 50 50 4f 53 49 54 45 |has the OPPOSITE| 00000780 20 65 66 66 65 63 74 20 74 6f 20 74 68 65 0a 52 | effect to the.R| 00000790 45 4d 20 49 63 6f 6e 44 69 73 61 62 6c 65 20 70 |EM IconDisable p| 000007a0 72 6f 63 65 64 75 72 65 2e 0a 52 45 4d 0a 52 45 |rocedure..REM.RE| 000007b0 4d 20 20 20 49 2e 65 2e 20 69 74 20 65 6e 61 62 |M I.e. it enab| 000007c0 6c 65 73 20 74 68 65 20 72 65 6c 65 76 61 6e 74 |les the relevant| 000007d0 20 69 63 6f 6e 20 74 6f 20 62 65 0a 52 45 4d 20 | icon to be.REM | 000007e0 73 65 6c 65 63 74 61 62 6c 65 2e 0a 77 69 6d 70 |selectable..wimp| 000007f0 25 21 30 3d 77 69 6e 64 6f 77 25 20 3a 20 77 69 |%!0=window% : wi| 00000800 6d 70 25 21 34 3d 69 63 6f 6e 25 0a 77 69 6d 70 |mp%!4=icon%.wimp| 00000810 25 21 38 3d 30 20 20 20 20 20 20 20 3a 20 77 69 |%!8=0 : wi| 00000820 6d 70 25 21 31 32 3d 31 3c 3c 32 32 0a 53 59 53 |mp%!12=1<<22.SYS| 00000830 20 22 57 69 6d 70 5f 53 65 74 49 63 6f 6e 53 74 | "Wimp_SetIconSt| 00000840 61 74 65 22 2c 2c 77 69 6d 70 25 0a 45 4e 44 50 |ate",,wimp%.ENDP| 00000850 52 4f 43 0a 3a 0a 44 45 46 20 50 52 4f 43 57 69 |ROC.:.DEF PROCWi| 00000860 6d 70 5f 49 63 6f 6e 50 75 74 54 65 78 74 28 77 |mp_IconPutText(w| 00000870 69 6e 64 6f 77 25 2c 69 63 6f 6e 25 2c 74 65 78 |indow%,icon%,tex| 00000880 74 24 29 0a 52 45 4d 20 41 20 63 61 6c 6c 20 74 |t$).REM A call t| 00000890 6f 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 |o this procedure| 000008a0 20 70 6c 61 63 65 73 20 74 68 65 20 73 74 72 69 | places the stri| 000008b0 6e 67 20 67 69 76 65 6e 0a 52 45 4d 20 62 79 20 |ng given.REM by | 000008c0 74 68 65 20 76 61 72 69 61 62 6c 65 20 74 65 78 |the variable tex| 000008d0 74 24 20 69 6e 20 74 68 65 20 49 4e 44 49 52 45 |t$ in the INDIRE| 000008e0 43 54 45 44 20 69 63 6f 6e 20 77 68 6f 73 65 0a |CTED icon whose.| 000008f0 52 45 4d 20 68 61 6e 64 6c 65 20 69 73 20 69 63 |REM handle is ic| 00000900 6f 6e 25 2c 20 63 6f 6e 74 61 69 6e 65 64 20 69 |on%, contained i| 00000910 6e 20 74 68 65 20 77 69 6e 64 6f 77 20 77 68 6f |n the window who| 00000920 73 65 0a 52 45 4d 20 68 61 6e 64 6c 65 20 69 73 |se.REM handle is| 00000930 20 77 69 6e 64 6f 77 25 2e 0a 52 45 4d 0a 77 69 | window%..REM.wi| 00000940 6d 70 25 21 30 3d 77 69 6e 64 6f 77 25 20 3a 20 |mp%!0=window% : | 00000950 77 69 6d 70 25 21 34 3d 69 63 6f 6e 25 0a 53 59 |wimp%!4=icon%.SY| 00000960 53 20 22 57 69 6d 70 5f 47 65 74 49 63 6f 6e 53 |S "Wimp_GetIconS| 00000970 74 61 74 65 22 2c 2c 77 69 6d 70 25 0a 49 46 20 |tate",,wimp%.IF | 00000980 28 28 77 69 6d 70 25 21 32 34 29 20 41 4e 44 20 |((wimp%!24) AND | 00000990 26 31 30 30 29 3d 30 20 45 52 52 4f 52 20 31 2c |&100)=0 ERROR 1,| 000009a0 22 49 63 6f 6e 20 69 73 6e 27 74 20 69 6e 64 69 |"Icon isn't indi| 000009b0 72 65 63 74 65 64 22 0a 24 28 77 69 6d 70 25 21 |rected".$(wimp%!| 000009c0 32 38 29 3d 74 65 78 74 24 0a 77 69 6d 70 25 21 |28)=text$.wimp%!| 000009d0 30 3d 77 69 6e 64 6f 77 25 20 3a 20 77 69 6d 70 |0=window% : wimp| 000009e0 25 21 34 3d 69 63 6f 6e 25 0a 77 69 6d 70 25 21 |%!4=icon%.wimp%!| 000009f0 38 3d 30 20 3a 20 77 69 6d 70 25 21 31 32 3d 30 |8=0 : wimp%!12=0| 00000a00 0a 53 59 53 20 22 57 69 6d 70 5f 53 65 74 49 63 |.SYS "Wimp_SetIc| 00000a10 6f 6e 53 74 61 74 65 22 2c 2c 77 69 6d 70 25 0a |onState",,wimp%.| 00000a20 45 4e 44 50 52 4f 43 0a 52 45 4d 7c 20 54 68 65 |ENDPROC.REM| The| 00000a30 20 6f 6e 6c 79 20 76 61 72 69 61 62 6c 65 20 75 | only variable u| 00000a40 73 65 64 20 69 73 20 20 77 69 6d 70 25 0a |sed is wimp%.| 00000a4e