ui.Interface.refresh

Synchronize the user interface with the front-end.

Syntax

ui.Interface.refresh()

Usage

The ui.Interface.refresh() class method forces a synchronization of the abstract user interface tree with front-end. This means that the end user will immediately see the recent form modifications done by the program.

By default, during an interactive instruction like DIALOG, the AUI tree is refreshed automatically, when the runtime system gets the control back after user code execution. Thus, there is no need to call the refresh method in regular code.

Important: Use the ui.Interface.refresh() method with care; it is only provided to synchronize with the front-end in specific cases. For example, when you need to display batch processing information to the user. Calling this method too frequently will produce a lot of network traffic.

Example

MAIN
   DEFINE i INT
   FOR i=1 TO 1000000
      DISPLAY i AT 5,5
      IF (i MOD 100) == 0 THEN
        CALL ui.Interface.refresh()
      END IF
   END FOR
END MAIN