NAME
XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection - set selection owner
SYNTAX
Boolean XtOwnSelection(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);
Boolean XtOwnSelectionIncremental(Widget _w, Atom _s_e_l_e_c_t_i_o_n, Time
_t_i_m_e, XtConvertSelectionIncrProc _c_o_n_v_e_r_t___c_a_l_l_b_a_c_k,
XtLoseSelectionIncrProc _l_o_s_e___c_a_l_l_b_a_c_k, XtSelectionDoneIncrProc
_d_o_n_e___c_a_l_l_b_a_c_k, XtCancelConvertSelectionProc _c_a_n_c_e_l___c_a_l_l_b_a_c_k,
XtPointer _c_l_i_e_n_t___d_a_t_a);
void XtDisownSelection(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 ownership should commence or is to be relinquished.
-
-
_w
Specifies the widget that wishes to become the owner or to relinquish 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_O_w_n_S_e_l_e_c_t_i_o_n_I_n_c_r_e_m_e_n_t_a_l
procedure informs the Intrinsics incremental selection mechanism that
the specified widget wishes to own the selection. It returns
_T_r_u_e
if the specified widget successfully becomes the selection owner or
_F_a_l_s_e
otherwise. For more information about _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t,
and _t_i_m_e, see Section 2.6 of the _I_n_t_e_r_-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n
_C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l.
A widget that becomes the selection owner using
_X_t_O_w_n_S_e_l_e_c_t_i_o_n_I_n_c_r_e_m_e_n_t_a_l
may use
_X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n
to relinquish selection ownership.
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