PtWindowFocus()

Give a window focus

Synopsis:

int PtWindowFocus( PtWidget_t *widget );

Description:

This function lets your application give focus to the specified window widget. To do this, the function sends a message to the Window Manager, telling it to give the window focus. The Window Manager may change consoles if the specified window isn't in the current console.

Returns:

0: Successful completion.
-1: The window wasn't found or an error occurred.

Examples:

PtWidget_t  *my_window;

/* give my window focus */
if ( 0 == PtWindowFocus( my_window ) ) {
    /* focus related processing */
    }

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtWindowToBack(), PtWindowToFront()

PtForwardWindowEvent() in the Photon Library Reference