


XtSetArg(3Xt)							XtSetArg(3Xt)
X11R5									X11R5



NAME
  XtSetArg, XtMergeArgLists - set and merge ArgLists

SYNTAX
  XtSetArg(_a_r_g,	_n_a_m_e, _v_a_l_u_e)
	Arg _a_r_g;
	String _n_a_m_e;
	XtArgVal _v_a_l_u_e;

  ArgList XtMergeArgLists(_a_r_g_s_1, _n_u_m__a_r_g_s_1, _a_r_g_s_2, _n_u_m__a_r_g_s_2)
       ArgList _a_r_g_s_1;
       Cardinal	_n_u_m__a_r_g_s_1;
       ArgList _a_r_g_s_2;
       Cardinal	_n_u_m__a_r_g_s_2;

ARGUMENTS

  _a_r_g	    Specifies the name-value pair to set.

  _a_r_g_s_1	    Specifies the first	_A_r_g_L_i_s_t.

  _a_r_g_s_2	    Specifies the second _A_r_g_L_i_s_t.

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

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

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

  _v_a_l_u_e	    Specifies the value	of the resource	if it will fit in an _X_t_A_r_g_V_a_l
	    or the address.

DESCRIPTION
  The _X_t_S_e_t_A_r_g function	is usually used	in a highly stylized manner to minim-
  ize the probability of making	a mistake; for example:

  Arg args[20];	int n;

  n = 0; XtSetArg(args[n], XtNheight, 100);	 n++; XtSetArg(args[n],
  XtNwidth, 200);	n++; XtSetValues(widget, args, n);

  Alternatively, an application	can statically declare the argument list and
  use _X_t_N_u_m_b_e_r:

  static Args args[] = {
	  {XtNheight, (XtArgVal) 100},
	  {XtNwidth, (XtArgVal)	200}, }; XtSetValues(Widget, args,
  XtNumber(args));

  Note that you	should not use auto-increment or auto-decrement	within the
  first	argument to _X_t_S_e_t_A_r_g.  _X_t_S_e_t_A_r_g	can be implemented as a	macro that
  dereferences the first argument twice.

  The _X_t_M_e_r_g_e_A_r_g_L_i_s_t_s function allocates enough	storage	to hold	the combined
  _A_r_g_L_i_s_t structures and copies	them into it.  Note that it does not check
  for duplicate	entries.  When it is no	longer needed, free the	returned
  storage by using _X_t_F_r_e_e.

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






























































