home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 455.lha / CLIanywhere_v1.0 / ScreenWatch.doc < prev    next >
Encoding:
Text File  |  1990-12-10  |  4.5 KB  |  93 lines
  1.  
  2.  
  3.                            ScreenWatch Version 1
  4.  
  5.                        Created by Ray Lambert in 1990
  6.  
  7.  
  8. Overview.
  9.  
  10.     ScreenWatch is a utility which sits in the background waiting for
  11. screens to close.  When a screen is closed, it checks the screen to
  12. determine if it has any windows on it that are still open.  If all is normal
  13. you will not even know that ScreenWatch is there.  However, if it detects
  14. that someone is trying to close a screen with an open window on it,
  15. ScreenWatch will bring that screen to the front and open a requester on it
  16. informing you of the infraction, and allowing you the opportunity to close
  17. the window before the screen gets closed.  All of this happens in a manner
  18. that is completely transparent to the program which is attempting to close
  19. its screen (that program is temporarily frozen until the situation is
  20. resolved).
  21.     The main intended use for ScreenWatch is to protect users of
  22. "CLIanywhere", a program which allows CLIs and other programs to open their
  23. windows on any screen, from accidently closing a screen with an uninvited
  24. window still open on it.  (Please see the documentation for CLIanywhere for
  25. more information about this).  Although, ScreenWatch will also catch
  26. programs which do this on their own.  It is very rare that a program will be
  27. caught doing this on its own however, because to do so is considered
  28. (almost) a mortal sin in the Amiga programming world.
  29.  
  30.  
  31. Usage.
  32.  
  33.     ScreenWatch is extremely easy to use.  Simply run it by typing its name
  34. "ScreenWatch" at the CLI prompt, or in your Startup-Sequence file.
  35. ScreenWatch always automatically detachs itself completely from the CLI that
  36. it is run from, allowing that CLI to be closed later if you wish.
  37.     To remove ScreenWatch, simply run it a second time.  It will
  38. automatically detect that it has already been run, and will remove itself
  39. from memory.  When it is removed, a message requester will appear on the
  40. Workbench screen informing you that it is gone.
  41.     The only other time that you will hear from ScreenWatch is when it
  42. detects a screen closing that still has an open window on it.  When this
  43. happens the offending screen will be brought to the front and a requester
  44. will appear on it which says: "A window is open on this screen!".  The
  45. requester has two buttons in it which are labeled: "I've Closed It" and
  46. "Ignore It".  Clicking on the first instructs ScreenWatch that you've closed
  47. the window.  ScreenWatch will then re-check the screen -- if you really
  48. haven't closed the window or if there is yet another window still open on
  49. the screen the same requester will return immediately.  Clicking on "Ignore
  50. It" instructs ScreenWatch that you don't care about the situation or the
  51. consequences of allowing the screen to be closed while it still contains an
  52. open window.  ScreenWatch will then allow the screen to be closed even
  53. though the window is still open.  This second option is really only intended
  54. for a situation when you cannot close the window for some reason.
  55.     If for some reason ScreenWatch cannot open its requester on the
  56. offending screen, it will open an alert instead.  This is actually an
  57. automatic function of Intuition, invoked when it cannot open a requester.
  58. Intuition will render the alert so it appears like the requester would have,
  59. using the same messages as described above.  However, instead of clicking on
  60. buttons to make your decision of what to do with the window, an alert would
  61. have you pressing either the left or right mouse button to select one option
  62. or the other.  Unfortunately, an alert does not give you the opportunity to
  63. close the window.  Therefore, only the "Ignore It" option is of any use
  64. here, and there is no choice except to allow the screen to be closed with
  65. the window still open.  This situation is extremely rare -- it should only
  66. happen in extremely low-memory situations or situations where the system is
  67. already munged pretty badly -- so it is nothing to worry about; you will
  68. most likely never encounter it.
  69.  
  70.  
  71. Legal stuff.
  72.  
  73.     ScreenWatch is public domain.  I have included the source code so that
  74. other programmers can see how it works.  ScreenWatch is part of the
  75. CLIanywhere package and I would very much like the whole package to be kept
  76. together as one if it is distributed anywhere.
  77.  
  78.  
  79. Get to know me!
  80.  
  81.     If you have any questions, suggestions, flames, propositions, etc., I
  82. can be reached at the following places:
  83.  
  84. People/Link:  Analog*Kid    (log on often)
  85.  
  86. BIX:          AnalogKid     (log on sparsely)
  87.  
  88. U.S. Snail:   Ray Lambert
  89.               PO Box 1253
  90.               Westport, Massachusetts  02790
  91.  
  92. Phone:        (508) 677-9217
  93.