


XTranslateCoordinates(3X11)			  XTranslateCoordinates(3X11)
X11R5									X11R5



NAME
  XTranslateCoordinates	- translate window coordinates

SYNTAX
  Bool XTranslateCoordinates(_d_i_s_p_l_a_y, _s_r_c__w, _d_e_s_t__w, _s_r_c__x, _s_r_c__y,
  _d_e_s_t__x__r_e_t_u_r_n,
			      _d_e_s_t__y__r_e_t_u_r_n, _c_h_i_l_d__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Window _s_r_c__w, _d_e_s_t__w;
	int _s_r_c__x, _s_r_c__y;
	int *_d_e_s_t__x__r_e_t_u_r_n, *_d_e_s_t__y__r_e_t_u_r_n;
	Window *_c_h_i_l_d__r_e_t_u_r_n;

ARGUMENTS

  _c_h_i_l_d__r_e_t_u_r_n
	    Returns the	child if the coordinates are contained in a mapped
	    child of the destination window.

  _d_e_s_t__w    Specifies the destination window.

  _d_e_s_t__x__r_e_t_u_r_n
  _d_e_s_t__y__r_e_t_u_r_n
	    Return the x and y coordinates within the destination window.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _s_r_c__w	    Specifies the source window.

  _s_r_c__x
  _s_r_c__y	    Specify the	x and y	coordinates within the source window.

DESCRIPTION
  If _X_T_r_a_n_s_l_a_t_e_C_o_o_r_d_i_n_a_t_e_s returns _T_r_u_e, it takes the src_x and	src_y coordi-
  nates	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 _X_T_r_a_n_s_l_a_t_e_C_o_o_r_d_i_n_a_t_e_s returns _F_a_l_s_e, 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 _N_o_n_e.

  _X_T_r_a_n_s_l_a_t_e_C_o_o_r_d_i_n_a_t_e_s	can generate a _B_a_d_W_i_n_d_o_w error.

DIAGNOSTICS

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e









