OlUpdateDisplay(3W) UNIX System V OlUpdateDisplay(3W)
NAME
OlUpdateDisplay - process all pending exposure events immediately
SYNOPSIS
#include <Xol/OpenLook.h>
...
void
OlUpdateDisplay(w)
Widget w;
DESCRIPTION
The OlUpdateDisplay procedure is used to process all pending exposure
events so that the appearance of a given widget can be updated right
away.
Normally, an operation is accomplished by a set of callback functions. If
one of the callback functions performs a time-consuming action, it is
possible that the portion of an application window will not be redrawn
right away after a XtSetValues() call. This is because the normal
exposure processing does not occur until all callback functions have been
invoked. This situation can be resolved by calling this function before
starting a time-consuming action.
EXAMPLE
...
#include <Xol/OpenLook.h>
...
extern Widget statusarea; /* a staticText widget */
...
void
fooCB(w, clientdata, calldata)
Widget w;
XtPointer clientdata;
XtPointer calldata;
{
...
Arg args[5];
/* display the status in the footer area */
/* before the actual operation */
XtSetArg(args[0], XtNstring,
"Start the operation, please wait ...");
XtSetValues(statusarea, args, 1);
/* show the status in the footer area right away*/
OlUpdateDisplay(statusarea);
/* now we can start the actual operation */
...
return;
}
10/89 Page 1
OlUpdateDisplay(3W) UNIX System V OlUpdateDisplay(3W)
SEE ALSO
XtSetValues() in "X Toolkit Intrinsics Reference Manual" from O'Reilly &
Associates, Inc.
Page 2 10/89