home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / programm / libs / reqtools.lha / ReqTools / Glue / M2Amiga / ReqTools.doc < prev    next >
Encoding:
Text File  |  1992-06-29  |  1.8 KB  |  40 lines
  1. Documentation for the files ReqTools.def, ReqToolsDemo,
  2.                             ReqToolsSupport and ReqTFileReq
  3.  
  4. ReqTools.def (Interface to reqtools.library from Nico Francois) and ReqTools-
  5. Demo.mod (demo program for reqtools.library) are direct conversions into
  6. Modula of the Oberon versions from AMOK #62 by Kai Bolay. The complete
  7. documentation for this Library is also on that disk.
  8.  
  9. If you want to use the functions EZRequestA, EZRequestTags, EZRequest,
  10. vEZRequestA, vEZRequestTags or vEZRequest in Modula you must use the
  11. functions from ReqToolsSupport. The original functions use register A4 for
  12. parameter passing. This is impossible in Modula. This problem is surpassed
  13. by ReqToolsSupport.
  14.  
  15. If you use the Library in your own programs please consider that it is
  16. copyrighted by Nico Franτois. Further information can be found in the file
  17. DISTRIBUTION found on the AMOK disk.
  18.  
  19. The module ReqTFileReq simplifies the use of the Filerequester of the
  20. reqtools.library.
  21. The one and only procedure is:
  22.  
  23.   PROCEDURE FileReq (VAR FName:ARRAY OF CHAR; Window:ADDRESS;
  24.               Title:ARRAY OF CHAR;x,y:INTEGER; pattern:ARRAY OF CHAR):BOOLEAN;
  25.  
  26.   FName:   The total filename including path. This serves as a template as
  27.            well as result.
  28.   Window:  The window for the requester
  29.   Title:   The title of the requester
  30.   x,y:     The coordinates of the requester relative to the screen on which
  31.            the requester open. If they are smaller than 0 the default are
  32.            used.
  33.   pattern: Patten to be used. If you don't need a pattern gadged pass "".
  34.  
  35.   If TRUE is returned a file was selected. This file is returned in FName.
  36.   Is FALSE returned no file was selected (e.g.: Cancel or Close-Gadget) or
  37.   the requester couldn't be openen. FName is not altered in this case.
  38.  
  39. Frank
  40.