home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / cdity / ScreenKeys.lha / ScreenKeys.readme < prev    next >
Encoding:
Text File  |  1995-12-17  |  3.1 KB  |  107 lines
  1. Short:    Add hotkeys for screens. V1.2.
  2. Author:   Magnus Holmgren (cmh@lls.se)
  3. Uploader: Magnus Holmgren (cmh@lls.se)
  4. Type:     util/cdity
  5.  
  6.  
  7. Introduction
  8. ============
  9.  
  10. This is a small program I hacked together the other day (hence the brief
  11. documentation ;). It is a small commodity that allows you to add hotkeys
  12. for any screen (that have a title). When you press the hotkey, the screen
  13. in question is brought to the front.
  14.  
  15. There are two versions of the programs included, ScreenKeys and
  16. ScreenKeys_OS3. The difference is that the latter requires OS 3.0 or
  17. better, and is a tad smaller (about 600 bytes). Apart from that, they
  18. should be equivalent.
  19.  
  20.  
  21. Usage
  22. =====
  23.  
  24. ScreenKeys only supports Workbench startup at the moment. Thus, you should
  25. install ScreenKeys in your WBStartup drawer. The following tooltypes are
  26. available:
  27.  
  28. CX_PRIORITY
  29.     The priority for the hotkeys.
  30.  
  31. SCREENKEY
  32.     This tooltype describes the screen and the hotkey for that screen.
  33.     Any number of SCREEKEY tooltypes may be present. First specify the
  34.     pattern describing the screen title, and after that - separated by
  35.     spaces or an equal sign - the hotkey for that screen. If a screen
  36.     pattern or a hotkey contains spaces, quote it. A screen pattern or
  37.     hotkey should not be more than 256 chars, or it will be truncated
  38.     (or an error occurs; I haven't checked ;).
  39.  
  40.     If a pattern match several screens, and SCREENTOBACK is specified,
  41.     then ScreenKeys will cycle between the matching screens. Thus,
  42.     specifying the screen pattern "#?" will behave the same way as the
  43.     "lcommand m" key. See the included icon for further examples.
  44.  
  45.     Example: SCREENKEY="Workbench screen" "lcommand w"
  46.  
  47. SCREENTOBACK
  48.     If this tooltype is present, then the formerly frontmost screen
  49.     will be brought to the back, after the new front screen has been
  50.     brought forward. This is needed to get the screen cycling to work.
  51.     However, there are a few problems with this.
  52.  
  53.     First of all, it can sometimes be convenient if this doesn't
  54.     happen. Secondly, it doesn't work too well with the attached
  55.     screens in OS 3.0+ (and I don't know of any way to find out if two
  56.     screens are attached or not). With this tooltype you can decide how
  57.     ScreenKeys should behave. If this tooltype isn't specified, then the
  58.     screen cycling will only work for two screens.
  59.  
  60. The DONOTWAIT tooltype in the icon is for the Workbench, when placed in the
  61. Workbench startup drawer.
  62.  
  63.  
  64. Author and other things
  65. =======================
  66.  
  67. ScreenKeys was written in 1995 by Magnus Holmgren. It is public domain
  68. (source included, though not very well documented ;), so you can do
  69. anything you like with it (although credits would be appriciated ;).
  70. Contact address:
  71.  
  72. Snail mail:
  73.  
  74.     Magnus Holmgren
  75.     Kvarnbergsvägen 5
  76.     S-444 47  Stenungsund
  77.     SWEDEN
  78.  
  79. Electronic mail:
  80.  
  81.     cmh@lls.e
  82.     cmh@augs.se
  83.     2:204/204.6@fidonet
  84.  
  85.  
  86. Version history
  87. ===============
  88.  
  89.     1.0    December 8, 1995
  90.  
  91.         Initial release.
  92.  
  93.     1.1    December 9, 1995
  94.  
  95.         Forgot to reply the Workbench startup message. ;)
  96.  
  97.     1.2    December 17, 1995
  98.  
  99.         SCREENTOBACK tooltype added.
  100.  
  101.         Sigh. Forgot to reply Commodity messages. ;)
  102.  
  103.         Didn't close icon.library.
  104.  
  105.         Some minor (size) optimizations.
  106.  
  107.