PtBkgdHandlerProcess()

Process all outstanding Photon events

Synopsis:

void PtBkgdHandlerProcess( void );

Library:

ph

Description:

This function processes all outstanding Photon events, calling PtProcessEvent() for each event. You should call this routine periodically during a costly or complex processing loop when you won't be giving control to the widget library. This gives the widget library an opportunity to redraw widgets that have been damaged or exposed if, for example, the user drags a window around.

---

It's safe to call PtBkgdHandlerProcess() in callbacks, work procedures, and input procedures, but not in a widget's Draw method or a PtRaw widget's drawing function.

---

Examples:

{
int done = 0;
while ( !done ) 
{

    /* Handle all pending Photon events */
    PtBkgdHandlerProcess( );
    /* Do some work, setting done if finished */
    }
}

Classification:

Photon

See also:

Parallel Operations chapter of the Photon Programmer's Guide