Create document

4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 6.7.1 (Geändert)


Create document (Dokument{; Typ}) Zeit

ParameterTypBeschreibung
DokumentStringDokumentname oder kompletter Pfadname
oder leerer String für Standarddialog
zum Öffnen von Dokumenten
TypStringMacOS Dateityp (String 4 Zeichen) oder
Windows Dateierweiterung
(String 1- 3 Zeichen)
oder TEXT (.TXT) Dokument ohne Angabe
FunktionsergebnisZeitReferenznummer des Dokuments

Beschreibung

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.

Beispiel

(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)

Systemvariablen oder Mengen

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.

Referenz

Append document, Open document.

Anwendung des Befehls

Export All Data, Virtual Structure 2, vCard Import Export


4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next