home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / a093_1 / !Interface / !Help < prev    next >
Text File  |  1980-02-08  |  25KB  |  655 lines
  1. *********************  Interface 1.32 (c) Simon Huntington ******************* 
  2.  
  3.  
  4. *********************************************************************************
  5. *********************************************************************************
  6. *********************************************************************************
  7. *********************************************************************************
  8. *                                                                               *
  9. * Modification : You now pass the task handle in R2 when using Wimp_PollPointer *
  10. *                                                                               *
  11. * Shading is now done with the light from the top left as in Impression II      *
  12. *                                                                               *
  13. *********************************************************************************
  14. *********************************************************************************
  15. *********************************************************************************
  16. *********************************************************************************
  17.  
  18. © Software Interrupt 1990
  19.  
  20.  
  21. This manual and software is public domain.  It may be copied and distributed freely 
  22. as long as:
  23.  
  24.        It is not separated from the documentation (except for commercial use)
  25.        The module is not tampered with
  26.        You do not claim that you have written the module
  27.  
  28. If you wish to use this in a commercial product please contact me so that I can make 
  29. sure you have the latest release, please send a disk.
  30.  
  31. In no circumstances shall the author be liable for any damage, loss of profits, time or 
  32. data or any indirect or consequential loss rising out of the use of this software or 
  33. inability to use this software.
  34.  
  35. Contacts:
  36.        Arcade BBS          (081 654 2212)                   
  37.        The World Of Cryton (0749 679794)     
  38.        Charron BBS         (0420 63115)
  39.        Noah BBS            (0272 572322)
  40.        MegaNet             (0924 223456)
  41.  
  42.        All mail on the above Bulletin Bords should be mailed to JICK
  43.  
  44.  
  45. A version of this document in Impression format can be obtained by sending a 
  46. blank disc and return postage to me.  I will also stick on a modified Formed
  47. to display Interface windows
  48.  
  49.  
  50. All correspondence should be addressed to:
  51.  
  52.         SoftWare Interrupt
  53.         40 Castle Ings Gardens
  54.         New Farnley
  55.         Leeds
  56.         LS12 5EG
  57.  
  58.  
  59. **************** Introduction ***********************************************
  60.  
  61. Interface is a small module that allows application programmers to implement a 
  62. colourful and pleasant graphical user interface.  Interface provides many more 
  63. functions that allows you to change the pointer shape easily and to interface with the 
  64. !Help or !Spy application.
  65.  
  66. The Interface module provides functions to improve the friendliness and appearance 
  67. of the application. The application should still operate as stated in  the Acorn 
  68. guidelines in the Programmers Reference Manuals.
  69.  
  70. The module implements a number of SWIs which are described further in this 
  71. manual, these SWI calls can be called from any language.  Most of the functions 
  72. provided are specified in the icons validation string, and so no complex 
  73. programming is needed to make the application look good.
  74.  
  75. This guide tells you how to fully implement the features of Interface.  It is split into 
  76. the follow sections:
  77.  
  78.         The first section explains the validation strings options provided
  79.         by Interface.
  80.         The next section gives details of the SWI calls provided.
  81.         The remaining section covers hints and tips on programming.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88. **************** Technical details ***********************************************
  89.  
  90. An indirected text icon can have a validation string which is used to pass further 
  91. information to the WIMP, such as what border type the icon has and also what 
  92. pointer, if any should be displayed whilst over this icon.  The syntax of a validation 
  93. string is:
  94.  
  95.   validation string ::- command {;command}*
  96.   command           ::- b border-type {border-spec} | 
  97.                         r on/off-type {,icon-number}* |
  98.                         u on/off-type {,icon-number}* |
  99.                         p text-string {,x} {,y} |
  100.                         i text-string   
  101.   border-spec       ::- {,button-slabbing-mask} {,slabbing-time} {,colour}*
  102.  
  103. The parameters above are described under the relevant validation command.
  104. In simple terms, a validation string consists of a series of 'commands', each starting 
  105. with a single letter and seperated from the following command by a semi-colon.  
  106. {}* means zero or more of the thing inside the {}.  The following commands are 
  107. available with the Interface module.
  108.  
  109. These commands are provided in addition to the standard Wimp validation strings.  
  110. I suggest that you edit the !FormEd program to allow you to enter larger validation 
  111. strings, otherwise when entering a help command you will only be allowed a 
  112. maximum of 80 characters.
  113.  
  114. The (B)order command tells Interface which border to use when rendering an icon.  
  115. The border types available at present are :
  116.  
  117.         border type 0, this is a single border used mainly for headings and action icons.
  118.         The icon will slab inwards if the user clicks a button whilst the pointer is over 
  119.         the icon providing it is not setup to ignore mouse clicks.
  120.  
  121.         border type 1, this is a double border and should be used to group together 
  122.         icons that perform an operation.
  123.  
  124.         border type 2, this is a triple border and should be used on the default action         
  125.         button.  The icon will slab inwards when the user clicks a button whilst the 
  126.         pointer is over this icon providing it is not setup to ignore mouse clicks.
  127.  
  128.         border type 3, this is a wide inverted border and should be used on writable
  129.         icons.  This border type is usually used in-conjunction with the writable
  130.         pointer.
  131.  
  132. The second optional parameter is the button slabbing mask, this states whether the 
  133. icon should be slabbed until the button is released.  The values contained in this 
  134. parameter can be from 0 to 7.  The button slabbing mask can be calculated in the 
  135. following way:
  136.  
  137.         Value   Button          Meaning
  138.         1       Adjust  slab icon until adjust is released
  139.         2       Menu    slab icon until menu is released
  140.         4       Select  slab icon until select is released
  141.  
  142. The button slabbing mask can then be calculated by adding together the required 
  143. button values.  
  144.  
  145. The button slabbing time is the minimum time that the icon will be slabbed for, the 
  146. default time is for 15cs.  This value is a decimal number in centi-seconds.
  147. The colours are specified in the following order:
  148.  
  149.         {,border colour1} {,border colour2} {,slabbing out colour} 
  150.         {,slabbing in colour} {,inner channel colour}
  151.  
  152. These colours can be any valid WIMP colour in the range of 0 to 15, the default 
  153. selection is 4, 0, 1, 14, 12.
  154.  
  155. The (R)adio command specified in the validation string is used to set the state of 
  156. other radio button type icons.  The R command is followed by a decimal number in 
  157. the range 0 to 2, the action that these perform is:
  158.  
  159.         Radio type              Operation
  160.         0               this has the effect of switching off the specified icon(s).
  161.         1               this has the effect of switching on the specified icon(s).      
  162.         2               this has the effect of toggling the icons current state.
  163.  
  164. This command is then followed by the numbers of the icons you wish to alter, these 
  165. should be separated by commas.  This command may be specified more than once in 
  166. a validation string, for example to switch icons 1 & 2 off, 3 & 4 on and toggle the 
  167. state of icons 5 & 6 you could use the following validation string
  168.  
  169.         R0,1,2;R1,3,4;R2,5,6
  170.  
  171. The (U)nselectable command in the validation string has the effect of shading the 
  172. icon grey so that it cannot be selected by the user.  It is followed by a decimal 
  173. number in the range 0 to 2, the action that these is described above in the radio 
  174. command.
  175.  
  176. This command is then followed by the numbers of the icons you wish to alter, these 
  177. should be separated by commas.  This command may be specified more than once in 
  178. a validation string, for example to shade icons 1 & 2, un-shade 3 & 4 and toggle the 
  179. state of icons 5 & 6 you could use the following validation string
  180.  
  181.         U0,1,2;U1,3,4;U2,5,6
  182.  
  183. The (P)ointer command is used to define a pointer to be displayed when the pointer 
  184. is over that icon.  The first parameter is a sprite name to use for the pointer, this 
  185. should be no longer than 12 characters and should be present in the WIMP sprite 
  186. pool.  The optional parameters specify the x and y offsets to the active point in the 
  187. sprite, these should be specified in pixels.
  188.  
  189. The (I)nformation command is used to define a message to be sent to the interactive 
  190. help application when the pointer is over the icon.  If you wish to use a semi-colon 
  191. then you must place two next to each other.  The maximum length of the help 
  192. message is 235 characters.
  193.  
  194. The Interface module will change to the specified pointer when the mouse pointer is 
  195. over the icon/workarea, if no pointer is specified then the pointer will default to 
  196. shape one (the default arrow shape).  There are 5 pointer shapes designed in the 
  197. sprite file in the !Interface directory, these are:
  198.  
  199.         ptr_write - this pointer should be used on writable icons, the suggested active
  200.         point is at coordinates x = 4, y = 4.
  201.  
  202.         ptr_menu - this pointer is used where a menu can be activated by pressing the
  203.         menu button over the icon.  This stops the user having to search all over the
  204.         window to find where the menu is. The suggested active point is x = 6, y = 5.
  205.  
  206.         ptr_direct - this pointer is used where an object may be re-sized, the suggested
  207.         active point is at x = 13, y = 7.
  208.  
  209.         ptr_hand - this pointer is used where and icon may be dragged.  It is usually set
  210.         on the workarea, but it can be used on any icon (the save file icon looks great
  211.         when using it), its suggested active point is at x = 12, y = 8.
  212.  
  213.         ptr_cross - this pointer is used as a crosshair, it is the same as the one used in the
  214.         Draw application.  This icon gives the user a precise point when working with
  215.         line drawings, its suggested active point is at x = 13, y = 7.
  216.  
  217. You may also design your own pointers, which should be loaded into the WIMP 
  218. sprite pool.  There are a few points that you should note when designing pointers 
  219. these are :
  220.  
  221.         Pointer sprite names should have the form ptr_XXXXX, although this is not
  222.         compulsory it helps so that you do not get confused with pointers and normal
  223.         sprites.
  224.  
  225.         Do not use logical colour 2 in the pointer sprites, as this is unavailable in very
  226.         high resolution modes.
  227.  
  228. The pointers used should only be valid in your application, so you must not mask 
  229. out the Pointer_Leaving_Window in your application.  You should claim 
  230. Null_Reason_Code when passed to your application, otherwise the pointer will not 
  231. change when the pointer is over the icon/workarea, see the examples for more.
  232.  
  233. You should support the !Help application to help new users using your application, 
  234. this is why I implemented a feature in Interface to make this easier.  The following 
  235. was for some reason not published in the Programmers Reference Manuals, but was 
  236. in the pre-release disc version of the manuals.
  237.  
  238. For an application to use interactive help, two WIMP messages are employed.  One 
  239. is used by the Help to request help, and the other is used by the application to return 
  240. the help message.
  241.  
  242. To request help, the Help application sends a message of the following form:
  243.  
  244. block   +16     &502 - indicates request for help
  245.                 +20     mouse x co-ordinate
  246.                 +24     mouse y co-ordinate
  247.                 +28     mouse button state
  248.                 +32     window handle               (-1 if not over a window)
  249.                 +36     icon handle                 (-1 if not over an icon)
  250.  
  251. The WIMP system will pass this message automatically to the task in charge of the 
  252. appropriate window/icon.  If the application receiving the message wishes to produce 
  253. some help, it should respond with the following message:
  254.  
  255. block   +16     &503
  256.                 +20     help message terminated by 0
  257.  
  258. This message can be sent to the Help application by using Wimp_SendHelp, which 
  259. is provided by the Interface module (SWI &81687).
  260.  
  261. The help text may  contain any printable character codes.  If the sequence |M is 
  262. encountered then this will be treated as a line break and subsequent text will be 
  263. printed on the next line in the window.  If the text is too long for one line then it will 
  264. be split at a word boundary (space character).
  265.  
  266. The text should consist of  simple complete English sentences, each starting on a 
  267. new line and ending with a full stop.  The sentences should usually be simple 
  268. imperatives or information such as:
  269.  
  270.         Click SELECT to set the alarm.
  271.  
  272.         You are in Select mode.
  273.  
  274.         Click ADJUST to change to path edit mode.
  275.  
  276.         This is the icon for Edit.
  277.  
  278. In general you need not mention menu entries, except when specific ones interact 
  279. with pointer operations.  As a general rule present information of interest to the 
  280. beginner near the top, and expert tips or information lower down.
  281.  
  282. You must use the terminology defined.  For mouse operations you must use initial 
  283. capitals (for example Click).  The mouse buttons must be in capitals (for example 
  284. SELECT), as must key names (for example ESC, RETURN, SHIFT, CONTROL, A, B, F1, 
  285. COPY).  miss out speedups and shortcuts - just provide enough to help a beginner 
  286. without drowning them with information.
  287.  
  288. Provide interactive help thoroughly - include the icon bar, and the workarea of all 
  289. your windows.  If no actions are possible in a window, just
  290.  
  291.         This window shows....
  292.  
  293. if better than nothing.
  294.  
  295. You should assume a user knows:
  296.  
  297.         what a MENU key is
  298.         how to navigate menu trees and choose entries
  299.         what the icon bar is
  300.         how to move/size/toggle/close windows, and so on
  301.         what 'dragging an icon' means
  302.         what 'filling in a field' (writable icon) means
  303.  
  304.  
  305.  
  306.  
  307. **************************** The SWI Calls *********************************
  308.  
  309. Wimp_BorderIcon (SWI &81680)
  310.  
  311. R1 = pointer to block
  312. R1 preserved
  313.  
  314. Interrupts are not defined
  315. Fast interrupts are enabled
  316.  
  317. Processor is in SVC mode
  318.  
  319. SWI is not re-entrant
  320.  
  321. The block contains the following on entry:
  322.  
  323.         R1+0    mouse x (screen coordinates - not window relative)
  324.         R1+4    mouse y
  325.         R1+8    buttons (depending on icon button type)
  326.         R1+12   window handle
  327.         R1+16   icon handle  
  328.  
  329. This call is used to update an icons border.  It is typically called as a result of a 
  330. Mouse_Click event, if the icon has a border type of 0 or 2 then the icon will slab 
  331. inwards.  The format of the validation string is described n the previous section.
  332.  
  333. The application should the perform the task and then force the icon to normal status 
  334. by calling Wimp_BorderIcon (SWI &81680) with R1+8 set to 0.
  335.  
  336. The code to border icons and windows is outlined in the section Programming 
  337. Interface. 
  338.  
  339. Note that the mouse coordinates specified in R1+0 and R1+4 are not used by the 
  340. SWI and are only present to make the block compatible with a Mouse_Click event 
  341. block.
  342.  
  343. Wimp_BorderWindow (SWI &81681)
  344.  
  345. None
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Wimp_BorderWindow (SWI &81681)
  352.  
  353. R1 = pointer to block
  354. R1 preserved
  355.  
  356. Interrupts are not defined
  357. Fast interrupts are enabled
  358.  
  359. Processor is in SVC mode
  360.  
  361. SWI is not re-entrant
  362.  
  363. The block contains the following on entry:
  364.  
  365.         R1+0    window handle
  366.         R1+4    visible area minimum x coordinate
  367.         R1+8    visible area minimum y coordinate
  368.         R1+12   visible area maximum x coordinate
  369.         R1+16   visible area maximum y coordinate
  370.         R1+20   scroll x offset relative to work area origin
  371.         R1+24   scroll y offset relative to work area origin
  372.         R1+28   current graphics window minimum x coordinate
  373.         R1+32   current graphics window minimum y coordinate
  374.         R1+36   current graphics window maximum x coordinate
  375.         R1+40   current graphics window maximum y coordinate
  376.  
  377. This call is used to redraw the borders of icons in the window that are not up-to-date,  
  378. this SWI is typically called during the redraw loop of a window.  The SWI will 
  379. update the window, drawing borders around any icons which have the b command 
  380. specified in the validation string and are within the specified graphics window.
  381.  
  382. The code to border icons and windows is outlined in the section Programming 
  383. Interface. 
  384.  
  385. Wimp_BorderIcon (SWI &81680)
  386.  
  387. None 
  388.  
  389.  
  390.  
  391.  
  392. Wimp_ClaimInterface (SWI &81682)
  393.  
  394. R0 = task handle
  395. R0 preserved
  396.  
  397. Interrupts are not defined
  398. Fast interrupts are enabled
  399.  
  400. Processor is in SVC mode
  401.  
  402. SWI is not re-entrant
  403.  
  404. This SWI allows your application to use pointers via the Interface module.  This 
  405. SWI should be called at the beginning of your program.  If you don't use 
  406. Wimp_ClaimInterface then your pointers will not be displayed.
  407.  
  408. Wimp_ReleaseInterface (SWI &81683)
  409.  
  410. None
  411.  
  412.  
  413.  
  414.  
  415. Wimp_ReleaseInterface (SWI &81683)
  416.  
  417. R0 = task handle
  418. R0 preserved
  419.  
  420. Interrupts are not defined
  421. Fast interrupts are enabled
  422.  
  423. Processor is in SVC mode
  424.  
  425. SWI is not re-entrant
  426.  
  427. This SWI stops your application from using pointers.  When this SWI is called 
  428. Interface Manager will erase any workarea pointers assigned to your application and 
  429. free the memory.  This should be called in your exit handler, also if an error occurs 
  430. you should also call this SWI to stop other applications from gaining your pointers.
  431.  
  432. Wimp_ClaimInterface (SWI &81682)
  433.  
  434. None
  435.  
  436.  
  437.  
  438.  
  439. Wimp_SetWorkareaPointer (SWI &81684)
  440.  
  441. R1 = pointer to block
  442. R1 preserved
  443.  
  444. Interrupt status is undefined
  445. Fast interrupts are enabled
  446.  
  447. Processor is in SVC mode
  448.  
  449. SWI is not re-entrant
  450.  
  451. The block contains the following on entry:
  452.  
  453.         R1+0    window handle
  454.         R1+4    minimum x coordinate of bounding box
  455.         R1+8    minimum y coordinate of bounding box
  456.         R1+12   maximum x coordinate of bounding box
  457.         R1+16   maximum y coordinate of bounding box
  458.         R1+20   24 bytes of pointer data
  459.  
  460. This specifies the pointer for an area of the window.
  461. The bounding box coordinates are given relative to the window's work area origin.  
  462. R1+4 to R1+16 can be set to -1 to specify the whole of the window's work area.
  463. The pointer data at +20 to +44 contains the sprite name and any x, y offset, see 
  464. validation strings for more information.
  465.  
  466. Wimp_RemoveWorkareaPointer (SWI &81685)
  467. Wimp_PollPointer (SWI &81686)
  468.  
  469. None
  470.  
  471.  
  472.  
  473.  
  474.  
  475. Wimp_RemoveWorkareaPointer (SWI &81685)
  476.  
  477. R0 = task handle
  478. R1 = pointer to block
  479.  
  480. R0 preserved
  481. R1 preserved
  482.  
  483. Interrupt status is undefined
  484. Fast interrupts are enabled
  485.  
  486. Processor is in SVC mode
  487.  
  488. SWI is not re-entrant
  489.  
  490. The block contains the following on entry:
  491.  
  492.         R1+0    window handle
  493.         R1+4    minimum x coordinate of bounding box
  494.         R1+8    minimum y coordinate of bounding box
  495.         R1+12   maximum x coordinate of bounding box
  496.         R1+16   maximum y coordinate of bounding box
  497.  
  498. This call removes a previously installed pointer from the list of active pointer areas 
  499. for the specified window.  When a window is deleted you should remove any 
  500. pointers that were related to the window, otherwise these pointers may become 
  501. active on any window which gains the same window handle in the future. 
  502.  
  503. The bounding box coordinates are given relative to the window's work area origin.  
  504. R1+4 to R1+16 can be set to -1 to specify the whole of the window's work area.  
  505. R1+4 to R1+16 may be set to 0 to remove all work area pointers assigned to the 
  506. window.
  507.  
  508. Wimp_SetWorkareaPointer (SWI &81684)
  509. Wimp_PollPointer (SWI &81686)
  510.  
  511. None
  512.  
  513.  
  514.  
  515.  
  516.  
  517. Wimp_PollPointer (SWI &81686)
  518.  
  519. R0 = Wimp_Poll reason code
  520. R2 = task handle
  521.  
  522. R0 preserved
  523. R@ preserved
  524.  
  525. Interrupt status is undefined
  526. Fast interrupts are enabled
  527.  
  528. Processor is in SVC mode
  529.  
  530. SWI not re-entrant
  531.  
  532. This call checks to see if the pointer is up-to-date.  If the pointer is not up-to-date it 
  533. will change to the pointer specified in the icons validation string.  If the pointer is 
  534. not over an icon then  the pointer will change according to the position on the 
  535. window background.
  536.  
  537. Note that wimp_poll reason codes 0 and 4 should not be masked out, otherwise the 
  538. pointer will be out-of-date and will not function correctly.
  539.  
  540. Wimp_SetWorkareaPointer (SWI &81684)
  541. Wimp_RemoveWorkareaPointer (SWI &81685)
  542.  
  543. None
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Wimp_SendHelp (SWI &81687)
  550.  
  551. R1 = message block as returned from help application
  552. R1 preserved
  553.  
  554. Interrupt status is undefined
  555. Fast interrupts are enabled
  556.  
  557. Processor is in SVC mode
  558.  
  559. SWI not re-entrant
  560.  
  561. This call returns a help text message to the interactive help application.  It should be 
  562. called when a message with the number &502 is received and the pointer is over an 
  563. icon.  If there is a message in the icons validation string that the pointer is currently 
  564. over then this will be sent to the help application.  It is up to the applications 
  565. programmer to take care of the help message when the pointer is over the icon on the 
  566. icon bar or is over the window workarea. 
  567.  
  568. None
  569.  
  570. None
  571.  
  572.  
  573. ************************* Programming Hints & Tips **************************
  574.  
  575. This section gives hints and tips on how to program your application to make the 
  576. most of Interface Manager.  In the examples q% is used as a block of memory, 
  577. action% is the reason code returned by SWI "Wimp_Poll" and task_handle% is the 
  578. task handle.
  579.  
  580. The following code should be used to claim Interface so that the pointers may be 
  581. used.
  582.  
  583.         SYS "Wimp_Initialise", 200, &4b534154,"Interface" TO , task_handle%
  584.         SYS "Wimp_ClaimInterface", task_handle%        : REM claim interface
  585.  
  586.  
  587. The following code should be used when a redraw event is returned from 
  588. Wimp_Poll.
  589.  
  590.         SYS "Wimp_RedrawWindow",, q% TO flag%           : REM  get area to redraw
  591.         WHILE flag%                                     : REM  redraw = TRUE
  592.                 SYS "Wimp_BorderWindow",, q%            : REM  border all icons
  593.                 SYS "Wimp_GetRectangle",, q% TO flag%   : REM  get next rectangle
  594.         ENDWHILE                                        : REM  see if anymore
  595.  
  596.  
  597. The following code should be used when a mouse_click event is returned from 
  598. Wimp_Poll.
  599.  
  600.         SYS "Wimp_BorderIcon",, q%                      : REM  highlight icon
  601.         ....                                            : REM  insert your code
  602.         ....                                            : REM  here
  603.         q%!8 = 0                                        : REM  set button state to
  604.                                                         : REM  0 (switch off)
  605.         SYS "Wimp_BorderIcon",, q%                      : REM  switch off
  606.  
  607.  
  608. The following code should be used to to install a on the workarea.  Note this pointer 
  609. will take up the whole of the window workarea.
  610.  
  611.         q%!0 = window_handle%                           : REM window to install pointer  
  612.         q%!4 = -1                                       : REM whole workarea = - 1
  613.         q%!8 = -1                                       : REM whole workarea = - 1
  614.         q%!12 = -1                                      : REM whole workarea = - 1
  615.         q%!16 = -1                                      : REM whole workarea = - 1
  616.         $(q%+20) ="ptr_hand,5,5" + CHR$0                : REM ptr & point (no spaces)
  617.         SYS "Wimp_SetWorkareaPointer",, q%              : REM set the pointer
  618.  
  619.  
  620. The following code should be used to to remove all pointers from a window.  This 
  621. should be called when you delete a window.
  622.  
  623.         q%!0 = window_handle%                           : REM window to clear
  624.         q%!4 = 0                                        : REM all pointers = 0
  625.         q%!8 = 0                                        : REM all pointers = 0
  626.         q%!12 = 0                                       : REM all pointers = 0
  627.         q%!16 = 0                                       : REM all pointers = 0
  628.         SYS "Wimp_ReleaseWorkareaPointer", task_handle%, q%     
  629.                                                         : REM release the pointers
  630.  
  631. The following code should be used to to send help to the help application.  This 
  632. should be called when you receive a message with an identifier of &502.
  633.  
  634.         CASE q%!16 OF                                           : REM check message
  635.                 WHEN &502 : SYS "Wimp_SendInformation",, q%     : REM message help              
  636.                                                                 : REM request, so
  637.                                                                 : REM send help
  638.  
  639.  
  640.  
  641. The following code should be placed directly after your SYS "Wimp_Poll" to switch 
  642. pointer.
  643.  
  644.         SYS "Wimp_PollPointer", action%,, task_handle%  : REM call swi with reason code
  645.  
  646.  
  647.  
  648. The following code should be used to to release Interface.
  649.  
  650.         SYS "Wimp_ReleaseInterface", task_handle%       : REM release Interface
  651.  
  652.  
  653.  
  654.  
  655.