window_restore_hint_c
old_restore.i4.v = window_restore_hint_c([restore_mode.i4.v])
This routine allows the application programmer to request a
restore mode for windows created by a library routine. This
request is subject to the needs of the library routines themselves.
Therefore, some routines may honor this while others may not.
[restore_mode] window restore mode (If this argument is not
supplied, the routine will return the present
restore mode only.)
(CLIB_DEFAULT_ARG -> simply return the present
restore mode,
WMNGR_REPAINT -> repaint underlying windows,
WMNGR_RESTORE_BACKGROUND -> repaint obscured text
(default))
This function returns status values as follows:
CBS_INVARG invalid window restore mode was specified
CBS_MEMFAIL dynamic memory allocation failure
otherwise previous restore mode
This function requires the following include files:
cbslib_h, acnet_errors_h
Related functions:
window_construct(_c), window_create(_c), window_delete(_c),
intro_tv_windows
C/C++ usage:
short window_id;
int old_restore;
int restore_mode = WMNGR_REPAINT;
old_restore = window_restore_hint_c(restore_mode);