X11R5

NAME

XTranslateCoordinates − translate window coordinates

SYNOPSIS

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;

PARAMETERS

child_returnReturns the child if the coordinates are contained in a mapped child of the destination window. 

dest_wSpecifies the destination window. 

dest_x_return

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

displaySpecifies the connection to the X server. 

src_wSpecifies the source window. 

src_x

src_ySpecify 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 origin 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.

ERRORS

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

RELATED INFORMATION

X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys