%EAPPSIZE_METHOD

Perform application resize processing

function EAPPSIZE_METHOD, ^val
   a_columns            ,n
   a_rows               ,n
   a_width              ,n
   a_height             ,n

Return value

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

Arguments

a_columns

The number of columns visible in the application window. (n)

a_rows

The number of rows visible in the application window. (n)

a_width

The number of horizontal pixels visible in the application window. (n)

a_height

The number of vertical pixels visible in the application window. (n)

Discussion

%EAPPSIZE_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 %EAPPSIZE_METHOD function when the application window is resized.

A_columns and a_rows specify the visible area in the application window. Note that this could be different from the value returned by %W_INFO(WIF_SCOLS), which returns the logical size of the application window.

A_width and a_height report the size inside the application window’s client area. This does not include the size of the frame, caption bar, menu bar, toolbars, information line, nor footer.

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.