home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / cdity / StringInOut.lha / StringInOut / StringInOut.doc < prev    next >
Encoding:
Text File  |  1996-05-04  |  6.3 KB  |  164 lines
  1. StringInOut
  2. Version 4.0
  3. June 10, 1993
  4.  
  5. **
  6. ** THIS IS AN UPGRADE TO THE "StringOut 3.0" COMMODITY RELEASED IN DECEMBER.
  7. ** FINALLY, FINALLY GOT IT RIGHT!!!
  8. **
  9.  
  10. >>>>>>>>>> THIS PROGRAM AND ITS SOURCE CODE IS PUBLIC DOMAIN <<<<<<<<<<
  11.  
  12. >>>>>>>>>> What is StringInOut?
  13.  
  14.    StringInOut is a commodity (requires AmigaDOS 2.04 or higher) that
  15.    de-activates any currently active string gadgets in the current window
  16.    or activates the first string gadget in the active window.  Then you can
  17.    use TAB and BACKTAB to navigate through the string gadgets without having
  18.    to use the mouse!
  19.  
  20. >>>>>>>>>> How's this useful?
  21.  
  22.    Let's say you're in the database section of AmigaVision.  You enter a
  23.    page of data and now you want to add the record with the Insert command.
  24.    You could move your hands from the keyboard to the mouse and click the
  25.    button but that's annoying.  Or, you could hit AMIGA-I, *if* the string
  26.    gadget weren't active.  Since it is active, the "i" is inserted inside
  27.    the string gadget.  StringInOut lets you hit a key which de-activates
  28.    the string gadget so you can use keyboard shortcuts without your input
  29.    going into the edit field.  To get back into the string gadgets to enter
  30.    more data, hit the IN-HOTKEY and the window's (or requester's) first
  31.    string gadget is activated.
  32.  
  33.  
  34. >>>>>>>>>> How does it work?
  35.  
  36.    When the OUT-Hotkey is pressed, a tiny requester is opened in the current
  37.    window followed by a delay time that you set (see below under 'DELAY')
  38.    then the requester is destroyed thereby causing the string gadget to lose
  39.    focus (an OS/2 term meaning "it ain't the active spot no more!").
  40.  
  41.    When the IN-Hotkey is pressed, the current window is scanned for a
  42.    requester.  If a requester is open, the search for a string gadget will
  43.    start there.  If not, the window is searched.  The first *enabled* string
  44.    gadget is then activated.
  45.  
  46.  
  47. >>>>>>>>>> Does this always work?
  48.  
  49.    YES!  Previous versions used a different method to de-activate the active
  50.    string gadget.  Before, Turbotext and Final Copy II would auto-activate
  51.    the first string gadget in a window if the window loses focus and then
  52.    regains it.  StringInOut VERSION 4 uses the 'requester-method' to
  53.    de-activate the gadget so these programs now function as predicted with
  54.    StringInOut!
  55.  
  56.  
  57. >>>>>>>>>> How do I install this utility?
  58.  
  59.    To install, just drop the icon in your WBStartup drawer!
  60.  
  61.  
  62. >>>>>>>>>> How do I customize StringInOut?
  63.  
  64.    From the Shell or CLI...............
  65.  
  66.       StringInOut DELAY/K/N,OUTHOTKEY/K,INHOTKEY/K,QUIET/S
  67.  
  68.       DELAY is the amount of time (in ticks, a tick is 1/50 of a second)
  69.       between the first window going active and the original window
  70.       regaining focus.  A delay is needed to allow Amiga Intuition to
  71.       actually handle the activation stuff.  The default value is 5 ticks
  72.       (1/10 of a sec).
  73.  
  74.       INHOTKEY is the hotkey you'll use to invoke StringInOut to activate
  75.       the first string gadget of the active window.  It defaults to the
  76.       left-alt-F1 function key ("rawkey lalt f1").  When specifying the key
  77.       on the command line be sure to enclose it in quotes!
  78.  
  79.       OUTHOTKEY is the hotkey you'll use to invoke StringInOut to
  80.       de-activate the current string gadget.  It defaults to the left-alt-F2
  81.       function key ("rawkey lalt f2").  When specifying the key on the
  82.       command line be sure to enclose it in quotes!
  83.  
  84.       QUIET allows you to supress any warnings or error information
  85.       StringInOut outputs if not successful in setting itself up.  Defaults
  86.       to NOT being quiet.  (QUIET=FALSE).
  87.  
  88.    From Workbench......................
  89.  
  90.       Use Icon/Information to gain access to the icon's tooltypes.  The
  91.       four ToolTypes available are:
  92.  
  93.       DONOTWAIT -- Supported by Workbench.  Leave this in so you startup
  94.       runs faster (doesn't wait after each command in the startup drawer).
  95.  
  96.       INHOTKEY is the hotkey you'll use to invoke StringInOut to activate
  97.       the first string gadget of the active window.  It defaults to the
  98.       left-alt-F1 function key ("rawkey lalt f1").  When specifying the key
  99.       on the command line be sure to enclose it in quotes!
  100.  
  101.       OUTHOTKEY is the hotkey you'll use to invoke StringInOut to
  102.       de-activate the current string gadget.  It defaults to the left-alt-F2
  103.       function key ("rawkey lalt f2").  When specifying the key on the
  104.       command line be sure to enclose it in quotes!
  105.  
  106.       DELAY is the amount of time (in ticks, a tick is 1/50 of a second)
  107.       between the first window going active and the original window
  108.       regaining focus.  A delay is needed to allow Amiga Intuition to
  109.       actually handle the activation stuff.  The default value is 5 ticks
  110.       (1/10 of a sec).
  111.  
  112.       QUIET allows you to supress any warnings or error information
  113.       StringInOut outputs if not successful in setting itself up.  Defaults
  114.       to NOT being quiet.  (QUIET=FALSE).
  115.  
  116.  
  117. >>>>>>>>>> Can I see some startup examples?
  118.  
  119.    From CLI/Shell,
  120.  
  121.       StringInOut DELAY 25 OUTHOTKEY "rawkey shift f10"
  122.  
  123.       -- Starts StringInOut with a 1/2 second delay between window switching
  124.          with the OUT-Hotkey being a shifted-F10.  (The IN-Hotkey will
  125.          default to "rawkey lalt f2").
  126.  
  127.    From Workbench,
  128.  
  129.       Set your tooltypes to the following:
  130.          DELAY=10
  131.          OUTHOTKEY=rawkey alt f1
  132.          INHOTKEY=rawkey shift f1
  133.          QUIET=TRUE
  134.  
  135.       -- Starts StringInOut with a 1/5 second delay between window
  136.          switching, an OUT-Hotkey of ALT-F1, an IN-HOTKEY of SHIFT-F1 and
  137.          the QUIET option turned on so no errors are reported.
  138.  
  139.  
  140. >>>>>>>>>> Where will the error messages appear?
  141.  
  142.    If you run from the CLI/Shell, errors are output to stdout (that is, the
  143.    CLI/Shell window).  If you start from Workbench, a requester will appear
  144.    with the error message.  Dropping the icon in the WBStartup drawer is
  145.    considered as 'running from Workbench'.
  146.  
  147.  
  148. >>>>>>>>>> Who was the great, wonderful, fantastic, brilliant, creative,
  149. >>>>>>>>>> omnipotent Amiga genius who wrote this ultra-advanced
  150. >>>>>>>>>> technological breakthrough software?
  151.  
  152.             John Haubrich  (JohnH)
  153.             Software Sculptors
  154.             Kansas City, MO
  155.  
  156.             Problems?  Ideas?  Suggestions?  Requests?
  157.             InterNet:   johnh@tyrell.net
  158.  
  159.  
  160. >>>>>>>>>> Anything else?
  161.  
  162.    Investment/Loan and recipe management software are in the works.
  163.    Watch for them!
  164.