


XtGetSubresources(3Xt)				       XtGetSubresources(3Xt)
X11R5									X11R5



NAME
  XtGetSubresources, XtGetApplicationResources - obtain	subresources or
  application resources

SYNTAX
  void XtGetSubresources(_w, _b_a_s_e, _n_a_m_e,	_c_l_a_s_s, _r_e_s_o_u_r_c_e_s, _n_u_m__r_e_s_o_u_r_c_e_s,
  _a_r_g_s,	_n_u_m__a_r_g_s)
	Widget _w;
	XtPointer _b_a_s_e;
	String _n_a_m_e;
	String _c_l_a_s_s;
	XtResourceList _r_e_s_o_u_r_c_e_s;
	Cardinal _n_u_m__r_e_s_o_u_r_c_e_s;
	ArgList	_a_r_g_s;
	Cardinal _n_u_m__a_r_g_s;

  void XtGetApplicationResources(_w, _b_a_s_e, _r_e_s_o_u_r_c_e_s, _n_u_m__r_e_s_o_u_r_c_e_s, _a_r_g_s,
  _n_u_m__a_r_g_s)
	Widget _w;
	XtPointer _b_a_s_e;
	XtResourceList _r_e_s_o_u_r_c_e_s;
	Cardinal _n_u_m__r_e_s_o_u_r_c_e_s;
	ArgList	_a_r_g_s;
	Cardinal _n_u_m__a_r_g_s;

ARGUMENTS

  _a_r_g_s	    Specifies the argument list	to override resources obtained from
	    the	resource database.

  _b_a_s_e	    Specifies the base address of the subpart data structure where
	    the	resources should be written.

  _c_l_a_s_s	    Specifies the class	of the subpart.

  _n_a_m_e	    Specifies the name of the subpart.

  _n_u_m__a_r_g_s  Specifies the number of arguments in the argument list.

  _n_u_m__r_e_s_o_u_r_c_e_s
	    Specifies the number of resources in the resource list.

  _r_e_s_o_u_r_c_e_s Specifies the resource list	for the	subpart.

  _w	    Specifies the widget that wants resources for a subpart or that
	    identifies the resource database to	search.

DESCRIPTION
  The _X_t_G_e_t_S_u_b_r_e_s_o_u_r_c_e_s	function constructs a name/class list from the appli-
  cation name/class, the name/classes of all its ancestors, and	the widget
  itself.  Then, it appends to this list the name/class	pair passed in.	 The
  resources are	fetched	from the argument list,	the resource database, or the
  default values in the	resource list.	Then, they are copied into the sub-
  part record.	If args	is NULL, num_args must be zero.	 However, if num_args
  is zero, the argument	list is	not referenced.

  The _X_t_G_e_t_A_p_p_l_i_c_a_t_i_o_n_R_e_s_o_u_r_c_e_s	function first uses the	passed widget, which
  is usually an	application shell, to construct	a resource name	and class
  list,	Then, it retrieves the resources from the argument list, the resource
  database, or the resource list default values.  After	adding base to each
  address, _X_t_G_e_t_A_p_p_l_i_c_a_t_i_o_n_R_e_s_o_u_r_c_e_s copies the	resources into the address
  given	in the resource	list.  If args is NULL,	num_args must be zero.	How-
  ever,	if num_args is zero, the argument list is not referenced.  The port-
  able way to specify application resources is to declare them as members of
  a structure and pass the address of the structure as the base	argument.

SEE ALSO
  XtGetResourceList(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






















































