AfTextRead: Unterschied zwischen den Versionen
Afwiki (Diskussion | Beiträge) K Stand 4.1.08 Buchstaben Kategorie entfernt |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfTextRead(handle1, alpha2, int3) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | [[file:DE_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | ||
Zeile 46: | Zeile 46: | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[:Category:Allgemeine Befehle der API|Verwandte Befehle]], | [[:Category:Allgemeine Befehle der API|Verwandte Befehle]], | ||
[[ | [[AfTextOpen#|AfTextOpen()]], | ||
[[ | [[AfTextLineRead#|AfTextLineRead()]], | ||
[[ | [[AfTextWrite#|AfTextWrite()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
Zeile 58: | Zeile 58: | ||
</table> | </table> | ||
<div class="BigLang"> | <div class="BigLang"> | ||
<p><p>Diese Anweisung liest eine externe Datei oder die Windows-Zwischenablage. Der Inhalt wird in einen Textpuffer geschrieben, der zuvor mit der CONZEPT 16-Anweisung [[ | <p><p>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#|AfTextOpen()]] angelegt werden muss. Der von dieser Anweisung zurückgegebene Deskriptor wird als (handle1) übergeben.</p> | ||
<p>In (alpha2) wird der Pfad und der Dateiname der externen Datei übergeben. Soll die Windows-Zwischenablage ausgelesen werden, wird eine leere Zeichenkette übergeben.</p> | <p>In (alpha2) wird der Pfad und der Dateiname der externen Datei übergeben. Soll die Windows-Zwischenablage ausgelesen werden, wird eine leere Zeichenkette übergeben.</p> | ||
Zeile 82: | Zeile 82: | ||
<pre class=source> | <pre class=source> | ||
// Externe Datei lesen | // Externe Datei lesen | ||
tHdlText # | tHdlText # AfTextOpen(16); | ||
tErr # | tErr # AfTextRead(tHdlText,'c:\temp\import.asc',_TextExtern | _TextANSI); | ||
... | ... | ||
tHdlText-> | tHdlText->AfTextClose(); | ||
// Windows-Zwischenablage lesen | // Windows-Zwischenablage lesen | ||
tHdlText # AFTextOpen(16); | tHdlText # AFTextOpen(16); | ||
tErr # | tErr # AfTextRead(tHdlText,'',_TextClipBoard); | ||
... | ... | ||
tHdlText-> | tHdlText->AfTextClose(); | ||
</pre> | </pre> | ||
Aktuelle Version vom 22. Oktober 2024, 12:24 Uhr
![]() |
|||||||||||||||||||||
AfTextRead(handle1, alpha2, int3) : int | |||||||||||||||||||||
Externe Datei oder Zwischenablage lesen | |||||||||||||||||||||
|
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.