Dokumentation zu den Dateien ReqTools.def, ReqToolsDemo,
                             ReqToolsSupport und ReqTFileReq

ReqTools.def (Interface zur ReqTools.library von Nico Francois) und Req-
ToolsDemo.mod (Demoprogramm für die ReqTools.library) sind die direkten
Umsetzungen der Oberonversionen von Kai Bolay nach Modula.

Sollen die Funktionen EZRequestA, EZRequestTags, EZRequest, vEZRequestA,
vEZRequestTags oder vEZRequest von Modula aus benutzt werden, so müssen die
Routinen aus ReqToolsSupport benutzt werden. Die Originale benutzen das
Register A4 zur Parameterübergabe, was in Modula nicht möglich ist. Dieses
Problem wird in ReqToolsSupport umgangen. Wahlweise kann aber auch der Para-
meter argarray gestrichen werden, falls dieser nicht gebraucht wird.

Wird die Library in eigenen Programmen verwendet, ist zu beachten, daß sie
dem Copyright von Nico Francois unterliegt. Näheres dazu im File
DISTRIBUTION der Originaldokumentation.

Das Modul ReqTFileReq soll die Benutzung des Filerequesters der ReqTools.li-
brary vereinfachen.
Die einzige Prozedur ist
  PROCEDURE FileReq (VAR FName:ARRAY OF CHAR; Window:ADDRESS;
              Title:ARRAY OF CHAR;x,y:INTEGER;VAR pattern:ARRAY OF CHAR;
              save:BOOLEAN):BOOLEAN;

  FName:   Der komplette Dateiname mit Pfad. Er dient sowohl als Vorgabe und
           als Resultat.
  Window:  Das Fenster, in dem der Requester erscheinen soll.
  Title:   Der Fenstertitel des Requesters.
  x,y:     Die Koordinaten des Requesters. Sie beziehen sich auf den Screen,
           auf dem der Requester erscheint. Sind sie kleiner 0, wird die
           Default-Einstellung des Requesters benutzt.
  pattern: Pattern, das benutzt werden soll. Wird keins angegeben (""),
           erscheint auch kein Pattern-Gadget. Hierzu kann auch die Variable
           NoPat aus ReqTFileReq benutzt werden.
  save:    Wird TRUE angegeben, so wird das Flag fReqSave gesetzt. Dadurch
           ist ein Doppel-Klick nicht möglich und es besteht die Möglichkeit,
           ein nicht existierendes Directory anzulegen.

  Wird TRUE zurückgegeben, so wurde eine Datei angewählt, die in FName zu-
  rückgegeben wird.
  Wird FALSE zurückgegeben, so wurde keine Datei ausgewählt (z.B.: Cancel
  oder Window-Close gewählt, Requester konnte nicht geöffnet werden). FName
  ist dann unverändert.

Frank
