DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 
X Version 11 (Release 5)

XTranslateCoordinates(XS)


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
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003