Manual pages › X Window and screen libraries (3X)

XTranWCo(3X)

translate window coordinates

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

XTranslateCoordinates - translate window coordinates

SYNTAX

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

child_return

Returns the child if the coordinates are contained in a mapped child of the destination window.

dest_w    Specifies the destination window.

dest_x_return
dest_y_return
          Return the x and y coordinates within the destina-
          tion window.

display   Specifies the connection to the XWIN server.

src_w     Specifies the source window.

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

DESCRIPTION

The XTranslateCoordinates function takes the src_x and src_y
coordinates relative to the source window's origin and
returns these coordinates to dest_x_return and dest_y_return
relative to the destination window's origin.

If XTranslateCoordinates returns zero, src_w and dest_w are
on different screens, and dest_x_return and dest_y_return
are zero.  If the coordinates are contained in a mapped
child of dest_w, that child is returned to child_return.
Otherwise, child_return is set to None.

XTranslateCoordinates can generate a BadWindow error.

DIAGNOSTICS

BadWindow A value for a Window argument does not name a

defined Window.