PtForwardWindowTaskEvent()

Forward a window event, given a process ID

Synopsis:

int PtForwardWindowTaskEvent( 
       PhConnectId_t task, 
       PhWindowEvent_t const *evt);

Description:

This function is similar to PtForwardWindowEvent() - instead of specifying the destination region ID in the message, the connection ID of the task is specified. This ID is translated to the main window for this task.

In addition, a special pseudo-event (Ph_WM_SUPERSELECT) is recognized. This causes the window (and any child windows) to be moved to the current console and brought in front of any other windows. Also, the first nonblocked window is given focus.

Returns:

0: Success.
-1: An error occurred.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PhGetConnectId(), PhGetConnectInfo(), PhWindowEvent_t, PtForwardWindowEvent()

PtWindowFocus(), PtWindowToBack(), PtWindowToFront() in the Photon Widget Reference

Window Management chapter of the Photon Programmer's Guide.