Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/StrongHlp/Interface/HelpData

Shareware/Event/Documents/!EShellDoc/StrongHlp/Interface/HelpData

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 » Acorn Computing » 1994 08 subscription disc.adf » 9408s
Filename: Shareware/Event/Documents/!EShellDoc/StrongHlp/Interface/HelpData
Read OK:
File size: 0CE5 bytes
Load address: 0000
Exec address: 0000
File contents
Interface manager vsn 2.00
(c) 1990-1992, software interrupt developments
<Simon Huntington=>EvntShell.Huntingdon>
all rights reserved
copyright belongs to software interrupt at all times.

You are free to use interface in any commercial products
free of charge.  If you feel the need to send any money
to me (thanks in advance).

#Table 11 30
<Wimp_BorderIcon                =>SlabButton>
<Wimp_BorderWindow              =>Render3DWindow>
<Wimp_ClaimInterface            =>Initialise>
<Wimp_ReleaseInterface          >
<Wimp_SetWorkareaPointer        >
<Wimp_RemoveWorkareaPointer     >
<Wimp_PollPointer               >
<Wimp_SendInformation           >
<Wimp_PreProcessKey             >
<Wimp_BorderPlotIcon            >
<Wimp_BorderBoundingBox         >
<Interface_SlabButton           =>SlabButton>
<Interface_Render3dWindow       =>Render3DWindow>
<Interface_Initialise           =>Initialise>
<Interface_CloseDown            >
<Interface_SetWorkareaPointer   >
<Interface_RemoveWorkareaPointer>
<Interface_Poll                 >
<Interface_SendHelp             >
<Interface_PreProcessKey        >
<Interface_Plot3dIcon           >
<Interface_BoundingBox          >
#EndTableWimp_BorderIcon/Interface_SlabButton (&81680)
 => R1 = pointer to block

 \<= R1 preserved

The block contains the following on entry:

#Indent 4
R1+0    mouse x (screen coordinates -
        not window relative)
R1+4    mouse y
R1+8    buttons (depending on icon button type)
R1+12   window handle
R1+16   icon handle
#Indent 0

This call is used to update an icons border.  It is
typically called as a result of a Mouse_Click event, if
the icon has a border type of 0 or 2 then the icon will
slab inwards.

The application should the perform the task and then force
the icon to normal status by calling Wimp_BorderIcon
(SWI &81680) with R1+8 set to 0.

Note that the mouse coordinates specified in R1+0 and R1+4
are not used by the SWI and are only present to make the
block compatible with a Mouse_Click event block.Wimp_BorderWindow/Interface_Render3DWindow (&81681)
 => R1 = pointer to block

 \<= R1 preserved

The block contains the following on entry:

#Indent 4
R1+0    window handle
R1+4    visible area minimum x coordinate
R1+8    visible area minimum y coordinate
R1+12   visible area maximum x coordinate
R1+16   visible area maximum y coordinate
R1+20   scroll x offset relative to work area origin
R1+24   scroll y offset relative to work area origin
R1+28   current graphics window minimum x coordinate
R1+32   current graphics window minimum y coordinate
R1+36   current graphics window maximum x coordinate
R1+40   current graphics window maximum y coordinate
#Indent 0

This call is used to redraw the borders of icons in the
window that are not up-to-date, this SWI is typically
called during the redraw loop of a window.  The SWI will
update the window, drawing borders around any icons which
have the b command specified in the validation string and
are within the specified graphics window.Wimp_ClaimInterface/Interface_Initialise (&81682)
 => R0 = task handle

 \<= R0 preserved

