home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / reqtools-2.2b.lha / ReqTools-2.2b / Glue / M2Amiga / m2amiga_glue.lha / ReqTools.dok < prev    next >
Encoding:
Text File  |  1992-08-11  |  2.3 KB  |  47 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 Req-
  5. ToolsDemo.mod (Demoprogramm für die ReqTools.library) sind die direkten
  6. Umsetzungen der Oberonversionen von Kai Bolay nach Modula.
  7.  
  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
  11. Register A4 zur Parameterübergabe, was in Modula nicht möglich ist. Dieses
  12. Problem wird in ReqToolsSupport umgangen. Wahlweise kann aber auch der Para-
  13. meter argarray gestrichen werden, falls dieser nicht gebraucht wird.
  14.  
  15. Wird die Library in eigenen Programmen verwendet, ist zu beachten, daß sie
  16. dem Copyright von Nico Francois unterliegt. Näheres dazu im File
  17. DISTRIBUTION der Originaldokumentation.
  18.  
  19. Das Modul ReqTFileReq soll die Benutzung des Filerequesters der ReqTools.li-
  20. brary vereinfachen.
  21. Die einzige Prozedur ist
  22.   PROCEDURE FileReq (VAR FName:ARRAY OF CHAR; Window:ADDRESS;
  23.               Title:ARRAY OF CHAR;x,y:INTEGER;VAR pattern:ARRAY OF CHAR;
  24.               save:BOOLEAN):BOOLEAN;
  25.  
  26.   FName:   Der komplette Dateiname mit Pfad. Er dient sowohl als Vorgabe und
  27.            als Resultat.
  28.   Window:  Das Fenster, in dem der Requester erscheinen soll.
  29.   Title:   Der Fenstertitel des Requesters.
  30.   x,y:     Die Koordinaten des Requesters. Sie beziehen sich auf den Screen,
  31.            auf dem der Requester erscheint. Sind sie kleiner 0, wird die
  32.            Default-Einstellung des Requesters benutzt.
  33.   pattern: Pattern, das benutzt werden soll. Wird keins angegeben (""),
  34.            erscheint auch kein Pattern-Gadget. Hierzu kann auch die Variable
  35.            NoPat aus ReqTFileReq benutzt werden.
  36.   save:    Wird TRUE angegeben, so wird das Flag fReqSave gesetzt. Dadurch
  37.            ist ein Doppel-Klick nicht möglich und es besteht die Möglichkeit,
  38.            ein nicht existierendes Directory anzulegen.
  39.  
  40.   Wird TRUE zurückgegeben, so wurde eine Datei angewählt, die in FName zu-
  41.   rückgegeben wird.
  42.   Wird FALSE zurückgegeben, so wurde keine Datei ausgewählt (z.B.: Cancel
  43.   oder Window-Close gewählt, Requester konnte nicht geöffnet werden). FName
  44.   ist dann unverändert.
  45.  
  46. Frank
  47.