XTranslateCoordinates (3)
Leading comments
Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the foll...
NAME
XTranslateCoordinates - translate window coordinatesSYNTAX
- Bool XTranslateCoordinates(Display *display, Window src_w, dest_w, int src_x, int src_y, int *dest_x_return, int *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 destination window.
- display
- Specifies the connection to the X server.
- src_w
- Specifies the source window.
- src_x
-
- src_y
- Specify the x and y coordinates within the source window.
DESCRIPTION
If XTranslateCoordinates returns True, it 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 False, 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.