hpux man page for xtranslatecoordinates

XTranslateCoordinates() 												   XTranslateCoordinates()

Name
  XTranslateCoordinates - change the coordinate system from one window to another.

Synopsis
  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
  display     Specifies a connection to an X server; returned from XOpenDisplay().

  src_w       Specifies the ID of the source window.

  dest_w      Specifies the ID of the frame of reference window.

  src_x       Specify the x and y coordinates within the source window.
  src_y

  dest_x_returReturn the translated x and y coordinates within the frame of reference window.
  dest_y_return
  child       If the point is contained in a mapped child of the destination window, then that child ID is returned in child.

Returns
  True if the two windows are on the same screen, else False.

Description
  XTranslateCoordinates() translates coordinates from the frame of reference of one window to another.

  XTranslateCoordinates()  returns  False and *dest_x_return and *dest_y_return are set to zero if src_w and dest_w are on different screens.
  In addition, if the coordinates are contained in a mapped child of dest_w, then that child is returned in the child_return argument.	 When
  src_w  and  frame_y are on the same screen, XTranslateCoordinates() returns True, sets *dest_x_return and *dest_y_return to the location of
  the point relative to dest_w, and sets child_return to None.

  This function should be avoided in most applications since it requires a roundtrip request to the server.  Most applications	benefit  from
  the  window-based coordinate system anyway and don't need global coordinates.  Window managers often need to perform a coordinate transfor-
  mation from the coordinate space of one window to another, or unambiguously determine which subwindow a coordinate lies in.	XTranslateCo-
  ordinates() fulfills this need, while avoiding any race conditions by asking the server to perform this operation.

Errors
  BadWindow

See Also
  XGeometry, XParseGeometry().

Xlib - Standard Geometry												   XTranslateCoordinates()