home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / DOS / UTILITY / DIVERSEN / KEYTAP10 / KEYTAP.DOC < prev    next >
Text File  |  1994-10-27  |  4KB  |  84 lines
  1. ************************************************************************
  2. KEYTAP - Keystroke Simulator
  3. (C) Copyright 1992-1994 Neil Faulks. All Rights Reserved.
  4. ************************************************************************
  5.  
  6. KEYTAP allows you to run a program whilst simulating a sequence of
  7. keystrokes. The command to be run is given as an argument to KEYTAP,
  8. together with the list of keystrokes. When the list of keys is exhausted
  9. control is returned to the keyboard, unless the program has already
  10. terminated. The key list may alternatively be stored in a file, and the
  11. name of the file given to KEYTAP. Delays can be inserted into the stream
  12. of keys, to allow a user time to read output, or time for an application
  13. to finish processing.
  14.  
  15. KEYTAP has many uses such as allowing menu driven applications to be run
  16. from the command line, or answering tiresome questions from programs
  17. like FORMAT.
  18.  
  19. KEYTAP runs the application program by invoking a copy of COMMAND.COM,
  20. KEYTAP also remains resident whilst the program is running, but, unlike
  21. some other utilities KEYTAP does not remain in memory once the
  22. application has terminated, it is not a TSR.
  23.  
  24. This program is SHAREWARE, which means that you are allowed to use it
  25. free for a period of up to 30 days, after this time you must pay for it
  26. if you wish to continue using it. Refer to the file ORDER.DOC for
  27. ordering information.
  28.  
  29. Usage
  30.         
  31.         KEYTAP <command name> // <key list>
  32.         
  33.         The double slash ("//") is used to separate the command (which
  34.         may also have its own options) from the list of keys. Any spaces
  35.         between the // and the key list are ignored.
  36.         
  37.         The key list may be placed in a file, in which case the
  38.         following syntax is used:
  39.         
  40.         KEYTAP <command name> // @file
  41.         
  42.         There can only be one filename given on the command line, and it
  43.         must not be followed by any characters such as spaces.
  44.  
  45.         If the command name is omitted, a new command shell is started.
  46.         
  47.         All characters in the keylist, including spaces, are fed to the
  48.         application with the exception of left square bracket "[", which
  49.         signals the start of a special key name.
  50.         
  51.         If the key list is being read from a file Line Feed characters,
  52.         normally found at the end of each line, are sent to the
  53.         application as RETURN key presses.
  54.         
  55. The Key List
  56.         
  57.         The following special keynames may be used in the key list (it
  58.         does not matter if they are in upper or lower case):
  59.         
  60.         [ret]   [esc]   [bksp]
  61.         [up]    [down]  [left]  [right]
  62.         
  63.         [a]     ...     [z]     Alt and letter keys
  64.         [^a]    ...     [^z]    Ctrl and letter keys
  65.         
  66.         [F1]    ...     [F12]   function keys
  67.         [@F1]   ...     [@F12]  Alt function keys
  68.         [$F1]   ...     [$F12]  Shifted function keys
  69.         [^F1]   ...     [^F12]  Ctrl function keys
  70.         
  71.         [=#]                    Delay for # seconds
  72.         
  73.         [1234]                  key with scancode 1234
  74.         
  75.         The supplied KEYCODE program may be used to get the scan code of
  76.         any key on the keyboard, so every key may be simulated by
  77.         KEYTAP.
  78.         
  79. Hints on Using Keytap
  80.         
  81.         Some applications ignore keystrokes entered whilst they are
  82.         starting up; you may need to use a delay at the start of a key
  83.         list for such applications.
  84.