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

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

See also:

PtWindowToBack(), PtWindowToFront()

PtForwardWindowEvent() in the Photon Library Reference