ApModalWait()

Process Photon events until a given widget is destroyed

Synopsis:

int ApModalWait( PtWidget_t *widget,
                 unsigned flags );

Library:

Ap

Description:

ApModalWait() processes Photon events until the given widget is destroyed.

The value of the flags argument is a combination of:

Ap_MODAL_BLOCK_WINDOWS: Block all the application's windows, except the one that contains widget, using PtMakeModal() while this function is running.
Pt_EVENT_PROCESS_PREVENT: Temporarily turn your thread into a nonreader: PtModalBlock() blocks on a condvar rather than processing events.
Pt_EVENT_PROCESS_ALLOW: Make sure that PtModalBlock() processes events rather than blocking on a condvar.

Returns:

0 on success, or -1 if PtModalBlock() fails.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtBlockAllWindows(), PtBlockWindow(), PtMakeModal(), PtModalBlock(), PtUnblockWindows()

"Multithreaded programs" in the Working with Code chapter, and "Modal dialogs" in the Lengthy Operations chapter of the Photon Programmer's Guide