AfTextRead

AfTextRead(handle1, alpha2, int3) : int
Externe Datei oder Zwischenablage lesen
handle1 Deskriptor des Textpuffers alpha2 Pfad und Name der externen Datei int3 Optionen (siehe Text) Resultat int Fehlerwert Siehe Verwandte Befehle, AfTextOpen(), AfTextLineRead(), AfTextWrite()

Diese Anweisung liest eine externe Datei oder die Windows-Zwischenablage. Der Inhalt wird in einen Textpuffer geschrieben, der zuvor mit der CONZEPT 16-Anweisung AfTextOpen() angelegt werden muss. Der von dieser Anweisung zurückgegebene Deskriptor wird als (handle1) übergeben.

In (alpha2) wird der Pfad und der Dateiname der externen Datei übergeben. Soll die Windows-Zwischenablage ausgelesen werden, wird eine leere Zeichenkette übergeben.

Als Optionen (int3) können folgende Konstanten übergeben werden:

_TextExtern	Es wird eine externe Datei gelesen. Je nach verwendetem Zeichensatz der Datei kann die Option mit _TextOEM oder _TextANSI kombiniert werden.
_TextClipboard	Es wird die Windows-Zwischenablage gelesen. Sollte in der Zwischenablage kein Text vorhanden sein, ist der gelesene Text leer. Formatierungen im Text werden nicht mit übertragen.

Einzelne Zeilen des Textes können mit der Funktion AFTextLineRead() ausgelesen werden.

Beispiele:

// Externe Datei lesen
tHdlText # AfTextOpen(16);
tErr # AfTextRead(tHdlText,'c:\temp\import.asc',_TextExtern | _TextANSI);
...
tHdlText->AfTextClose();

// Windows-Zwischenablage lesen
tHdlText # AFTextOpen(16);
tErr # AfTextRead(tHdlText,'',_TextClipBoard);
...
tHdlText->AfTextClose();

Die Funktion gibt _ErrOk zurück, wenn kein Fehler aufgetreten ist. Wurde ein ungültiger Deskriptor übergeben, wird _ErrHdlInvalid zurück gegeben. Die Rückgabewerte beim Zugriff auf eine externe Datei sind bei der CONZEPT 16-Anweisung (siehe CONZEPT 16 Hilfe) zu finden.