<< Inhaltsverzeichnis Suchen >>

APPEND_TEXT

Funktion

Syntax:

APPEND_TEXT(<MASKEN-FELD>,<STRING-AUSDRUCK>)

<MASKEN-FELD> =  #<MASKEN-NUMMER>.#<VAR-NAME> oder
                       #<MASKEN-NUMMER>.#<DATEINAME>.<FELDNAME>

Bedeutung:

APPEND_TEXT fügt unter Java den <STRING-AUSDRUCK> am Ende des Editfeldes <MASKEN-FELD> an. Diese Funktion ist nur dann erfolgreich, wenn das <MASKEN-FELD> ein Editfeld ist und sich auf der aktuellen Maske befindet.

Sollen viele Zeilen in ein Editfeld eingetragen werden, so ist das Einfügen mit APPEND_TEXT deutlich schneller als die Übergabe aller Zeilen in einem String.

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

<STRING-AUSDRUCK> wurde erfolgreich eingefügt.

 

-1

Das <MASKEN-FELD> befindet sich nicht auf der aktuell bearbeiteten Maske.

 

Unter MS-DOS, WINDOWS und UNIX liefert APPEND_TEXT als Ergebnis stets -1.

Beispiel:

FOR I% = 1 to 100
     IF APPEND_TEXT(#5.#EDIT$,TABELLE$(i%)) <> 0
     THEN ...
Fehler
     ELSE REPAINT
     ENDIF
ENDLOOP

siehe auch:

REPAINT