This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ApModalWait()

Process Photon events until a given widget is destroyed

Synopsis:

int ApModalWait( PtWidget_t *widget,
                 unsigned flags );

Arguments:

widget

A pointer to the widget whose destruction you want to wait for.

flags

Any combination of the following:

• Ap_MODAL_BLOCK_WINDOWS -- block all of 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.

Library:

Ap

Description:

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

Returns:

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

Classification:

Photon

See also:

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

"Threads" in the Parallel Operations chapter, "Modal dialogs" in the Window Management chapter of the Photon Programmer's Guide