


XtGetSelectionValue(3Xt)			     XtGetSelectionValue(3Xt)
X11R5									X11R5



NAME
  XtGetSelectionValue, XtGetSelectionValues - obtain selection values

SYNTAX
  void XtGetSelectionValue(_w, _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t, _c_a_l_l_b_a_c_k, _c_l_i_e_n_t__d_a_t_a,	_t_i_m_e)
	Widget _w;
	Atom _s_e_l_e_c_t_i_o_n;
	Atom _t_a_r_g_e_t;
	XtSelectionCallbackProc	_c_a_l_l_b_a_c_k;
	XtPointer _c_l_i_e_n_t__d_a_t_a;
	Time _t_i_m_e;

  void XtGetSelectionValues(_w, _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t_s, _c_o_u_n_t, _c_a_l_l_b_a_c_k,
  _c_l_i_e_n_t__d_a_t_a, _t_i_m_e)
	Widget _w;
	Atom _s_e_l_e_c_t_i_o_n;
	Atom *_t_a_r_g_e_t_s;
	int _c_o_u_n_t;
	XtSelectionCallbackProc	_c_a_l_l_b_a_c_k;
	XtPointer _c_l_i_e_n_t__d_a_t_a;
	Time _t_i_m_e;

ARGUMENTS

  _c_a_l_l_b_a_c_k  Specifies the callback procedure that is to	be called when the
	    selection value has	been obtained.

  _c_l_i_e_n_t__d_a_t_a
	    Specifies the argument that	is to be passed	to the specified pro-
	    cedure when	it is called.

  _c_l_i_e_n_t__d_a_t_a
	    Specifies the client data (one for each target type) that is
	    passed to the callback procedure when it is	called for that	tar-
	    get.

  _c_o_u_n_t	    Specifies the length of the	targets	and client_data	lists.

  _s_e_l_e_c_t_i_o_n Specifies the particular selection desired (that is, primary or
	    secondary).

  _t_a_r_g_e_t    Specifies the type of the information that is needed about the
	    selection.

  _t_a_r_g_e_t_s   Specifies the types	of information that is needed about the
	    selection.

  _t_i_m_e	    Specifies the timestamp that indicates when	the selection value
	    is desired.

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

DESCRIPTION
  The _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e function requests the	value of the selection that
  has been converted to	the target type. The specified callback	will be
  called some time after _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e is	called;	in fact, it may	be
  called before	or after _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e returns.

  The _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s function is similar to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e except
  that it takes	a list of target types and a list of client data and obtains
  the current value of the selection converted to each of the targets.	The
  effect is as if each target were specified in	a separate call	to _X_t_G_e_t_-
  _S_e_l_e_c_t_i_o_n_V_a_l_u_e.  The callback	is called once with the	corresponding client
  data for each	target.	 _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s does guarantee that all the
  conversions will use the same	selection value	because	the ownership of the
  selection cannot change in the middle	of the list, as	would be when calling
  _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e repeatedly.

SEE ALSO
  XtAppGetSelectionTimeout(3Xt), XtOwnSelection(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




















































