ACTIVATE RICHEDITTEXT

9.0B, PLBCMP GUI Only

The ACTIVATE RICHEDITTEXT statement makes an RICHEDITTEXT visible and allows the user to interact with it. An optional execution label may be provided to process information if the user selects the RICHEDITTEXT. The instruction uses the following format:

[label]

ACTIVATE

{richedittext}[,{routine},{result}]

Where:

label

Optional. A Program Execution Label.

richedittext

Required. The name of a previously created RICHEDITTEXT object variable or a pointer to a RICHEDITTEXT object.

routine

Optional. A program execution label called when a mouse click occurs within the screen boundaries of the object.

result

Optional. A previously defined Numeric Variable in which the result code as described below is placed upon object selection.

Flags Affected: NONE

Note the following:

The runtime performs no default action for an RICHEDITTEXT object.
The ACTIVATE instruction for the RICHEDITTEXT causes this GUI object to become visible. The optional [routine] and [result] parameters are not used and the runtime does not generate any ACTIVATE default event(s). All events for the RICHEDITTEXT object are specified and implemented via the EVENTREGISTER instruction.
An object must be CREATEd before it is activated. If this is not done, a runtime error of O105 is generated.
If insufficient memory is available to perform the operation, a runtime error O106 is generated.
If a FILEPI instruction is active, it is terminated.