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

wSpecifies the widget. 

x, ySpecify 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). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates