home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 408.lha / clickex_v1.0 / ClickEx.doc < prev    next >
Text File  |  1990-09-02  |  3KB  |  77 lines
  1. ClickEx is
  2. Copyright 1990, Software Solutions, All Rights Reserved
  3.  
  4. Version 1.0
  5.  
  6. ClickEx is a simple program that allows you prompt a user to select one 
  7. of several items from a Script, and execute a command based on the 
  8. selection.
  9.  
  10.     ClickEx parameters are as follows -
  11.  
  12.         -c[x][y]
  13.                 This will allow you to center the window on the screen.
  14.                 Using just -c (or -cxy)centers it completely.  -cx -cy
  15.                 will center it in only the specified direction.
  16.  
  17.         -pprompt
  18.                 Set the title for the window.  This allows you to
  19.                 prompt the user, indicating what he is selecting.
  20.  
  21.         -tn        n is number of seconds to wait for a response.  The default 
  22.                 value is 10 seconds.  Not applicable if there are is no
  23.                 default.
  24.  
  25.         -d        Next option is the default option to use if no response is 
  26.                 given in time.  If no option follows the -d, then the 
  27.                 default is to not execute anything.
  28.         options any number of options are permitted (in theory).  In reality,
  29.                 the number of options is bound by your screen Height.  If 
  30.                 you have more options than will fit on your screen, ClickEx
  31.                 will terminate with an error value. An  option consists of 
  32.                 an optional prompt (followed by a colon)  and an AmigaDOS 
  33.                 command.  If you have spaces in your prompt  or command, 
  34.                 you will need to surround the entire thing with  quotation 
  35.                 marks. If no prompt is given, the Command is  treated as 
  36.                 the prompt. If no Command is given after the  colon, 
  37.                 nothing is done.  When the command is executed, a  window 
  38.                 will appear in the upper left corner of your  WorkBench 
  39.                 Screen, with a number of one-line gadgets.  These  can be 
  40.                 selected in three ways
  41.                     1. Click and release on the gadget.
  42.                     2. The keys 1-9 will map to the first through ninth 
  43.                         gadgets in the window.
  44.                     3. Striking an alphabetic (a-z) key will match the 
  45.                         first gadget  in the list whose prompt begins with 
  46.                         that key.
  47.  
  48.                 Once the gadget is selected, the appropriate command is 
  49.                 executed.
  50.  
  51.                 If the 'command' to be execute begins with a single '#'
  52.                 then the string following it is assumed to be a return
  53.                 value, rather than a command.  This will a script to
  54.                 prompt with choices, and do different things based on the
  55.                 return value. Note: a return value of 20 is used when
  56.                 ClickEx encountered a problem(memory shortage, etc.)
  57.                 If your command begins with a '#', use two at the beginning
  58.                 and it will be executed.
  59.  
  60. ClickEx has been designed to work with public screens as in AmigaDos 2.0.  
  61. Under AmigaDos 2.0, it will automatically appear on the default public 
  62. screen.  I have only been able to test it with a simple public screen 
  63. program that I wrote for this purpose.  If you have any problems with this,
  64. please let me know.
  65.  
  66. Here are some examples:
  67.     (note: LoadC and LoadAsm are assumed to be valid Amiga Scripts)
  68.  
  69.     ClickEx "Echo #1" "Echo #2" "Echo #3"
  70.     ClickEx "Echo #1" -d "Echo #2"
  71.     ClickEx -t3 "Echo #1" -d "Echo #2"
  72.     ClickEx  "Echo #1" "Echo #2" -d
  73.     ClickEx  "Echo #1" -d -t5
  74.     ClickEx "Do you want to program in C:LoadC" "  ...or Assembler:LoadAsm"
  75.  
  76. That's about it.  Comments and questions welcome. 
  77.