XTranslateCoordinates(3X11)



XTranslateCoordinates(3X11)
XLIB FUNCTION
XS
TranslateCoordinates(3X11)


NAME
       XTranslateCoordinates - translate window coordinates

SYNTAX
       Bool XTranslateCoordinates(display, srcw, destw, srcx,
       srcy, destxreturn,
                                   destyreturn, childreturn)
             Display *display;
             Window srcw, destw;
             int srcx, srcy;
             int *destxreturn, *destyreturn;
             Window *childreturn;

ARGUMENTS
       childreturn
                 Returns the child if the coordinates are con-
                 tained in a mapped child of the destination win-
                 dow.

       destw    Specifies the destination window.

       destxreturn
       destyreturn
                 Return the x and y coordinates within the desti-
                 nation window.

       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 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 5                           1
Museum
