home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / cdity / WindowDirect.lha / WindowDirect / WindowDirect.doc < prev    next >
Encoding:
Text File  |  1996-05-04  |  5.2 KB  |  141 lines
  1. WindowDirect
  2. Version 1.0
  3. June 14, 1993
  4.  
  5. >>>>>>>>>> THIS PROGRAM AND ITS SOURCE CODE IS PUBLIC DOMAIN <<<<<<<<<<
  6.  
  7. >>>>>>>>>> What is WindowDirect?
  8.  
  9.    WindowDirect is a commodity (requires AmigaDOS 2.04 or higher) that
  10.    jumps to screens and windows that you specify.  In addition, if you're
  11.    on a autoscrolling or "Super Bitmap" screen and using AmigaDOS 3.0 or
  12.    higher, WindowDirect moves the display to bring the window into view.
  13.  
  14. >>>>>>>>>> How's this useful?
  15.  
  16.    Well, it gives you the ability to jump to screens and windows with the
  17.    keyboard.  And, if you're using a "Super Bitmap" screen, WindowDirect
  18.    will snap the display to the window location so you don't have to go
  19.    hunting!
  20.  
  21.  
  22. >>>>>>>>>> How does it work?
  23.  
  24.    When you press any of the ten (or twelve, if you have them) function
  25.    keys with the left-amiga key, the screen and window you specify in the
  26.    tooltypes of the WindowDirect icon are activated, brought forward and
  27.    scrolled into view.  You can use standard AmigaDOS wildcards to
  28.    describe the screen and window names.  Use a tilde (~) to separate
  29.    the screen and window names.
  30.  
  31. >>>>>>>>>> Does this always work?
  32.  
  33.    YES!
  34.  
  35. >>>>>>>>>> How do I install this utility?
  36.  
  37.    To install, just drop the icon in your WBStartup drawer!
  38.  
  39.  
  40. >>>>>>>>>> How do I customize WindowDirect?
  41.  
  42.    ***********************************************************************
  43.    * This program MUST read its startup options from the icon tooltypes. *
  44.    * It may be started from the Shell or CLI but no options may be       *
  45.    * specified.                                                          *
  46.    ***********************************************************************
  47.  
  48.    From Workbench......................
  49.  
  50.       Use the Icon/Information menu to gain access to the icon's tooltypes.
  51.       The ToolTypes available are:
  52.  
  53.       DONOTWAIT -- Supported by Workbench.  Leave this in so you startup
  54.          runs faster (doesn't wait after each command in the startup
  55.          drawer).
  56.  
  57.       WARNINGLEVEL is set to IGNORE, DISPLAYBEEP or REQUEST to indicate
  58.       the type of warning issued if the screen/window cannot be found when
  59.       you hit the key.  For example, if F4 is defined as "TURBOTEXT~main.c"
  60.       but either the "TURBOTEXT" screen or the "main.c" window are not
  61.       available, WindowDirect will not be able to activate that
  62.       screen/window.  If DISPLAYBEEP is set, the screen flashes and a beep
  63.       sounds.  If REQUEST is set, a requester pops up with the message
  64.       "Cannot find screen/window."  If IGNORE is set, nothing happens.
  65.       The default WARNINGLEVEL is IGNORE.
  66.  
  67.       HOTKEY1, HOTKEY2, ... HOTKEY10, HOTKEY11, HOTKEY12 are the hotkey
  68.       definitions and screen and window names associated with the keys.
  69.       They default to the twelve function keys (yes, some Amiga keyboards
  70.       have twelve function keys -- the Amiga 3000UX in particular).
  71.  
  72.       The format of each HOTKEY specifier is:
  73.          <key>~<screen-name>~<window-name>
  74.  
  75.          where <key> is the name of the hotkey,
  76.                <screen-name> is the name of the screen to jump to,
  77.            and <window-name> is the name of the window to jump to
  78.          each separated by a tilde character (~).
  79.  
  80.       Note that the screen and window names may be specified using the
  81.       standard AmigaDOS wildcard operators.  So "TURBO#?~main#?" would
  82.       match:
  83.          Screen      Window
  84.          ----------- ------------
  85.          TURBOTEXT   main.c
  86.          TURBO       main street
  87.          TURBOLOAD   main
  88.  
  89.       QUIET allows you to supress any warnings or error information
  90.       WindowDirect outputs if not successful in setting itself up.  Defaults
  91.       to NOT being quiet.  (QUIET=FALSE).
  92.  
  93. >>>>>>>>>> Can I see some startup examples?
  94.  
  95.    From CLI/Shell,
  96.  
  97.       WindowDirect
  98.  
  99.       -- Starts WindowDirect.  No startup options may be specified on the
  100.          command line.  Options are read from the icon.  See below.
  101.  
  102.    From Workbench,
  103.  
  104.       Set your tooltypes to the following:
  105.  
  106.          HOTKEY1=rawkey shift f4~TURBOTEXT~WindowDirect.doc
  107.          WARNINGLEVEL=DISPLAYBEEP
  108.          QUIET=TRUE
  109.  
  110.       -- Starts WindowDirect with a hotkey of SHIFT-F4.  When pressed, the
  111.          WindowDirect.doc window on the "TURBOTEXT" screen will be brought
  112.          to front, activated and, if using AmigaDOS 3.0 or higher on a
  113.          super-bitmap screen), scrolled into view.  If the screen and/or
  114.          window cannot be found, the screen will flash and you'll hear a
  115.          beep (or whatever you set in you Sound Prefs).
  116.  
  117. >>>>>>>>>> Where will the error messages appear?
  118.  
  119.    If you run from the CLI/Shell, errors are output to stdout (that is, the
  120.    CLI/Shell window).  If you start from Workbench, a requester will appear
  121.    with the error message.  Dropping the icon in the WBStartup drawer is
  122.    considered as 'running from Workbench'.
  123.  
  124.  
  125. >>>>>>>>>> Who was the great, wonderful, fantastic, brilliant, creative,
  126. >>>>>>>>>> omnipotent Amiga genius who wrote this ultra-advanced
  127. >>>>>>>>>> technological breakthrough software?
  128.  
  129.             John Haubrich  (JohnH)
  130.             Software Sculptors
  131.             Kansas City, MO
  132.  
  133.             Problems?  Ideas?  Suggestions?  Requests?
  134.             InterNet:   johnh@tyrell.net
  135.  
  136.  
  137. >>>>>>>>>> Anything else?
  138.  
  139.    Investment/Loan and recipe management software are in the works.
  140.    Watch for them!
  141.