fgl_eventloop()

Waits for a user interaction event.

Syntax

fgl_eventloop()
   RETURNING status BOOLEAN
  1. status is boolean indicating if the user event loop must continue.

Usage

The fgl_eventloop() function is used to implement the parallel dialog main event loop, in conjuction with START DIALOG / TERMINATE DIALOG instructions, used to register and end parallel dialogs.

The function waits until a user interaction event occurs and returns TRUE or FALSE to indicate if the event loop must continue or stop. It is typically used in a WHILE / END WHILE loop:

WHILE fgl_eventLoop()
END WHILE

Parallel dialogs are registrer with the START DIALOG instruction. As long as at least one parallel dialog is registered, the fgl_evenLoop() function returns TRUE. When the last parallel dialog is ended with a TERMINATE DIALOG instruction, the fgl_evenLoop() function returns FALSE and the even loop is stopped.