Dokumentation zu FRequest Version 1.5 geschrieben 1992 von H.P.G FREEWARE Überblick: FRequest läuft nur unter OS 2.xx Version größer als 36. FR ist ein Tool, mit dem man eine Datei oder ein Verzeichnis mit dem neuen OS 2.xx ASLFileRequester auswählen kann, und dann eine CLi-Kommandozeile mit der Selektion ausführen kann. FRequest benutzt viele OS 2.xx Features, daher ist es leider unter 1.3 und 1.2 nicht lauffähig. Der Requester kann in vielen Wegen vom Benutzer definiert werden. Alle Texte, die Auswahl, das PatternGadget und viel mehr kann vom Benutzer modifiziert werden. Wird eine dieser Optionen nicht genutzt, benutzt FR seine Vorein- gestellten Werte. FR macht es möglich eine angegebene Kommandozeile zu starten, genauso wie man sie im Cli-Fenster eingeben würde. Wird in der Kommandozeile dann ein '[]' eingegeben, wird '[]' durch die Auswahl ersetzt. Falls keine Selektion erfolgte, passiert nichts. FR kann auch benutzt werden, um Programme ohne PARAMETER zu starten. ---------------- Rechtliches: Ich habe mich entschlossen dieses Programm und alle beigefügten Dateien und Scripts, sowie aller Anleitungen als FREEWARE zu deklarieren. D.h.: Jeder kann FRequest benutzen. Jeder darf FRequest weitergeben, wenn: 1. alle unten aufgeführten Programme mit weitergegeben werden, 2. keinerlei Veränderungen unten aufgeführten Programmen vorgenommen wurden, 3. bei Nachkompilierungen der Quell-Codes muß ein Hinweis auf den Orginal-Programmierer vorhanden sein, bei Herausgabe dieser, muß eine Kopie an mich gesandt werden. 4. FRequest darf nicht verkauft werden. Außnahme: Es darf eine geringe Kopiergebühr er- hoben werden, die aber 5 DM bzw. den entsprechenden Gegenwert in anderen Währungen nicht übersteigt. 5. FRequest darf nur als Teil eines kommerziellen Produktes herrausgegeben werden, mit ausdrücklicher schriftlicher Genehmigung des Autors (Adresse siehe unten). Zuwiderhandlungen der oben Aufgeführten Konditionen werden zivilrechtlich verfolgt. Ferner wird für die Funktion des Programmes ,sowie möglicher Folgen der Benutzung des Programmes sowie der u. a. Dateien, keinerlei Gewährleistung übernommen. !!! Alle Risiken trägt der Benutzer allein !!! ---------------- TECHNICAL: FR ist mit dem MANX Aztec C Kompiler Version 5.0d kompilert worden. Die Größe von FR ist ziehmlich klein ( im Gegensatz zu manch anderen ähnlichen Programmen). Das ist darauf zurückzuführen, daß ich viele System-Library Calls an Stelle von C-Library Calls benutzt habe. FEATURES: Man kann das Verzeichnis angeben, daß FR beim Öffnen anzeigt. Man kann die Datei angeben, die beim Öffnen im Datei-Gadget von FR steht. Wenn man sie nicht angibt, bleibt das Datei Gadget leer. Man kann Pattern (AmigaDOS Standart) angeben, die im Pattern Gadget erscheinen angeben. Wenn man sie nicht angibt, wird '#?' benutzt. Man kann den GadgetText des positiven und negativen Gadgets angeben. Die Voreingestellten Werte sind: 'OKAY' und 'CANCEL'. Man kann einen Titel für das Fenster des FileRequesters angeben. Der Voreingestellte Wert ist: 'Bitte Datei auswählen'. Man kann eine Kommandozeile angeben, bei der '[]' mit der Selektion ersetzt werde. Werden keiene '[]' angegeben, wird die Auswahl einfach an das Ende der Kommandozeile angehängt. Wird keine Kommandozeile angegeben, wird die Auswahl einfach zum Cli-Fenster geschickt. Man kann FR auch zum Start von CLI_Kommandos benutzen. Wenn man die QUIET-Option benutzt, wird keine Information über die Auswahl zum Fenster geschickt. Dies ist besonders für BatchScripts nützlich. ---------------- START und PARAMETER: FR hat die folgende CLI SYNTAX: Syntax: Frequest [HAIL/K][OK/K][CANCEL/K][DIR/K][FILE/K][PAT/K][QUIET/S] [EXE/S|COM/K] Erklärung: HAIL: Zeichenkette wird HAIL gefolgt von einer Zeichenkette angegeben, wird diese in die Titelzeile des Requesters kopiert. Der Voreingestellte Wert: 'Bitte eiene Datei auswählen'. OK: Zeichenkette wird OK gefolgt von einer Zeichenkette an- gegeben, wird die Zeichenkette als Text für das positive Gadget benutzt. Voreingestellt ist: 'OKAY'. CANCEL: Zeichenkette wird CANCEL gefolgt von einer Zeichenkette angegeben, wird diese als Text für das ne- gative Gadget benutzt. Voreinstellung: 'CANCEL'. DIR: Zeichenkette wird DIR gefolgt von einer Zeichenkette an- gegeben, so wird diese als Verzeichnis be- nutzt, daß der Requester beim Start anzeigt. Voreinstellung: das momentane Verzeichnis FILE: Zeichenkette wird FILE gefolgt von einer Zeichenkette an- gegeben, wird diese in das Datei-Gadget ko- piert. Wird FILE nicht angegeben, bleibt das FILE-Gadget leer. PAT: Zeichenkette wird PAT gefolgt von einer Zeichenkette an- gegeben, wird diese in das Pattern-Gadget des Requesters kopiert. FRequest zeigt dann nur Dateien an, die dem PATTERN-Muster ent- sprechen. Voreingestellt ist: '#?' QUIET: ------------ Dies ist ein Schalter. Ohne Angabe von QUIET, zeigt FR die Komman- dozeile im Cli-Fenster an, bevor er sie aus- führt. Mit QUIET wird dies verhindert. Dies ist besonders bei BatchScripts nützlich. EXE: ------------ Dies ist ebenfalls ein Schalter. Wird weder COM noch EXE angegeben, ( siehe weiter unten ) dann zeigt FRequest nur die Selektion an, ohne etwas auszuführen. Wird EXE angege- ben, führt FR die Auswahl ohne PARAMETER als CLI-Kommando aus. COM: Zeichenkette wird COM gefolgt von einer Zeichenkette an- gegeben, wird diese als Kommandozeile benutzt. Alle '[]' in dieser Kommandozeile werden mit der Auswahl ersetzt. Werden keine '[]' ange- geben, wird die Auswahl an die Kommandozeile angehängt. Anderes: Wird der FileRequester abgebrochen, passiert nichts, d.h. es erfolgt weder eine Ausgabe noch wird irgendetwas aus- geführt. Will man nur die Einstellungen testen, dann kann man FR einfach ohne Angabe von EXE und COM aufrufen. Man kann COM und EXE nicht zugleich angeben. Wird dies ge- macht, gibt FR einen kleinen Hilfstext aus. Dies geschieht ebenfalls, wenn Falsche Angaben gemacht werden. INSTALLATION: Einfachst. Nur FRequest ins C: oder irgend ein anderes Ver- zeichnis im aktuellen Suchpfad kopieren. ---------------- TUTORIAL: 1. das ist das einfachste Beispiel, wie man FR aufrufen kann SHELL 1.> FRequest - FR öffnet einen Requester mit dem Titel 'Bitte eine Datei auswählen' und zeigt das momentane Verzeichnis an. Die GadgetTexte sind 'OKAY' für das positive und 'CANCEL' für das negative Gadget. Wird eine Auswahl gemacht, wird diese im Cli-Fenster ausgegeben. 2. Benutzen von FR in einem alias, um das FONTS: Ver- zeichnis zu wechseln: SHELL 1.> alias FAss FRequest HAIL "Bitte neues Fonts: Verz wählen" OK "ASSIGN" CANCEL "STOP" COM "assign fonts:" Wird nun FAss aufgerufen, SHELL 1.> FAss öffnet FR den Requester mit dem Titel 'Bitte neues Fonts: Verz wählen' und zeigt den Inhalt der mo- mentanen Verzeichnisses an. Die GadgetTexte sind nun 'ASSIGN' und 'STOP'. Wird eine Auswahl gemacht, wird diese mittels der Kommandozeile 'assign fonts: ' als Cli-Kommando ausgeführt. 3. Nun ein Beispiel, bei dem fast alle Angaben benutzt wurden, die bei FR benutzt werden können. Dies ist ein Beispiel für den Einsatz von FR in einem BatchScript. Dieses Script kopiert eine Datei in ein anderes Verzeichnis. .key Quelle .ket { .bra } ; Quelle ist die QuellVerzeichnis, von dem eine Datei ; kopiert werden soll set Ziel `FRequest HAIL "Bitte Ziel Verz auswählen' OK "In Ornung" CANCEL "Abbruch" PAT "#?" DIR sys:` if $Ziel EQ "" quit 0 endif FRequest HAIL "Welche Datei soll ich kopieren ?" OK "Kopiere" PAT "#?.(c.h)" DIR {Quelle} COM "copy {Quelle}/[] to $Ziel" quit 0 ------------ Grüße etc.: Hans-Peter Guenther Gruener Weg 5 W-3501 Fuldatal 2 B.R.D (Germany) Liste der Dateien: (Fehlt eine der folgenden Dateien, ist diese Veröffentlichung inkomplett) FRequest : Das englische Programm FRequest.info FRequest_D : Das deutsche Programm FRequest_D.info FRequest.doc : Die englische Anleitung FRequest.doc.info FRequest.dok : Die deutsche Anleitung FRequest.dok.info *******************************************************************************************