XTranslateCoordinates(3X11)

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