Man page 3 : XTranslateCoordinates

XTranslateCoordinates - translate window coordinates

Bool XTranslateCoordinates(Display *display, Window src_w, dest_w, int src_x, int src_y, int *dest_x_return, int *dest_y_return, Window *child_return);

child_return 1i Returns the child if the coordinates are contained in a mapped child of the destination window.

dest_w 1i Specifies the destination window.

dest_x_return 1i

dest_y_return 1i Return the x and y coordinates within the destination window.

display 1i Specifies the connection to the X server.

src_w 1i Specifies the source window.

src_x 1i

src_y 1i Specify the x and y coordinates within the source window.

If .ZN XTranslateCoordinates returns .ZN True , it takes the src_x and src_y coordinates relative to the source window's origin and returns these coordinates to dest_x_return and dest_y_return relative to the destination window's origin. If .ZN XTranslateCoordinates returns .ZN False , src_w and dest_w are on different screens, and dest_x_return and dest_y_return are zero. If the coordinates are contained in a mapped child of dest_w, that child is returned to child_return. Otherwise, child_return is set to .ZN None .

.ZN XTranslateCoordinates can generate a .ZN BadWindow error.

• .ZN BadWindow
   A value for a Window argument does not name a defined Window.

\*(xL