ACTIVATE EDITNUMBER

8.7C, PLBCMP GUI Only

 

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

 

 

[label]

ACTIVATE

{editnumber}[,{routine},{result}]

 

Where:

label

Optional. A Program Execution Label.

editnumber

Required. The name of a previously created EDITNUMBER object variable or a pointer to an EDITNUMBER 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:

  1. The runtime performs no default action for an EDITNUMBER object.

  2. The ACTIVATE instruction for the EDITNUMBER 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 EDITNUMBER object are specified and implemented via the EVENTREGISTER instruction.

  3. An object must be CREATEd before it is activated. If this is not done, a runtime error of O105 is generated.

  4. If insufficient memory is available to perform the operation, a runtime error O106 is generated.

  5. If a FILEPI instruction is active, it is terminated.

 

 

See Also: Example Code, ACTIVATE, DEACTIVATE, Object Output Instructions

 


PL/B Language Reference ACTIVATE EDITDATETIME ACTIVATE EDITTEXT