home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / disks / disk412.lzh / CustReq / CustReq.doc < prev    next >
Text File  |  1990-12-14  |  3KB  |  60 lines
  1.                CustReq v4 (c) Copyright 1990 by Jonathan Potter
  2.  
  3. USAGE : CustReq "text" "pos" "neg"
  4.         [-d default] [-t timeout] [-x xpos] [-y ypos]
  5.  
  6.         "text"     - text of requester
  7.         "pos"      - positive option of requester
  8.         "neg"      - negative option of requester
  9.         default    - optional default value, either 1 (YES) or 0 (NO)
  10.         timeout    - optional timeout value in seconds
  11.         xpos       - optional x position of window
  12.         ypos       - optional y position of window
  13.  
  14.   CustReq is a glorified ASK command for your startup-sequence.
  15.   All strings must be in quotes if they contain any spaces. To make the "text"
  16. string more than one line long, use a | character to specify the end of a
  17. line.
  18.   If a default of 1 is given, the requester will (try to) appear with the
  19. positive gadget under the mouse. If a default of 0 is given, it will (try to)
  20. appear with the negative gadget under the mouse. The -x and -y flags override
  21. this function. To force the requester to appear with the positive gadget
  22. under the mouse, use -x -2. To make it appear with the negative gadget under
  23. the mouse, use -x -3. To make it appear in the center of the screen, use
  24. -x -4.
  25.   If a timeout is given, the requester will timeout and return the default
  26. value after the specified time.
  27.   If the positive option is chosen, a returncode of 5 (WARN) is generated,
  28. otherwise 0 is generated. The Y key has the same effect as the positive gadget,
  29. and the N key has the same effect as the negative gadget. You can also press
  30. the key corresponding to the first letter of the desired gadget.
  31.  
  32. An example usage of CustReq is:
  33.  
  34.   CustReq "Do you want to load Workbench?|If you select Load, Workbench will
  35. be loaded.|If you select Don't Load, you will be|left with a CLI window."
  36. "Load" "Don't load" -d 1 -t 5
  37.   If WARN
  38.     LoadWb
  39.     Echo "Workbench loaded"
  40.   EndIf
  41.  
  42. This program is not public domain, but may be distributed freely.
  43.  
  44.                                Jonathan Potter
  45.                                  P.O. Box 289
  46.                                    Goodwood
  47.                                    SA 5034
  48.                                   Australia
  49.  
  50.                                 (08) 293 2788
  51.  
  52. ------------------------------------------------------------------------------
  53.  
  54.                               v4 changes from v3
  55.  
  56.             Requester looks a lot nicer, and works well under 2.0
  57.                          Also, hailing text is gone.
  58.  
  59. ------------------------------------------------------------------------------
  60.