<<

Inhaltsverzeichnis

Suchen

>>

 

APPEND_TEXT

 

 

Funktion

 

 

Syntax:

APPEND_TEXT(<Maskenfeld>,<String-Ausdruck>[,<Handle>])

 

<Maskenfeld>

= <MASKENFELD>

<String-Ausdruck>

= <STRING-AUSDRUCK>

<Handle>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

APPEND_TEXT fügt den <String-Ausdruck> am Ende des Editfeldes <Maskenfeld> ein. Diese Funktion ist nur dann erfolgreich, wenn das <Maskenfeld> ein Editfeld ist.

 

Sollen viele Zeilen in ein Editfeld eingetragen werden, so ist das Einfügen mit APPEND_TEXT deutlich schneller als die Zuweisung des gesamten Textes an die Editfeldvariable.

 

<Handle> legt fest, in welchem Fenster sich das Editfeld befindet. <Handle> kann die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows enthalten. Fehlt der Parameter <Handle>, so muss sich das Editfeld auf der aktuellen Maske befinden.

 

Da unter Java manchmal die Änderungen nicht angezeigt werden, sollte nach APPEND_TEXT die Anweisung REPAINT ausgeführt werden.

 

APPEND_TEXT liefert folgende Ergebniswerte:

0: Die Funktion war erfolgreich.

-1: Das <Maskenfeld> existiert nicht oder ist kein Editfeld.

 

Parameter:

Maskenfeld

Editfeld, in das der Text eingefügt werden soll.

String-Ausdruck

Einzufügender Text

Handle

Enthält die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows.

 

Beispiel:

FOR I% = 1 to 100

    IF APPEND_TEXT(#5.#EDIT$,TABELLE$(I%)) <> 0

    THEN ... Fehler ...

    ENDIF

ENDLOOP

REPAINT

 

Siehe auch:

REPAINT