procedure StartModal

Usage

Available In: Visual Client Applications

Use this method to put the user interface into a modal state and increment the global modal reference count. The EndModal method decrements the reference count and takes the application out of the modal state when the reference count reaches zero.

When the user interface is in the modal state, the application user cannot use the mouse/touch or keyboard to interact with the user interface. This is useful in situations where you want to execute an asynchronous operation like a server request and don't want to allow the user to interact with the user interface while the server request is in progress.