XTranslateCoordinates(XS) 6 January 1993 XTranslateCoordinates(XS)
X Version 11 (Release 5)
Name
XTranslateCoordinates - 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
childreturn Returns the child if the coordinates are contained in a
mapped child of the destination window.
destw Specifies the destination window.
destxreturn
destyreturn Return the x and y coordinates within the destination win-
dow.
display Specifies the connection to the X server.
srcw Specifies the source window.
srcx
srcy Specify the x and y coordinates within the source window.
Description
If XTranslateCoordinates returns True, it takes the srcx and srcy coor-
dinates relative to the source window's origin and returns these coordi-
nates to destxreturn and destyreturn relative to the destination
window's origin. If XTranslateCoordinates returns False, srcw and
destw are on different screens, and destxreturn and destyreturn are
zero. If the coordinates are contained in a mapped child of destw, that
child is returned to childreturn. 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 Win-
dow.
See also
Xlib - C Language X Interface