NAME

OlUpdateDisplay − process all pending exposure events immediately

SYNOPSIS

#include <Xol/OpenLook.h>
 . . .
void OlUpdateDisplay(

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     status_area;     /∗ a staticText widget ∗/
   ...
void
fooCB(w, client_data, call_data)
     Widget     w;
     XtPointer  client_data;
     XtPointer  call_data;
     {
          ...
          Arg     args[5];
               /∗ display the status in the footer area     ∗/
               /∗ before the actual operation               ∗/
     XtSetArg(args[0], XtNstring,
                    "Start the operation, please wait ...");
     XtSetValues(status_area, args, 1);
               /∗ show the status in the footer area right away∗/
     OlUpdateDisplay(status_area);
               /∗ now we can start the actual operation     ∗/
          ...
          return;
     }

SEE ALSO

XtSetValues() in X Toolkit Intrinsics Reference Manual from O’Reilly & Associates, Inc.

Version 3.0  —  Last change: 19 July 91