GPR_$SET_AUTO_REFRESH GPR Calls GPR_$SET_AUTO_REFRESH
NAME
gpr_$set_auto_refresh - refreshes the window automatically.
FORMAT
gpr_$set_auto_refresh (auto_refresh, status)
DESCRIPTION
This routine directs the Display Manager to refresh the window automati-
cally.
gpr_$auto_refresh implicitly releases and reacquires the display in order
to communicate with the Display Manager.
This routine applies to the current bitmap. When a program changes
refreshes the window automatically. attribute blocks for a bitmap during
a graphics session, the auto refresh flag is lost unless you set it for
the new attribute block.
Input Parameters
auto_refresh
A Boolean value that indicates whether or not the Display Manager
will automatically refresh the application's window. A value of
true means that auto-refresh is enabled; a value of false (the
default) means that auto-refresh is disabled.
Output Parameters
status
Completion status, in status_$t format.
SEE ALSO
gpr_$set_refresh_entry.
NOTES
Automatic refresh of windows can affect system performance and reduce the
amount of disk space available, especially if the application's windows
are large.
As an alternative, the application program can also provide procedures
that refresh the screen and hidden display. See the routine
gpr_$set_refresh_entry.
You cannot use this routine to refresh overlays. Instead, you must write
a refresh procedure. This procedure must call gpr_$clear with the color
parameter set to 0 before calling any draw routines.
This routine does return an error in borrow mode.