<<

Contents

Search

>>

 

APPEND_TEXT

 

 

Function

 

 

Syntax:

APPEND_TEXT(<Mask Field>,<String Expression>[,<Handle>])

 

<Mask Field>

= <MASK FIELD>

<String Expression>

= <STRING-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

APPEND_TEXT inserts the <String Expression> at the end of the edit field <Mask Field>. This function is only successful if the <Mask Field> is an edit field.

 

If many lines are to inserted into an edit field, inserting them with APPEND_TEXT will be much quicker than assigning the whole text to the edit field variable.

 

<Handle> specifies which window contains the edit field. <Handle> can contain the window depth or the identification number of a split window or a WINDOWCALL window. If the parameter <Handle> is missing, the edit field must be on the current mask.

 

Since the changes are sometimes not shown under Java, the instruction REPAINT should be executed after APPEND_TEXT.

 

APPEND_TEXT returns the following values:

0: The function was successful.

-1: The <Mask Field> does not exist or is not an edit field.

 

Parameter:

Mask Field

Edit field, into which the text is to be inserted.

String Expression

Text to be inserted

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

Sample:

FOR I% = 1 to 100

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

    THEN ... Error ...

    ENDIF

ENDLOOP

REPAINT

 

See also:

REPAINT