


XtMakeGeometryRequest(3Xt)			   XtMakeGeometryRequest(3Xt)
X11R5									X11R5



NAME
  XtMakeGeometryRequest, XtMakeResizeRequest - make geometry manager request

SYNTAX
  XtGeometryResult XtMakeGeometryRequest(_w, _r_e_q_u_e_s_t, _r_e_p_l_y__r_e_t_u_r_n)
	Widget _w;
	XtWidgetGeometry *_r_e_q_u_e_s_t;
	XtWidgetGeometry *_r_e_p_l_y__r_e_t_u_r_n;

  XtGeometryResult XtMakeResizeRequest(_w, _w_i_d_t_h, _h_e_i_g_h_t, _w_i_d_t_h__r_e_t_u_r_n,
  _h_e_i_g_h_t__r_e_t_u_r_n)
	Widget _w;
	Dimension _w_i_d_t_h, _h_e_i_g_h_t;
	Dimension *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n

ARGUMENTS

  _r_e_p_l_y__r_e_t_u_r_n
	    Returns the	allowed	widget size or may be NULL if the requesting
	    widget is not interested in	handling _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t.

  _r_e_q_u_e_s_t   Specifies the desired widget geometry (size, position, border
	    width, and stacking	order).

  _w	    Specifies the widget that is making	the request.

  _w_i_d_t_h__r_e_t_u_r_n
  _h_e_i_g_h_t__r_e_t_u_r_n
	    Return the allowed widget width and	height.

DESCRIPTION
  Depending on the condition, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t performs the following:

  oo++    If the widget is	unmanaged or the widget's parent is not	realized, it
       makes the changes and returns _X_t_G_e_o_m_e_t_r_y_Y_e_s.

  oo++    If the parent is	not a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s or the
       parent's	geometry_manager is NULL, it issues an error.

  oo++    If the widget's being_destroyed field is	_T_r_u_e, it returns
       _X_t_G_e_o_m_e_t_r_y_N_o.

  oo++    If the widget x,	y, width, height and border_width fields are all
       equal to	the requested values, it returns _X_t_G_e_o_m_e_t_r_y_Y_e_s;	otherwise, it
       calls the parent's geometry_manager procedure with the given parame-
       ters.

  oo++    If the parent's geometry	manager	returns	_X_t_G_e_o_m_e_t_r_y_Y_e_s and if
       _X_t_C_W_Q_u_e_r_y_O_n_l_y is	not set	in the request_mode and	if the widget is
       realized, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t calls the _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w Xlib func-
       tion to reconfigure the widget's	window (set its	size, location,	and
       stacking	order as appropriate).

  oo++    If the geometry manager returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e, the change has been
       approved	and actually has been done.  In	this case, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_-
       _R_e_q_u_e_s_t does no configuring and returns _X_t_G_e_o_m_e_t_r_y_Y_e_s.  _X_t_M_a_k_e_-
       _G_e_o_m_e_t_r_y_R_e_q_u_e_s_t never returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e.

  Otherwise, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t returns the resulting value from the
  parent's geometry manager.

  Children of primitive	widgets	are always unmanaged; thus, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_-
  _R_e_q_u_e_s_t always returns _X_t_G_e_o_m_e_t_r_y_Y_e_s when called by a	child of a primitive
  widget.

  The _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t function, a simple interface to _X_t_M_a_k_e_G_e_o_m_e_t_r_y_-
  _R_e_q_u_e_s_t, creates a _X_t_W_i_d_g_e_t_G_e_o_m_e_t_r_y structure	and specifies that width and
  height should	change.	 The geometry manager is free to modify	any of the
  other	window attributes (position or stacking	order) to satisfy the resize
  request.  If the return value	is _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t, width_return and
  height_return	contain	a compromise width and height.	If these are accept-
  able,	the widget should immediately make an _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t and request
  that the compromise width and	height be applied.  If the widget is not
  interested in	_X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t replies, it can pass NULL for width_return
  and height_return.

SEE ALSO
  XtConfigureWidget(3Xt), XtQueryGeometry(3Xt)
  _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off












































