hpux man page for xttranslata

XtTranslateCoords()													       XtTranslateCoords()

Name
  XtTranslateCoords - translate an x-y coordinate pair from widget coordinates to root coordinates.

Synopsis
  void XtTranslateCoords(w, x, y, root_x_return, root_y_return)
	 Widget w;
	 Position x, y;
	 Position *root_x_return, *root_y_return;

Inputs
  w	    Specifies the widget.

  x, y	    Specify x and y coordinates, relative to w.

Outputs
  root_x_return, root_y_return
	    Return the same x and y coordinates, relative to the root window.

Description
  XtTranslateCoords()  transforms  the	widget-relative  coordinates  x and y into coordinates relative to the root window, and returns these
  transformed coordinates in root_x_return and root_y_return.

  XtTranslateCoords() is similar to the Xlib XTranslateCoordinates() function, which also translates window-relative coordinates to  display-
  relative coordinates.  But XtTranslateCoords() does not usually generate a server request because most of the time the required information
  is already in the widget's data structures.

Usage
  XtTranslateCoords() is useful in popping up a popup shell, since it must be explicitly moved from its default location  at  the  upper-left
  corner of the screen.  A typical approach is to pop up dialogs centered over the main application window.

See Also
  Core(3).

Xt - Window Manipulation												       XtTranslateCoords()