PROCESS-EVENTS Action

This document covers the following topics:


Description

Processes all outstanding messages for the Natural application (raising any associated events) before returning. This is particularly useful for allowing the user to interrupt a long operation. Typically, you create a simple abort dialog of style 'modal' with a 'Cancel' push button, and call this action periodically whilst processing the long operation. If the user has clicked the 'Cancel' push button in the meantime, the CLICK Event for this button will be received during the call, which typically sets an abort flag that can be tested on return and handled accordingly.

Note:
This action must be used with care, because ALL user interactions with the application will be processed during the call. This includes clicks on tool bar or menu items, for instance, unless these are explicitly disabled, or if a modal dialog is currently on display (as in the above example).

Parameters

Response (I4) Output

Natural error (if applicable).

Example:

PROCESS GUI ACTION PROCESS-EVENTS 
GIVING #RESPONSE