XTranslateCoordinates
Section: XLIB FUNCTIONS (3X11)
Updated: Release 5
Index
Return to Main Contents
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
Index
- NAME
-
- SYNTAX
-
- ARGUMENTS
-
- DESCRIPTION
-
- DIAGNOSTICS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:03:00 GMT, May 19, 2025