Open document

Version 6.8 (Geändert)

Open document (Dokument{; DateiTyp{; Modus}}) Zeit

Die Funktion Open document öffnet das Dokument, dessen Namen bzw. Pfadnamen Sie in Dokument übergeben haben.

Ist Dokument ein leerer Text, wird durch Open document der Standarddialog zum Öffnen von Dokumenten angezeigt. Brechen Sie diesen Dialog ab, wird kein Dokument geöffnet. Open document gibt in RefNr Null zurück und setzt die OK Variable auf 0.

• Wird das Dokument korrekt geöffnet, gibt Open document die Referenznummer des Dokuments zurück, die Systemvariable OK nimmt den Wert 1 an.

• Ist das Dokument bereits geöffnet und der Parameter Modus nicht gewählt, öffnet Open document das Dokument im Lesemodus, die Systemvariable OK nimmt den Wert 1 an.

• Ist das Dokument bereits geöffnet und Sie versuchen, es im Schreibmodus zu öffnen, erhalten Sie eine Fehlermeldung.

• Gibt es das Dokument nicht oder ist es bereits geöffnet, erhalten Sie eine Fehlermeldung.

Auf Macintosh werden im Standard Öffnen-Dialog alle Dokumente angezeigt. Der Parameter Typ ist optional. Geben Sie Typ an, werden im Dialog nur die Dokumente dieses Typs dargestellt. Typ stellt das Kennzeichen der Dokumente auf der Festplatte dar. Er ist auf dem Macintosh ein Text mit einer Länge von genau 4 Buchstaben. Dabei ist 'TEXT' der Dateityp für ASCII-Dateien.

Unter Windows hat er eine Länge von genau 3 Buchstaben. "TXT" zeigt dabei alle Text-Dokumente, d. h. ASCII-Dateien an. Wird unter Windows "TEXT" angegeben, wird dies automatisch in "TXT" umgesetzt. Wenn Sie andere Dateitypen benutzen, können Sie diese mit dem Befehl MAP FILE TYPES ebenfalls automatisch umsetzen lassen.

Unter Windows sollten Sie den Parameter Typ immer angeben, selbst wenn Sie nicht den Standarddialog verwenden. Denn Open document versucht eine Datei.TXT zu öffnen. Geben Sie den Parameter Typ an, versucht Open document das Dokument mit Namen "Dokument.Dateityp" zu öffnen. Zum Beispiel versucht:

   vhDocRef:=Open document("C:\\Letter";"WRI")

das Dokument "C:\\Letter.WRI" auf der Festplatte zu öffnen. Übergeben Sie in Typ mehr als drei Zeichen, berücksichtigt Open document nur die ersten drei Zeichen. Ist der Dokumenttyp nicht angegeben, versucht Open document das Dokument erst ohne Dateierweiterung und dann mit der Erweiterung .TXT zu öffnen. Wird es nicht gefunden, erhalten Sie eine Fehlermeldung "Datei wurde nicht gefunden".

Ist ein Dokument geöffnet, setzt Open document die Dateiposition an den Anfang des Dokuments. Mit der Funktion Append Document können Sie am Ende der Datei zusätzliche Informationen senden.

Mit den Befehlen SEND PACKET und RECEIVE PACKET, kombiniert mit Get document position und SET DOCUMENT POSITION können Sie direkt auf jeden beliebigen Teil des Dokuments zugreifen.

Mit dem optionalen Parameter Modus definieren Sie, wie DokName geöffnet werden soll. Es gibt vier Möglichkeiten. 4th Dimension bietet unter dem Thema "Systemdokumente" folgende vordefinierten Konstanten:

Rufen Sie bei Bedarf CLOSE DOCUMENT für das Dokument auf.

Folgendes Beispiel öffnet ein vorhandenes Dokument mit Namen Notiz, trägt den String "Adieu" ein und schließt das Dokument. Enthielt das Dokument bereits den String "Hallo", wird er überschrieben:

   C_TIME(vhDokRef) 
   vhDocRef:=Open document ("Notiz";Read and Write)   ` Öffne Dokument mit Namen Notiz 
   If (OK=1) 
      SEND PACKET (vhDokRef;"Adieu")   ` Schreibe ein Wort in Dokument 
      CLOSE DOCUMENT (vhDokRef)  ` Schließe Dokument 
   End if

2. Sie können nun ein Dokument lesen, das bereits im Schreibmodus geöffnet ist:

   vDoc:=Open document ("ÜbergebeDatei";"TEXT") ` Datei ist geöffnet
      ` Bevor Datei geschlossen wird, kann sie im Nur Lesen Modus eingesehen werden: 
   vRef:=Open document ("ÜbergebeDatei";"TEXT";Read Mode)

Wurde das Dokument korrekt geöffnet, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null). Die Systemvariable Document enthält nach dem Aufruf den vollen Namen des Dokuments.

Übergeben Sie in Modus 3, gibt die Funktion ?00:00:00? zurück (keine Referenz auf Dokument). Das Dokument wird nicht geöffnet, die Systemvariablen Document und OK werden jedoch aktualisiert:

• OK ist gleich 1.

• Je nach dem in DokName übergebenen Wert enthält Document entweder den Dokumentnamen oder den kompletten Zugriffspfad.

Hinweis: Wird die in DokName angegebene Datei nicht gefunden oder wurde ein leerer String übergeben, erscheint das Dialogfenster zum Öffnen einer Datei. Wird der Dialog bestätigt. werden Document und OK wie oben aktualisiert. Wird er nicht bestätigt, ist OK gleich 0 (Null).

Append document, Create document.

Anwendung des Befehls

File Names and Paths, Virtual Structure 2

---