[Previous] [Contents] [Index] [Next]

PtProcessEvent()

Standard Photon event-handling function

Synopsis:

void PtProcessEvent( void );

Library:

ph

Description:

This function is used primarily for modal-dialog-event handling. If this case, be sure to call PtModalStart() before the event-handling loop, and PtModalEnd() after it.


Note: We recommend using PtModalBlock() and PtModalUnblock() instead of a PtModalStart() / PtProcessEvent() / PtModalEnd() loop. PtModalBlock() makes it easier for you to write modal code that's compatible with multithreaded applications.

If a Photon event is pending, this function processes the event and returns. If no event is pending, or if no work procedure has been defined, the function puts the application into REPLY-blocked mode.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtModalBlock(), PtModalEnd(), PtModalStart(), PtModalUnblock(),

"Modal dialogs" in the Window Management chapter of the Photon Programmer's Guide


[Previous] [Contents] [Index] [Next]