XTranslateCoordinates(3X11)



XTranslateCoordinatesRISC/os ReferenceXTranslateCoordinates(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 destina-
               tion 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
     The XTranslateCoordinates function 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 XTransla-
     teCoordinates returns zero, src_w and dest_w are on dif-
     ferent 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



                         Printed 1/24/91         Release 4 Page 1
Museum
