home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / libs / reqtools.lha / modula2 / ReqTools.dok < prev    next >
Encoding:
Text File  |  1992-03-21  |  2.0 KB  |  41 lines
  1. Dokumentation zu den Dateien ReqTools.def, ReqToolsDemo,
  2.                              ReqToolsSupport und ReqTFileReq
  3.  
  4. ReqTools.def (Interface zur ReqTools.library von Nico Francois) und ReqTools-
  5. Demo.mod (Demoprogramm für die ReqTools.library) sind die direkten Umset-
  6. zungen der Oberonversionen von AMOK#62 von Kai Bolay nach Modula. Dort befin-
  7. det sich auch die komplette Dokumentation zu dieser Library.
  8. Sollen die Funktionen EZRequestA, EZRequestTags, EZRequest, vEZRequestA,
  9. vEZRequestTags oder vEZRequest von Modula aus benutzt werden, so müssen die
  10. Routinen aus ReqToolsSupport benutzt werden. Die Originale benutzen das Re-
  11. gister A4 zur Parameterübergabe, was in Modula nicht möglich ist. Dieses Pro-
  12. blem wird in ReqToolsSupport umgangen.
  13.  
  14. Wird die Library in eigenen Programmen verwendet, ist zu beachten, daß sie
  15. dem Copyright von Nico Francois unterliegt. Näheres dazu im File DISTRIBUTION
  16. der Originaldokumentation auf der AMOK-Diskette.
  17.  
  18. Das Modul ReqTFileReq soll die Benutzung des Filerequesters der ReqTools.li-
  19. brary vereinfachen.
  20. Die einzige Prozedur ist
  21.   PROCEDURE FileReq (VAR FName:ARRAY OF CHAR; Window:ADDRESS;
  22.               Title:ARRAY OF CHAR;x,y:INTEGER; pattern:ARRAY OF CHAR):BOOLEAN;
  23.  
  24.   FName:   Der komplette Dateiname mit Pfad. Er dient sowohl als Vorgabe und
  25.            als Resultat.
  26.   Window:  Das Fenster, in dem der Requester erscheinen soll.
  27.   Title:   Der Fenstertitel des Requesters.
  28.   x,y:     Die Koordinaten des Requesters. Sie beziehen sich auf den Screen,
  29.            auf dem der Requester erscheint. Sind sie kleiner 0, wird die
  30.            Default-Einstellung des Requesters benutzt.
  31.   pattern: Pattern, das benutzt werden soll. Wird keins angegeben (""),
  32.            erscheint auch kein Pattern-Gadget.
  33.  
  34.   Wird TRUE zurückgegeben, so wurde eine Datei angewählt, die in FName zu-
  35.   rückgegeben wird.
  36.   Wird FALSE zurückgegeben, so wurde keine Datei ausgewählt (z.B.: Cancel oder
  37.   Window-Close gewählt, Requester konnte nicht geöffnet werden). FName ist
  38.   dann unverändert.
  39.  
  40. Frank
  41.