%EAPPSTATE_METHOD

Perform application state processing

WSupported on Windows

 

 

 

 
function EAPPSTATE_METHOD, ^val
   a_state      ,n

Return value

This function should return true (1), so that other return values may be used in the future. (n)

Arguments

a_state

One of the following states defined in tools.def: (n)

WPS_NORMAL

Window was restored.

WPS_MINIMIZED

Window was minimized.

WPS_MAXIMIZED

Window was maximized.

WPS_HIDDEN

Window was hidden.

Discussion

%EAPPSTATE_METHOD is a function that you write and name. The name of your function is registered with UI Toolkit using the E_METHOD subroutine.

UI Toolkit calls your %EAPPSTATE_METHOD function when the state of the application window changes.

Because Toolkit invokes this function as a direct callback, the code in this function should be kept to a minimum, and operations that could conflict with concurrent processing avoided. For example, any action causing the rebuilding of an input set (such as I_SETDEL) must be avoided because this would give the user the opportunity to create a fatal error condition in I_INPUT. Instead, use %M_SIGNAL to synchronize processing for all such cases.

See also