AfTextWrite

AfTextWrite(handle1, alpha2, int3) : int
In externe Datei oder Zwischenablage schreiben
handle1 Deskriptor des Textpuffers alpha2 Name des internen Textes int3 Optionen (siehe Text) Resultat int Fehlerwert Siehe Verwandte Befehle, AfTextRead()

Die Anweisung schreibt den Inhalt eines Textpuffers in eine externe Datei oder in die Windows-Zwischenablage. Der Deskriptor des Textes wird in (handle1) übergeben. Soll eine externe Datei geschrieben werden, muss in (alpha2) der Pfad und der Dateiname angegeben sein. Beim Schreiben in die Zwischenablage wird hier eine leere Zeichenkette übergeben.

Als Optionen können folgende Konstanten übergeben werden:

_TextExtern	Es wird eine exteren Datei geschrieben. Je nach Format der Datei kann die Option mit _TextOEM oder _TextANSI kombiniert werden.
_TextClipboard	Es wird in die Windows-Zwischenablage geschrieben.

Beispiele:

// Schreiben in eine externe Datei
tHdlText # AfTextOpen(16);
...
tErr # AfTextWrite(tHdlText,'c:\temp\export.txt',_TextExtern | _TextANSI);
tHdlText->AfTextClose();


// Schreiben in die Windows-Zwischenablage
tHdlText # AfTextOpen(16);
...
tErr # AfTextWrite(tHdlText,'',_TextClipBoard);
tHdlText->AfextClose();

Ist beim Schreiben des Textpuffers kein Fehler aufgetreten, wird _ErrOk zurück gegeben. In einem Fehlerfall entsprechen die Rückgabewerte dem CONZEPT 16-Befehl (siehe CONZEPT 16 Hilfe) .