home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 6 / Sonderheft_6-96.iso / pd / libraries / reqtools / glue / m2amiga / m2amiga_glue.lha / ReqTools.doc < prev    next >
Text File  |  1992-08-11  |  2KB  |  44 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 by Kai Bolay.
  7.  
  8. If you want to use the functions EZRequestA, EZRequestTags, EZRequest,
  9. vEZRequestA, vEZRequestTags or vEZRequest in Modula you must use the
  10. functions from ReqToolsSupport. The original functions use register A4 for
  11. parameter passing. This is impossible in Modula. This problem is surpassed
  12. by ReqToolsSupport. Alternatively you can delete the parameter argarray, if
  13. you do not need it.
  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.
  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;VAR pattern:ARRAY OF CHAR;
  25.               save:BOOLEAN):BOOLEAN;
  26.  
  27.   FName:   The total filename including path. This serves as a template as
  28.            well as result.
  29.   Window:  The window for the requester
  30.   Title:   The title of the requester
  31.   x,y:     The coordinates of the requester relative to the screen on which
  32.            the requester open. If they are smaller than 0 the default of the
  33.            requester is used.
  34.   pattern: Pattern to be used. If you don't need a pattern gadged pass "".
  35.            Therefor the variable NoPat from ReqTFileReq can be used, too.
  36.   save:    IF you pass TRUE, the flag fReqSave is set. Then  Double-clicking
  37.            will be disabled and a non-existent directory can be created.
  38.  
  39.   If TRUE is returned a file was selected. This file is returned in FName.
  40.   Is FALSE returned no file was selected (e.g.: Cancel or Close-Gadget or
  41.   the requester couldn't be openen). FName is not altered in this case.
  42.  
  43. Frank
  44.