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()