


XtOwnSelection(3Xt)					  XtOwnSelection(3Xt)
X11R5									X11R5



NAME
  XtOwnSelection, XtDisownSelection - set selection owner

SYNTAX
  Boolean XtOwnSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e, _c_o_n_v_e_r_t__p_r_o_c, _l_o_s_e__s_e_l_e_c_t_i_o_n,
  _d_o_n_e__p_r_o_c)
	Widget _w;
	Atom _s_e_l_e_c_t_i_o_n;
	Time _t_i_m_e;
	XtConvertSelectionProc _c_o_n_v_e_r_t__p_r_o_c;
	XtLoseSelectionProc _l_o_s_e__s_e_l_e_c_t_i_o_n;
	XtSelectionDoneProc _d_o_n_e__p_r_o_c;

  void XtDisownSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e)
	Widget _w;
	Atom _s_e_l_e_c_t_i_o_n;
	Time _t_i_m_e;

ARGUMENTS

  _c_o_n_v_e_r_t__p_r_o_c
	    Specifies the procedure that is to be called whenever someone
	    requests the current value of the selection.

  _d_o_n_e__p_r_o_c Specifies the procedure that is called after the requestor has
	    received the selection or NULL if the owner	is not interested in
	    being called back.

  _l_o_s_e__s_e_l_e_c_t_i_o_n
	    Specifies the procedure that is to be called whenever the widget
	    has	lost selection ownership or NULL if the	owner is not
	    interested in being	called back.

  _s_e_l_e_c_t_i_o_n Specifies an atom that describes the type of the selection (for
	    example, _X_A__P_R_I_M_A_R_Y, _X_A__S_E_C_O_N_D_A_R_Y, or _X_A__C_L_I_P_B_O_A_R_D).

  _t_i_m_e	    Specifies the timestamp that indicates when	the selection owner-
	    ship should	commence or is to be relinquished.

  _w	    Specifies the widget that wishes to	become the owner or to relin-
	    quish ownership.

DESCRIPTION
  The _X_t_O_w_n_S_e_l_e_c_t_i_o_n function informs the Intrinsics selection mechanism that
  a widget believes it owns a selection.  It returns _T_r_u_e if the widget	has
  successfully become the owner	and _F_a_l_s_e otherwise.  The widget may fail to
  become the owner if some other widget	has asserted ownership at a time
  later	than this widget.  Note	that widgets can lose selection	ownership
  either because someone else asserted later ownership of the selection	or
  because the widget voluntarily gave up ownership of the selection.  Also
  note that the	lose_selection procedure is not	called if the widget fails to
  obtain selection ownership in	the first place.

  The _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n	function informs the Intrinsics	selection mechanism
  that the specified widget is to lose ownership of the	selection.  If the
  widget does not currently own	the selection either because it	lost the
  selection or because it never	had the	selection to begin with, _X_t_D_i_s_o_w_n_-
  _S_e_l_e_c_t_i_o_n does nothing.

  After	a widget has called _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n, its convert procedure is	not
  called even if a request arrives later with a	timestamp during the period
  that this widget owned the selection.	 However, its done procedure will be
  called if a conversion that started before the call to _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n
  finishes after the call to _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n.

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























































