Create document

Version 6.7.1 (Geändert)

Create document (Dokument{; Typ}) Zeit

Die Funktion Create document erzeugt ein neues Dokument und gibt dessen Referenznummer zurück.

Sie übergeben den Dokumentnamen oder den kompletten Pfadnamen in Dokument. Gibt es Dokument bereits auf der Festplatte, wird es überschrieben. Ist Dokument gesperrt oder bereits geöffnet, erhalten Sie eine Fehlermeldung.

Ist Dokument ein leerer Text, zeigt Create document den Standarddialog zum Erstellen von Dokumenten an. Brechen Sie den Dialog ab, wird kein Dokument erstellt. Create document gibt in RefNr Null zurück und setzt die OK Variable auf 0.

Wurde das Dokument korrekt erstellt und geöffnet, gibt Create document die Referenznummer des Dokuments zurück und setzt die Systemvariable OK auf 1. Die Systemvariable Document wird aktualisiert und gibt den Zugriffspfad des erstellten Dokuments zurück.

Create document erstellt standardmäßig unter Windows ein Dokument .TXT, auf Macintosh ein Dokument TEXT. Der Parameter Typ ist optional. Geben Sie Typ an, erhält das Dokument diesen Typ.

Auf Macintosh übergeben Sie einen Dateityp, unter Windows eine Endung von 1 bis 3 Buchstaben. oder einen Macintosh-Dateityp, der mit dem Befehl MAP FILE TYPES automatisch umgesetzt wird.

Wollen Sie ein Dokument ohne Endung, mit mehreren Endungen bzw. mit einer längeren Endung, verwenden Sie nicht den Parameter Typ, sondern übergeben den kompletten Namen in Dokument (siehe Beispiel 2).

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

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

(1) Folgendes Beispiel erstellt und öffnet ein neues Dokument mit Namen Notiz, trägt den String "Hallo" ein und schließt das Dokument wieder:

   C_TIME(vhDocRef) 
   vhDocRef:=Create document ("Notiz") ` Erstelle neues Dokument mit Namen Notiz
   If (OK=1) 
      SEND PACKET(vhDocRef; "Hallo") ` Schreibe ein Wort in das Dokument 
      CLOSE DOCUMENT(vhDocRef) ` Schließe Dokument 
   End if

(2) Folgendes Beispiel erstellt Dokumente mit nicht-standardmäßigen Endungen unter Windows:

   $vtMyDoc:=Create document("Doc.ext1.ext2") `Mehrere Endungen
   $vtMyDoc:=Create document("Doc.shtml") `Lange Endung
   $vtMyDoc:=Create document("Doc.") `Keine Endung (das Zeichen "." ist zwingend)

Wurde das Dokument korrekt erstellt, wird die Systemvariable OK auf 1 gesetzt, die Systemvariable Document enthält entweder den Namen oder den kompletten Pfadnamen und den Namen von Dokument, je nach übergebenem Wert, d.h. entweder den Dateinamen oder den kompletten Pfadnamen.

Append document, Open document.

Anwendung des Befehls

Export All Data, Virtual Structure 2, vCard Import Export

---