XTranslateCoordinates(3)

NAME

       XTranslateCoordinates - translate window coordinates

SYNTAX

       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);

ARGUMENTS

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

       dest_w    Specifies the destination window.

       dest_x_return
       dest_y_return
                 Return the x and y coordinates within the destination 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 origin and returns these
       coordinates to dest_x_return and dest_y_return relative to the destina-
       tion 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                     libX11 1.1.1         XTranslateCoordinates(3)