This SWI allows your application to use pointers via
the Interface module.  This SWI should be called at
the beginning of your program.  If you don't use
Wimp_ClaimInterface then your pointers will not be
displayed.
00000000  49 6e 74 65 72 66 61 63  65 20 6d 61 6e 61 67 65  |Interface manage|
00000010  72 20 76 73 6e 20 32 2e  30 30 0a 28 63 29 20 31  |r vsn 2.00.(c) 1|
00000020  39 39 30 2d 31 39 39 32  2c 20 73 6f 66 74 77 61  |990-1992, softwa|
00000030  72 65 20 69 6e 74 65 72  72 75 70 74 20 64 65 76  |re interrupt dev|
00000040  65 6c 6f 70 6d 65 6e 74  73 0a 3c 53 69 6d 6f 6e  |elopments.<Simon|
00000050  20 48 75 6e 74 69 6e 67  74 6f 6e 3d 3e 45 76 6e  | Huntington=>Evn|
00000060  74 53 68 65 6c 6c 2e 48  75 6e 74 69 6e 67 64 6f  |tShell.Huntingdo|
00000070  6e 3e 0a 61 6c 6c 20 72  69 67 68 74 73 20 72 65  |n>.all rights re|
00000080  73 65 72 76 65 64 0a 63  6f 70 79 72 69 67 68 74  |served.copyright|
00000090  20 62 65 6c 6f 6e 67 73  20 74 6f 20 73 6f 66 74  | belongs to soft|
000000a0  77 61 72 65 20 69 6e 74  65 72 72 75 70 74 20 61  |ware interrupt a|
000000b0  74 20 61 6c 6c 20 74 69  6d 65 73 2e 0a 0a 59 6f  |t all times...Yo|
000000c0  75 20 61 72 65 20 66 72  65 65 20 74 6f 20 75 73  |u are free to us|
000000d0  65 20 69 6e 74 65 72 66  61 63 65 20 69 6e 20 61  |e interface in a|
000000e0  6e 79 20 63 6f 6d 6d 65  72 63 69 61 6c 20 70 72  |ny commercial pr|
000000f0  6f 64 75 63 74 73 0a 66  72 65 65 20 6f 66 20 63  |oducts.free of c|
00000100  68 61 72 67 65 2e 20 20  49 66 20 79 6f 75 20 66  |harge.  If you f|
00000110  65 65 6c 20 74 68 65 20  6e 65 65 64 20 74 6f 20  |eel the need to |
00000120  73 65 6e 64 20 61 6e 79  20 6d 6f 6e 65 79 0a 74  |send any money.t|
00000130  6f 20 6d 65 20 28 74 68  61 6e 6b 73 20 69 6e 20  |o me (thanks in |
00000140  61 64 76 61 6e 63 65 29  2e 0a 0a 23 54 61 62 6c  |advance)...#Tabl|
00000150  65 20 31 31 20 33 30 0a  3c 57 69 6d 70 5f 42 6f  |e 11 30.<Wimp_Bo|
00000160  72 64 65 72 49 63 6f 6e  20 20 20 20 20 20 20 20  |rderIcon        |
00000170  20 20 20 20 20 20 20 20  3d 3e 53 6c 61 62 42 75  |        =>SlabBu|
00000180  74 74 6f 6e 3e 0a 3c 57  69 6d 70 5f 42 6f 72 64  |tton>.<Wimp_Bord|
00000190  65 72 57 69 6e 64 6f 77  20 20 20 20 20 20 20 20  |erWindow        |
000001a0  20 20 20 20 20 20 3d 3e  52 65 6e 64 65 72 33 44  |      =>Render3D|
000001b0  57 69 6e 64 6f 77 3e 0a  3c 57 69 6d 70 5f 43 6c  |Window>.<Wimp_Cl|
000001c0  61 69 6d 49 6e 74 65 72  66 61 63 65 20 20 20 20  |aimInterface    |
000001d0  20 20 20 20 20 20 20 20  3d 3e 49 6e 69 74 69 61  |        =>Initia|
000001e0  6c 69 73 65 3e 0a 3c 57  69 6d 70 5f 52 65 6c 65  |lise>.<Wimp_Rele|
000001f0  61 73 65 49 6e 74 65 72  66 61 63 65 20 20 20 20  |aseInterface    |
00000200  20 20 20 20 20 20 3e 0a  3c 57 69 6d 70 5f 53 65  |      >.<Wimp_Se|
00000210  74 57 6f 72 6b 61 72 65  61 50 6f 69 6e 74 65 72  |tWorkareaPointer|
00000220  20 20 20 20 20 20 20 20  3e 0a 3c 57 69 6d 70 5f  |        >.<Wimp_|
00000230  52 65 6d 6f 76 65 57 6f  72 6b 61 72 65 61 50 6f  |RemoveWorkareaPo|
00000240  69 6e 74 65 72 20 20 20  20 20 3e 0a 3c 57 69 6d  |inter     >.<Wim|
00000250  70 5f 50 6f 6c 6c 50 6f  69 6e 74 65 72 20 20 20  |p_PollPointer   |
00000260  20 20 20 20 20 20 20 20  20 20 20 20 3e 0a 3c 57  |            >.<W|
00000270  69 6d 70 5f 53 65 6e 64  49 6e 66 6f 72 6d 61 74  |imp_SendInformat|
00000280  69 6f 6e 20 20 20 20 20  20 20 20 20 20 20 3e 0a  |ion           >.|
00000290  3c 57 69 6d 70 5f 50 72  65 50 72 6f 63 65 73 73  |<Wimp_PreProcess|
000002a0  4b 65 79 20 20 20 20 20  20 20 20 20 20 20 20 20  |Key             |
000002b0  3e 0a 3c 57 69 6d 70 5f  42 6f 72 64 65 72 50 6c  |>.<Wimp_BorderPl|
000002c0  6f 74 49 63 6f 6e 20 20  20 20 20 20 20 20 20 20  |otIcon          |
000002d0  20 20 3e 0a 3c 57 69 6d  70 5f 42 6f 72 64 65 72  |  >.<Wimp_Border|
000002e0  42 6f 75 6e 64 69 6e 67  42 6f 78 20 20 20 20 20  |BoundingBox     |
000002f0  20 20 20 20 3e 0a 3c 49  6e 74 65 72 66 61 63 65  |    >.<Interface|
00000300  5f 53 6c 61 62 42 75 74  74 6f 6e 20 20 20 20 20  |_SlabButton     |
00000310  20 20 20 20 20 20 3d 3e  53 6c 61 62 42 75 74 74  |      =>SlabButt|
00000320  6f 6e 3e 0a 3c 49 6e 74  65 72 66 61 63 65 5f 52  |on>.<Interface_R|
00000330  65 6e 64 65 72 33 64 57  69 6e 64 6f 77 20 20 20  |ender3dWindow   |
00000340  20 20 20 20 3d 3e 52 65  6e 64 65 72 33 44 57 69  |    =>Render3DWi|
00000350  6e 64 6f 77 3e 0a 3c 49  6e 74 65 72 66 61 63 65  |ndow>.<Interface|
00000360  5f 49 6e 69 74 69 61 6c  69 73 65 20 20 20 20 20  |_Initialise     |
00000370  20 20 20 20 20 20 3d 3e  49 6e 69 74 69 61 6c 69  |      =>Initiali|
00000380  73 65 3e 0a 3c 49 6e 74  65 72 66 61 63 65 5f 43  |se>.<Interface_C|
00000390  6c 6f 73 65 44 6f 77 6e  20 20 20 20 20 20 20 20  |loseDown        |
000003a0  20 20 20 20 3e 0a 3c 49  6e 74 65 72 66 61 63 65  |    >.<Interface|
000003b0  5f 53 65 74 57 6f 72 6b  61 72 65 61 50 6f 69 6e  |_SetWorkareaPoin|
000003c0  74 65 72 20 20 20 3e 0a  3c 49 6e 74 65 72 66 61  |ter   >.<Interfa|
000003d0  63 65 5f 52 65 6d 6f 76  65 57 6f 72 6b 61 72 65  |ce_RemoveWorkare|
000003e0  61 50 6f 69 6e 74 65 72  3e 0a 3c 49 6e 74 65 72  |aPointer>.<Inter|
000003f0  66 61 63 65 5f 50 6f 6c  6c 20 20 20 20 20 20 20  |face_Poll       |
00000400  20 20 20 20 20 20 20 20  20 20 3e 0a 3c 49 6e 74  |          >.<Int|
00000410  65 72 66 61 63 65 5f 53  65 6e 64 48 65 6c 70 20  |erface_SendHelp |
00000420  20 20 20 20 20 20 20 20  20 20 20 20 3e 0a 3c 49  |            >.<I|
00000430  6e 74 65 72 66 61 63 65  5f 50 72 65 50 72 6f 63  |nterface_PreProc|
00000440  65 73 73 4b 65 79 20 20  20 20 20 20 20 20 3e 0a  |essKey        >.|
00000450  3c 49 6e 74 65 72 66 61  63 65 5f 50 6c 6f 74 33  |<Interface_Plot3|
00000460  64 49 63 6f 6e 20 20 20  20 20 20 20 20 20 20 20  |dIcon           |
00000470  3e 0a 3c 49 6e 74 65 72  66 61 63 65 5f 42 6f 75  |>.<Interface_Bou|
00000480  6e 64 69 6e 67 42 6f 78  20 20 20 20 20 20 20 20  |ndingBox        |
00000490  20 20 3e 0a 23 45 6e 64  54 61 62 6c 65 57 69 6d  |  >.#EndTableWim|
000004a0  70 5f 42 6f 72 64 65 72  49 63 6f 6e 2f 49 6e 74  |p_BorderIcon/Int|
000004b0  65 72 66 61 63 65 5f 53  6c 61 62 42 75 74 74 6f  |erface_SlabButto|
000004c0  6e 20 28 26 38 31 36 38  30 29 0a 20 3d 3e 20 52  |n (&81680). => R|
000004d0  31 20 3d 20 70 6f 69 6e  74 65 72 20 74 6f 20 62  |1 = pointer to b|
000004e0  6c 6f 63 6b 0a 0a 20 5c  3c 3d 20 52 31 20 70 72  |lock.. \<= R1 pr|
000004f0  65 73 65 72 76 65 64 0a  0a 54 68 65 20 62 6c 6f  |eserved..The blo|
00000500  63 6b 20 63 6f 6e 74 61  69 6e 73 20 74 68 65 20  |ck contains the |
00000510  66 6f 6c 6c 6f 77 69 6e  67 20 6f 6e 20 65 6e 74  |following on ent|
00000520  72 79 3a 0a 0a 23 49 6e  64 65 6e 74 20 34 0a 52  |ry:..#Indent 4.R|
00000530  31 2b 30 20 20 20 20 6d  6f 75 73 65 20 78 20 28  |1+0    mouse x (|
00000540  73 63 72 65 65 6e 20 63  6f 6f 72 64 69 6e 61 74  |screen coordinat|
00000550  65 73 20 2d 0a 20 20 20  20 20 20 20 20 6e 6f 74  |es -.        not|
00000560  20 77 69 6e 64 6f 77 20  72 65 6c 61 74 69 76 65  | window relative|
00000570  29 0a 52 31 2b 34 20 20  20 20 6d 6f 75 73 65 20  |).R1+4    mouse |
00000580  79 0a 52 31 2b 38 20 20  20 20 62 75 74 74 6f 6e  |y.R1+8    button|
00000590  73 20 28 64 65 70 65 6e  64 69 6e 67 20 6f 6e 20  |s (depending on |
000005a0  69 63 6f 6e 20 62 75 74  74 6f 6e 20 74 79 70 65  |icon button type|
000005b0  29 0a 52 31 2b 31 32 20  20 20 77 69 6e 64 6f 77  |).R1+12   window|
000005c0  20 68 61 6e 64 6c 65 0a  52 31 2b 31 36 20 20 20  | handle.R1+16   |
000005d0  69 63 6f 6e 20 68 61 6e  64 6c 65 0a 23 49 6e 64  |icon handle.#Ind|
000005e0  65 6e 74 20 30 0a 0a 54  68 69 73 20 63 61 6c 6c  |ent 0..This call|
000005f0  20 69 73 20 75 73 65 64  20 74 6f 20 75 70 64 61  | is used to upda|
00000600  74 65 20 61 6e 20 69 63  6f 6e 73 20 62 6f 72 64  |te an icons bord|
00000610  65 72 2e 20 20 49 74 20  69 73 0a 74 79 70 69 63  |er.  It is.typic|
00000620  61 6c 6c 79 20 63 61 6c  6c 65 64 20 61 73 20 61  |ally called as a|
00000630  20 72 65 73 75 6c 74 20  6f 66 20 61 20 4d 6f 75  | result of a Mou|
00000640  73 65 5f 43 6c 69 63 6b  20 65 76 65 6e 74 2c 20  |se_Click event, |
00000650  69 66 0a 74 68 65 20 69  63 6f 6e 20 68 61 73 20  |if.the icon has |
00000660  61 20 62 6f 72 64 65 72  20 74 79 70 65 20 6f 66  |a border type of|
00000670  20 30 20 6f 72 20 32 20  74 68 65 6e 20 74 68 65  | 0 or 2 then the|
00000680  20 69 63 6f 6e 20 77 69  6c 6c 0a 73 6c 61 62 20  | icon will.slab |
00000690  69 6e 77 61 72 64 73 2e  0a 0a 54 68 65 20 61 70  |inwards...The ap|
000006a0  70 6c 69 63 61 74 69 6f  6e 20 73 68 6f 75 6c 64  |plication should|
000006b0  20 74 68 65 20 70 65 72  66 6f 72 6d 20 74 68 65  | the perform the|
000006c0  20 74 61 73 6b 20 61 6e  64 20 74 68 65 6e 20 66  | task and then f|
000006d0  6f 72 63 65 0a 74 68 65  20 69 63 6f 6e 20 74 6f  |orce.the icon to|
000006e0  20 6e 6f 72 6d 61 6c 20  73 74 61 74 75 73 20 62  | normal status b|
000006f0  79 20 63 61 6c 6c 69 6e  67 20 57 69 6d 70 5f 42  |y calling Wimp_B|
00000700  6f 72 64 65 72 49 63 6f  6e 0a 28 53 57 49 20 26  |orderIcon.(SWI &|
00000710  38 31 36 38 30 29 20 77  69 74 68 20 52 31 2b 38  |81680) with R1+8|
00000720  20 73 65 74 20 74 6f 20  30 2e 0a 0a 4e 6f 74 65  | set to 0...Note|
00000730  20 74 68 61 74 20 74 68  65 20 6d 6f 75 73 65 20  | that the mouse |
00000740  63 6f 6f 72 64 69 6e 61  74 65 73 20 73 70 65 63  |coordinates spec|
00000750  69 66 69 65 64 20 69 6e  20 52 31 2b 30 20 61 6e  |ified in R1+0 an|
00000760  64 20 52 31 2b 34 0a 61  72 65 20 6e 6f 74 20 75  |d R1+4.are not u|
00000770  73 65 64 20 62 79 20 74  68 65 20 53 57 49 20 61  |sed by the SWI a|
00000780  6e 64 20 61 72 65 20 6f  6e 6c 79 20 70 72 65 73  |nd are only pres|
00000790  65 6e 74 20 74 6f 20 6d  61 6b 65 20 74 68 65 0a  |ent to make the.|
000007a0  62 6c 6f 63 6b 20 63 6f  6d 70 61 74 69 62 6c 65  |block compatible|
000007b0  20 77 69 74 68 20 61 20  4d 6f 75 73 65 5f 43 6c  | with a Mouse_Cl|
000007c0  69 63 6b 20 65 76 65 6e  74 20 62 6c 6f 63 6b 2e  |ick event block.|
000007d0  57 69 6d 70 5f 42 6f 72  64 65 72 57 69 6e 64 6f  |Wimp_BorderWindo|
000007e0  77 2f 49 6e 74 65 72 66  61 63 65 5f 52 65 6e 64  |w/Interface_Rend|
000007f0  65 72 33 44 57 69 6e 64  6f 77 20 28 26 38 31 36  |er3DWindow (&816|
00000800  38 31 29 0a 20 3d 3e 20  52 31 20 3d 20 70 6f 69  |81). => R1 = poi|
00000810  6e 74 65 72 20 74 6f 20  62 6c 6f 63 6b 0a 0a 20  |nter to block.. |
00000820  5c 3c 3d 20 52 31 20 70  72 65 73 65 72 76 65 64  |\<= R1 preserved|
00000830  0a 0a 54 68 65 20 62 6c  6f 63 6b 20 63 6f 6e 74  |..The block cont|
00000840  61 69 6e 73 20 74 68 65  20 66 6f 6c 6c 6f 77 69  |ains the followi|
00000850  6e 67 20 6f 6e 20 65 6e  74 72 79 3a 0a 0a 23 49  |ng on entry:..#I|
00000860  6e 64 65 6e 74 20 34 0a  52 31 2b 30 20 20 20 20  |ndent 4.R1+0    |
00000870  77 69 6e 64 6f 77 20 68  61 6e 64 6c 65 0a 52 31  |window handle.R1|
00000880  2b 34 20 20 20 20 76 69  73 69 62 6c 65 20 61 72  |+4    visible ar|
00000890  65 61 20 6d 69 6e 69 6d  75 6d 20 78 20 63 6f 6f  |ea minimum x coo|
000008a0  72 64 69 6e 61 74 65 0a  52 31 2b 38 20 20 20 20  |rdinate.R1+8    |
000008b0  76 69 73 69 62 6c 65 20  61 72 65 61 20 6d 69 6e  |visible area min|
000008c0  69 6d 75 6d 20 79 20 63  6f 6f 72 64 69 6e 61 74  |imum y coordinat|
000008d0  65 0a 52 31 2b 31 32 20  20 20 76 69 73 69 62 6c  |e.R1+12   visibl|
000008e0  65 20 61 72 65 61 20 6d  61 78 69 6d 75 6d 20 78  |e area maximum x|
000008f0  20 63 6f 6f 72 64 69 6e  61 74 65 0a 52 31 2b 31  | coordinate.R1+1|
00000900  36 20 20 20 76 69 73 69  62 6c 65 20 61 72 65 61  |6   visible area|
00000910  20 6d 61 78 69 6d 75 6d  20 79 20 63 6f 6f 72 64  | maximum y coord|
00000920  69 6e 61 74 65 0a 52 31  2b 32 30 20 20 20 73 63  |inate.R1+20   sc|
00000930  72 6f 6c 6c 20 78 20 6f  66 66 73 65 74 20 72 65  |roll x offset re|
00000940  6c 61 74 69 76 65 20 74  6f 20 77 6f 72 6b 20 61  |lative to work a|
00000950  72 65 61 20 6f 72 69 67  69 6e 0a 52 31 2b 32 34  |rea origin.R1+24|
00000960  20 20 20 73 63 72 6f 6c  6c 20 79 20 6f 66 66 73  |   scroll y offs|
00000970  65 74 20 72 65 6c 61 74  69 76 65 20 74 6f 20 77  |et relative to w|
00000980  6f 72 6b 20 61 72 65 61  20 6f 72 69 67 69 6e 0a  |ork area origin.|
00000990  52 31 2b 32 38 20 20 20  63 75 72 72 65 6e 74 20  |R1+28   current |
000009a0  67 72 61 70 68 69 63 73  20 77 69 6e 64 6f 77 20  |graphics window |
000009b0  6d 69 6e 69 6d 75 6d 20  78 20 63 6f 6f 72 64 69  |minimum x coordi|
000009c0  6e 61 74 65 0a 52 31 2b  33 32 20 20 20 63 75 72  |nate.R1+32   cur|
000009d0  72 65 6e 74 20 67 72 61  70 68 69 63 73 20 77 69  |rent graphics wi|
000009e0  6e 64 6f 77 20 6d 69 6e  69 6d 75 6d 20 79 20 63  |ndow minimum y c|
000009f0  6f 6f 72 64 69 6e 61 74  65 0a 52 31 2b 33 36 20  |oordinate.R1+36 |
00000a00  20 20 63 75 72 72 65 6e  74 20 67 72 61 70 68 69  |  current graphi|
00000a10  63 73 20 77 69 6e 64 6f  77 20 6d 61 78 69 6d 75  |cs window maximu|
00000a20  6d 20 78 20 63 6f 6f 72  64 69 6e 61 74 65 0a 52  |m x coordinate.R|
00000a30  31 2b 34 30 20 20 20 63  75 72 72 65 6e 74 20 67  |1+40   current g|
00000a40  72 61 70 68 69 63 73 20  77 69 6e 64 6f 77 20 6d  |raphics window m|
00000a50  61 78 69 6d 75 6d 20 79  20 63 6f 6f 72 64 69 6e  |aximum y coordin|
00000a60  61 74 65 0a 23 49 6e 64  65 6e 74 20 30 0a 0a 54  |ate.#Indent 0..T|
00000a70  68 69 73 20 63 61 6c 6c  20 69 73 20 75 73 65 64  |his call is used|
00000a80  20 74 6f 20 72 65 64 72  61 77 20 74 68 65 20 62  | to redraw the b|
00000a90  6f 72 64 65 72 73 20 6f  66 20 69 63 6f 6e 73 20  |orders of icons |
00000aa0  69 6e 20 74 68 65 0a 77  69 6e 64 6f 77 20 74 68  |in the.window th|
00000ab0  61 74 20 61 72 65 20 6e  6f 74 20 75 70 2d 74 6f  |at are not up-to|
00000ac0  2d 64 61 74 65 2c 20 74  68 69 73 20 53 57 49 20  |-date, this SWI |
00000ad0  69 73 20 74 79 70 69 63  61 6c 6c 79 0a 63 61 6c  |is typically.cal|
00000ae0  6c 65 64 20 64 75 72 69  6e 67 20 74 68 65 20 72  |led during the r|
00000af0  65 64 72 61 77 20 6c 6f  6f 70 20 6f 66 20 61 20  |edraw loop of a |
00000b00  77 69 6e 64 6f 77 2e 20  20 54 68 65 20 53 57 49  |window.  The SWI|
00000b10  20 77 69 6c 6c 0a 75 70  64 61 74 65 20 74 68 65  | will.update the|
00000b20  20 77 69 6e 64 6f 77 2c  20 64 72 61 77 69 6e 67  | window, drawing|
00000b30  20 62 6f 72 64 65 72 73  20 61 72 6f 75 6e 64 20  | borders around |
00000b40  61 6e 79 20 69 63 6f 6e  73 20 77 68 69 63 68 0a  |any icons which.|
00000b50  68 61 76 65 20 74 68 65  20 62 20 63 6f 6d 6d 61  |have the b comma|
00000b60  6e 64 20 73 70 65 63 69  66 69 65 64 20 69 6e 20  |nd specified in |
00000b70  74 68 65 20 76 61 6c 69  64 61 74 69 6f 6e 20 73  |the validation s|
00000b80  74 72 69 6e 67 20 61 6e  64 0a 61 72 65 20 77 69  |tring and.are wi|
00000b90  74 68 69 6e 20 74 68 65  20 73 70 65 63 69 66 69  |thin the specifi|
00000ba0  65 64 20 67 72 61 70 68  69 63 73 20 77 69 6e 64  |ed graphics wind|
00000bb0  6f 77 2e 57 69 6d 70 5f  43 6c 61 69 6d 49 6e 74  |ow.Wimp_ClaimInt|
00000bc0  65 72 66 61 63 65 2f 49  6e 74 65 72 66 61 63 65  |erface/Interface|
00000bd0  5f 49 6e 69 74 69 61 6c  69 73 65 20 28 26 38 31  |_Initialise (&81|
00000be0  36 38 32 29 0a 20 3d 3e  20 52 30 20 3d 20 74 61  |682). => R0 = ta|
00000bf0  73 6b 20 68 61 6e 64 6c  65 0a 0a 20 5c 3c 3d 20  |sk handle.. \<= |
00000c00  52 30 20 70 72 65 73 65  72 76 65 64 0a 0a 54 68  |R0 preserved..Th|
00000c10  69 73 20 53 57 49 20 61  6c 6c 6f 77 73 20 79 6f  |is SWI allows yo|
00000c20  75 72 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 74  |ur application t|
00000c30  6f 20 75 73 65 20 70 6f  69 6e 74 65 72 73 20 76  |o use pointers v|
00000c40  69 61 0a 74 68 65 20 49  6e 74 65 72 66 61 63 65  |ia.the Interface|
00000c50  20 6d 6f 64 75 6c 65 2e  20 20 54 68 69 73 20 53  | module.  This S|
00000c60  57 49 20 73 68 6f 75 6c  64 20 62 65 20 63 61 6c  |WI should be cal|
00000c70  6c 65 64 20 61 74 0a 74  68 65 20 62 65 67 69 6e  |led at.the begin|
00000c80  6e 69 6e 67 20 6f 66 20  79 6f 75 72 20 70 72 6f  |ning of your pro|
00000c90  67 72 61 6d 2e 20 20 49  66 20 79 6f 75 20 64 6f  |gram.  If you do|
00000ca0  6e 27 74 20 75 73 65 0a  57 69 6d 70 5f 43 6c 61  |n't use.Wimp_Cla|
00000cb0  69 6d 49 6e 74 65 72 66  61 63 65 20 74 68 65 6e  |imInterface then|
00000cc0  20 79 6f 75 72 20 70 6f  69 6e 74 65 72 73 20 77  | your pointers w|
00000cd0  69 6c 6c 20 6e 6f 74 20  62 65 0a 64 69 73 70 6c  |ill not be.displ|
00000ce0  61 79 65 64 2e                                    |ayed.|
00000ce5