home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / pollmask / !PollMask / !Help < prev    next >
Encoding:
Text File  |  1994-07-23  |  1.5 KB  |  39 lines
  1.  
  2.                                   PollMask
  3.  
  4.                                 By Ian Scott
  5.  
  6. Instructions
  7. ------------
  8.  
  9. This program is designed to aid WIMP programers. When writing software for
  10. the desktop, you will need a mask code for the Wimp_Poll loop so that the
  11. Wimp doesn't return control back to your application when it doesn't need
  12. that particular event. Say for example, your task may not need to use the
  13. Null_Reason_Code, it's important that you mask out this event so that the
  14. Wimp doesn't waste time passing control to your application, then passing
  15. control back to the Wimp, which (slightly) slows down the desktop.
  16.  
  17. To use this application, load it up and an icon will appear on the icon bar.
  18. Click on the icon with either Select or Adjust and the mask generator window
  19. will open. Click on the events that you don't need and it will display the
  20. relevant mask code at an icon at the top in hex, which you just copy into
  21. your Wimp_Poll call. i.e.
  22.  
  23. SYS "Wimp_Poll",&1831 (returned from PollMask),Block% TO Reason%
  24.  
  25. Meanings
  26. --------
  27.  
  28. RISC OS 3 - This event code will not be returned on a RISC OS 2 machine, it
  29.             is RISC OS 3 only.
  30. Queue it  - Masking out this event stops further events of the same type
  31.             being passed around the Wimp tasks.
  32.  
  33. Event codes
  34. -----------
  35.  
  36. Some event codes can not be masked out, and the task must be prepared to
  37. handle them. Also it's pointless masking out some events (like
  38. Lose_Caret) if your application doesn't use writable icons, because they will
  39. neither be checked for, nor returned.