NAME¶
XTranslateCoordinates - translate window coordinates
SYNTAX¶
Bool
XTranslateCoordinates(Display * display, Window src_w,
dest_w, int src_x, int src_y, int * dest_x_return,
int * 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
