4D v16.3

Create document

Home

 
4D v16.3
Create document

Create document 


 

Create document ( Dokumentname {; Dateityp} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Dokumentname  String in Dokumentname oder kompletter Pfadname
oder leerer String für Standarddialog zum Öffnen von Dokumenten
Dateityp  String in Liste der anzuzeigenden Dateitypen oder *, um Dokumente nicht anzuzeigen
Funktionsergebnis  DokRef in Referenznummer des Dokuments

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

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

Ist Dokumentname 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 kompletten Zugriffspfad des erstellten Dokuments zurück.

Create document erstellt standardmäßig unter Windows ein Dokument .TXT, auf Macintosh ein Dokument TEXT. Wollen Sie einen anderen Typ anlegen, übergeben Sie den Parameter Dateityp.
Im Parameter Dateityp übergeben Sie den/die Dateitypen, die im Öffnen-Dialog auswählbar sind. Sie können eine Liste der Dokumenttypen übergeben, getrennt durch Strichpunkt (;). Für jeden gesetzten Typ wird im Menü zum Auswählen des Typs im Dialogfenster ein Eintrag hinzugefügt.
Auf Mac OS können Sie einen Macintosh Standardtyp (TEXT, APPL, etc.) oder einen UTI Typ(Uniform Type Identifier) übergeben. Apple hat UTIs zur Standardisierung von Dateitypen definiert. So ist z.B. "public.text" der UTI Typ für Dateien vom Typ Text. Weitere Informationen dazu finden Sie im Internet unter: https://developer.apple.com/library/mac/#documentation/Miscellaneous/Reference/UTIRef/Articles/System-DeclaredUniformTypeIdentifiers.html.

Unter Windows können Sie auch einen Mac OS Standardtyp übergeben - 4D sorgt intern für die Entsprechung - oder eine Dateierweiterung (.txt, .exe, etc.) Beachten Sie, dass der Benutzer unter Windows durch Eingabe von ** die Anzeige aller Dateitypen erzwingen kann. In diesem Fall führt 4D jedoch eine zusätzliche Überprüfung der gewählten Dateitypen aus: Wählt der Benutzer einen nicht zugelassenen Dateityp, gibt die Funktion einen Fehler zurück.
Wollen Sie die angezeigten Dateien nicht auf bestimmte Typen beschränken, übergeben Sie in Dateityp den String * (Stern) oder .*.

Unter Windows übergeben Sie eine Endung 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 Dateityp, sondern übergeben den kompletten Namen in Dokumentname (siehe Beispiel 2).

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

Vergessen Sie nicht, bei Bedarf CLOSE DOCUMENT für das Dokument aufzurufen.

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.txt") ` 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

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 den kompletten Pfadnamen und den Namen von Dokumentname.



Siehe auch 

Append document
Open document

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Systemdokumente
Nummer: 266

Dieser Befehl ändert die Systemvariable OKDieser Befehl ändert die Systemvariable DocumentDieser Befehl ändert die Systemvariable ErrorThis command can be run in preemptive processes

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)