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

See also:

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

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