refresh

Controls screen updating.

Available in:

Apps (win) Apps (char) Reportwriter RPC Standalone PL
X X      

Syntax

void refresh([onoff][,noupdate])
expr          onoff
expr          noupdate

Description

onoff (optional) specifies action to take with pending updates. Default true.
  • True --- (not zero) All pending updates are performed. In addition a flag is set for the current window indicating that all future updates to that window should be performed immediately.
  • False --- (zero) no screen updates are performed until either refresh() or refresh(true) is called, or an input call is made.
noupdate (optional) controls whether grid fields are sent to the client. Applies only when onoff is false. This allows the application to update the server fields (movel2f()) and adjust the grid position but not resend the data to the client. Default false.
  • True --- (not zero) Do not send WL changes to the client.
  • False --- (zero) Send WL changes to the client when refresh() or refresh(true) is called, or an input call is made.

Example

Opens several windows with only one screen update: 
{
.
.
refresh(false);
window(W1,open);
window(W2,open);
window(W3,open);
refresh(true);
.
.
}