PtBlockAllWindows()

Block all windows except the one with a given widget

Synopsis:

PtBlockedList_t *PtBlockAllWindows( 
                    PtWidget_t *skip,
                    unsigned short cursor,
                    PgColor_t cursor_color );

Library:

ph

Description:

PtBlockAllWindows() blocks all windows belonging to the calling application, except the window that contains the widget pointed to by skip (if not NULL).

If cursor isn't zero, this function sets the windows' cursors to that value and their cursor color to cursor_color (if different from Pg_TRANSPARENT). Ph_CURSOR_NOINPUT is a typical choice for the cursor; for a list of the other cursors, see <photon/PhCursor.h>.

Returns:

A pointer to a control structure that can be passed to PtUnblockWindows() to undo the changes, or NULL if an error occurred or there was nothing to do.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

ApModalWait(), PgColor_t, PtBlockWindow(), PtMakeModal(), PtUnblockWindows()

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