home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 037.lha / FileReq.doc < prev    next >
Text File  |  1987-05-16  |  7KB  |  162 lines
  1.  
  2. June 8, 1987
  3.  
  4.         ********************************************************************
  5.         *                                   *
  6.     * Gonedu's all purpose File Requester by AmiLink Development Team. *
  7.     *                                   *
  8.     *          //                             //       *
  9.     *      \\ //     (c) AmiLink 1987 by Gonzalez Eduardo     \\ //       *
  10.     *       \//                          \//       *
  11.         *                                                                  *
  12.         *    Freely Distributed by IMPULSE, INC. Minneapolis, MN.  55430   *
  13.         *            by permission of, and in cooperation with:            *
  14.         *                                                                  *
  15.         *                   AMI-LINK, Geneva, Switzerland                  *
  16.         *                                                                  *
  17.         *    If your Software Development Company is interested in using   *
  18.         *    this files requester in commercial applications, please       *
  19.         *    contact:  "Stan Kalisher" at Impulse inc: 612-566-0221.       *
  20.         *                                                                  *
  21.     ********************************************************************
  22.  
  23. Advantages of Gonedu's FileRequester:
  24.  
  25. -It's the first completely mouse driven Requester. Even the disk choice can 
  26.  be done with the mouse although I haven't forgotten the keyboard lovers...
  27.  
  28. -It's a "No Wait State" directory Requester, which can be interrupted at any
  29.  time by the user. All gadgets can be selected even during the directory
  30.  loading.
  31.  
  32. -The Requester Remembers the directory files, so repeated use becomes 
  33.  really    a pleasure.
  34.  
  35. -It's a movable Requester, you can drag it like a window by clicking on the 
  36.  two first lines at the top.  The secret... there is a real window hidden 
  37.  behind the Requester.
  38.  
  39. -A Disk and a Parent gadget are included.
  40.  
  41. -At the beginning the "Filename" string gadget is automatically selected and
  42.  the inputs can be controled to be sure that the chosen file is really
  43.  in the directory list of files.  The Undo (right Amiga-Q) very handy 
  44.  feature of Intuition is present.
  45.  
  46. -The file names are sorted (Up/Low treated) and the directory names are
  47.  shadowed.
  48.  
  49. -The arrows scroll one file, the container of the pot scrolls one page and 
  50.  with the pot you can move freely and look at the files at the same time.
  51.  
  52. -The alerts (like Wrong disk ?) appear always with a small requester to warn
  53.  the user.
  54.  
  55. -At the internal level: every memory allocation is tested, so if a MEMORY FULL
  56.  event occurs, the program won't crash and the memory already allocated
  57.  will be automatically freed (no more disgusting gurus).
  58.  
  59. -And so on...
  60.  
  61.  
  62. Disvantages of Gonedu's FileRequester:
  63.  
  64. -I think the main disvantage is that Req.o is a quite important file 
  65.  (about 12 Kbytes) so perhaps some of you won't use it for small programs.
  66.  But let me tell you that this size is partly a consequence of the
  67.  custom images used in the gadgetry and, of course, but it is also a
  68.  consequence of the completeness of this piece of software.
  69. ------------------------------------------------------------------------------
  70.  
  71.                               RUNNING THE DEMO
  72.   
  73.  The demo File Requester MUST be invoked from CLI.  For a default run, type
  74.  "run FILEREQ".  The requester will appear in the upper left hand corner of
  75.  your current screen.  To use parameters, type in "FILEREQ".  In response to
  76.  "Gimme a title"  Type in anything you would like as a title for the drag
  77.   bar of the requester.
  78.  
  79.  In response to "Gimme a path", type in a drive number you want the 
  80.  requester to access. (i.e DF0:, DH0:, DF1: etc).
  81.  
  82.  In repsonse to "Left and Top edges of Requester's top left corner, type in
  83.  "20 20". (This will position the requester so you can grab it and move
  84.  it around.)
  85.  
  86.  In response to "Do you want test inputs?" just hit <RETURN>.
  87.  
  88.  
  89.  This demo is fully functional.  I won't tell you how it works. "Click" on
  90.  all the Gadgets and Icons.  This demo was compiled under Manx 3.4a, in June
  91.  of 1987.
  92.  
  93.  Legitimate Software development firms, who would like to use this file
  94.  requester in their applications, should contact us at Impulse, Inc. in
  95.  Minneapolis, 612-566-0221, and we will forward your requests to the
  96.  authors.
  97.  
  98.                           Stan Kalisher
  99.  
  100.  
  101. ==============================================================================
  102.     NAME
  103.     FileRequest -- Presents a movable file name requester in your screen.
  104.  
  105.     SYNOPSIS
  106.     BOOL FileRequest(Title, FullPath, Screen,
  107.              LeftEdge, TopEdge, InputTest, UserTAttr, FilesKey);
  108.  
  109.     char  *Title, *FullPath;
  110.     struct Screen *Screen;
  111.     SHORT LeftEdge, TopEdge;
  112.     BOOL  InputTest;
  113.     struct TextAttr *UserTAttr;
  114.     struct Remember **FilesKey;
  115.  
  116.     FUNCTION
  117.     This routine performs exactly what it's name lets you expect from it.
  118.     It lists the directory specified by FullPath, displays up to 8 files
  119.     or directory names (shadowed), allows scrolling up and down the list
  120.     using arrows or a pot gadget.
  121.     It permits DISK, directory and file name selection using the mouse or
  122.     the keyboard.
  123.  
  124.     INPUTS
  125.     Title =    Pointer to a string that is the title of the requester.
  126.         It is better to place a space at the beginnig and the end just
  127.         for aesthetical sake. Max. size of this string is 36 chars + 
  128.         one NULL char.
  129.     FullPath = Pointer to a string containing the full path of the direc-
  130.         tory to be listed when requester is displayed.
  131.         If NULL then the current directory will be listed.
  132.         There must be room for at least 110 chars + NULL char.
  133.         Example: char FullPath[111];
  134.     Screen = A pointer to a custom Screen or a NULL if you are using the
  135.         normal WBENCHSCREEN.
  136.     LeftEdge = The initial x-position, which represents the offset from
  137.         the first pixel on the line, pixel 0.
  138.     TopEdge = The initial y-position, which represents how many lines down
  139.         from the top (line 0) you want the window to begin.
  140.     InputTest = If you want the keyboard input to be tested, which is very
  141.         handy and useful for file loading because it assures you that
  142.         the file chosen in any case really exists (so use TRUE) but it
  143.         is quite annoying when used for file saving because the file
  144.         chosen doesn't have to exist and can be created (so ...suspens
  145.         ... use FALSE).
  146.     UserTAttr = Lets you specify your own TextAttr structure and use your
  147.         own special fonts. If NULL, no special TextAttr used.
  148.     FilesKey = The address of an Intuition Remember Key used for the list
  149.         of files in the directory. The Key must be NULL at the first
  150.         call and before any call with effective directory reading.
  151.  
  152.     RESULT
  153.     If the CANCEL button is selected, then FALSE is returned and FullPath
  154.     won't be complete but if a file is chosen and the OK button selected,
  155.     then TRUE is returned and FullPath will be modified according to your
  156.     path and file choice.
  157.  
  158.     BUGS
  159.     It's up to you to find them (?) and then, please, let me hear about
  160.     them (sniff...).
  161.  
  162.