XTranslateCoordinates(3X)




XTranslateCoordinates(3X)               XTranslateCoordinates(3X)



NAME
     XTranslateCoordinates - translates window coordinates

SYNOPSIS
     int 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;

DESCRIPTION
     The XTranslateCoordinates function takes the src-x and src-y
     coordinates within the source window relative to the source
     window's origin, and returns these coordinates in dest-x-
     return and dest-y-return relative to the destination
     window's origin.  If XTranslateCoordinates returns 0, src-w
     and dest-w are on different screens, and dest-x-return and
     dest-y-return are 0.  If the coordinates are contained in a
     mapped child of dest-w, that child is returned in the
     child-return argument.  Otherwise, child-return is set to
     None.

   Arguments
     This function accepts the following 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 ID.

     dest-x-return, dest-y-return
             Return the x and y coordinates within the destina-
             tion window.

     display Specifies the connection to the X server.

     src-w   Specifies the source window ID.

     src-x, src-y
             Specify the x and y coordinates within the source
             window.

ERRORS
     BadWindow
             A value for a Window argument does not name a de-
             fined window.






November, 1990                                                  1




XTranslateCoordinates(3X)               XTranslateCoordinates(3X)



SEE ALSO
     Xlib - C Language Interface





















































2                                                  November, 1990

Museum