XTranslateCoordinates


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 con- tained in a mapped child of the destination win- dow. dest_w Specifies the destination window. dest_x_return dest_y_return Return the x and y coordinates within the desti- nation 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 ori- gin 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

Man(1) output converted with man2html