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

CoreUNIX SYSTEM V/68 and V/88 Release 4.