<<

Contents

Search

>>

 

EDITOR_INSERT

 

 

Function

 

 

Syntax:

EDITOR_INSERT(<Mask Field>,<Text>[,<Handle>])

 

<Mask Field>

= <MASK FIELD>

<Text>

= <STRING-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Inserts the text <TEXT> at the current cursor position in a Word Processor.

 

<TEXT> may not contain format attributes but only the mere text.

 

The text is formatted with the attributes that apply to the current cursor position.

 

<Mask Field> has to be a Word Processor field.

 

<Handle> specifies the window that contains the word processor field. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing, the word processor field must be on the current mask.

 

EDITOR_INSERT returns the following results:

Result

Meaning

0

Success

-1

<Mask Field> not found.

-2

<Mask Field> is not a Word Processor.

-3

Could not insert text. ERRORTEXT$ contains error message.

 

Attention: This function has no effect with Html programs.

 

Parameter:

Mask Field

Word Processor field

Text

Text to insert

Handle

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

 

Sample:

H% = EDITOR_INSERT(#5.#EDIT$,"Hello")
IF H% <> 0
THEN ... Error ...
ENDIF

 

See also:

EDITOR_GET_CURSOR

EDITOR_GET_STYLEDTEXT$

EDITOR_GET_TEXT$

EDITOR_HAS_CHANGED

EDITOR_LOAD_FILE

EDITOR_LOAD_STRING

EDITOR_RESET_CHANGED

EDITOR_SET_COLOR

EDITOR_SET_CURSOR

EDITOR_SET_STYLE

GET_STYLEDTEXT_FROM_FILE$