XTranslateCoordinates(3X11XLIB FUNCTIOXTranslateCoordinates(3X11)NAMEXTranslateCoordinates - translate window coordinates
SYNTAX
Bool XTranslateCoordinates(display, src_w, dest_w, src_x,
src_y, dest_x_return,
dest_y_return, child_return)
Display *display;
Window src_w, dest_w;
int src_x, src_y;
int *dest_x_return, *dest_y_return;
Window *child_return;
ARGUMENTS
child_return
Returns the child if the coordinates are con-
tained in a mapped child of the destination win-
dow.
dest_w Specifies the destination window.
dest_x_return
dest_y_return
Return the x and y coordinates within the desti-
nation window.
display Specifies the connection to the X server.
src_w Specifies the source window.
src_x
src_y Specify the x and y coordinates within the
source window.
DESCRIPTION
If XTranslateCoordinates returns True, it takes the src_x
and src_y coordinates relative to the source window's ori-
gin and returns these coordinates to dest_x_return and
dest_y_return relative to the destination window's origin.
If XTranslateCoordinates returns 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 None.
XTranslateCoordinates can generate a BadWindow error.
DIAGNOSTICS
BadWindow A value for a Window argument does not name a
defined Window.
SEE ALSO
Xlib - C Language X Interface
X Version 11 Release 6.4 1
