<<

Contents

Search

>>

 

EDITOR_HAS_CHANGED

 

 

Function

 

 

Syntax:

EDITOR_HAS_CHANGED(<Mask Field>[,<Handle>])

 

<Mask Field>

= <MASK FIELD>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Returns the internal change flag of the Word Processor. EDITOR_HAS_CHANGED returns 1 if the content in the Word Processor has been changed, otherwise it returns 0.

 

<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_HAS_CHANGED returns the following results:

Result

Meaning

0

Content of Word Processor has not changed.

1

Content of Word Processor has changed.

-1

<Mask Field> not found.

-2

<Mask Field> is not a Word Processor.

 

The internal change flag of the Word Processor is reset with the following events:

1. At the start of the Word Processor
2. When a new document is created (ALT/1)
3. When a document is opened (ALT/2)
4. When a text is saved (ALT/3)
5. When the following commands are executed:
EDITOR_LOAD_FILE, EDITOR_LOAD_STRING, EDITOR_RESET_CHANGED

 

Attention: This function has no effect with Html programs.

 

Parameter:

Mask Field

Word Processor field

Handle

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

 

Sample:

H% = EDITOR_HAS_CHANGED(#5.#PROCESSOR$)

IF H% = 1

THEN ... ask the user whether data shall be saved ...

ENDIF

 

See also:

EDITOR_GET_CURSOR

EDITOR_GET_STYLEDTEXT$

EDITOR_GET_TEXT$

EDITOR_INSERT

EDITOR_LOAD_FILE

EDITOR_LOAD_STRING

EDITOR_RESET_CHANGED

EDITOR_SET_COLOR

EDITOR_SET_CURSOR

EDITOR_SET_STYLE

GET_STYLEDTEXT_FROM_FILE$