Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/pt/ptwindowfocus.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/pt/ptwindowfocus.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/pt/ptwindowfocus.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/pt/ptwindowfocus.html on line 8

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