


XtNameToWidget(3Xt)					  XtNameToWidget(3Xt)
X11R5									X11R5



NAME
  XtNameToWidget, XtWindowToWidget - translating strings to widgets or wid-
  gets to windows

SYNTAX
  Widget XtNameToWidget(_r_e_f_e_r_e_n_c_e, _n_a_m_e_s);
	Widget _r_e_f_e_r_e_n_c_e;
	String _n_a_m_e_s;

  Widget XtWindowToWidget(_d_i_s_p_l_a_y, _w_i_n_d_o_w)
	Display	*_d_i_s_p_l_a_y;
	Window _w_i_n_d_o_w;

ARGUMENTS

  _d_i_s_p_l_a_y   Specifies the display on which the window is defined.

  _n_a_m_e_s	    Specifies the fully	qualified name of the desired widget.

  _r_e_f_e_r_e_n_c_e Specifies the widget from which the	search is to start.

  _w_i_n_d_o_w    Specify the	window for which you want the widget.

DESCRIPTION
  The _X_t_N_a_m_e_T_o_W_i_d_g_e_t function looks for	a widget whose name is the first com-
  ponent in the	specified names	and that is a pop-up child of reference	(or a
  normal child if reference is a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s).  It	then
  uses that widget as the new reference	and repeats the	search after deleting
  the first component from the specified names.	 If it cannot find the speci-
  fied widget, _X_t_N_a_m_e_T_o_W_i_d_g_e_t returns NULL.

  Note that the	names argument contains	the name of a widget with respect to
  the specified	reference widget and can contain more than one widget name
  (separated by	periods) for widgets that are not direct children of the
  specified reference widget.

  If more than one child of the	reference widget matches the name, _X_t_N_a_m_e_-
  _T_o_W_i_d_g_e_t can return any of the children.  The	Intrinsics do not require
  that all children of a widget	have unique names.  If the specified names
  contain more than one	component and if more than one child matches the
  first	component, _X_t_N_a_m_e_T_o_W_i_d_g_e_t can return NULL if the single	branch that
  it follows does not contain the named	widget.	 That is, _X_t_N_a_m_e_T_o_W_i_d_g_e_t does
  not back up and follow other matching	branches of the	widget tree.

  The _X_t_W_i_n_d_o_w_T_o_W_i_d_g_e_t function	translates the specified window	and display
  pointer into the appropriate widget instance.

SEE ALSO
  _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








