NAME
XtGetSelectionValueIncremental, XtGetSelectionValuesIncremental - obtain selection values
SYNTAX
void XtGetSelectionValueIncremental(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 XtGetSelectionValuesIncremental(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 procedure
-
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 target.
-
_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_I_n_c_r_e_m_e_n_t_a_l
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 the _s_e_l_e_c_t_i_o_n___c_a_l_l_b_a_c_k procedure will be called
repeatedly upon delivery of multiple segments of the selection value.
The end of the selection value is indicated when _s_e_l_e_c_t_i_o_n___c_a_l_l_b_a_c_k
is called with a non-NULL value of length zero, which must still be
freed by the client. If the transfer of the selection is aborted in the
middle of a transfer (for example, because to timeout), the
_s_e_l_e_c_t_i_o_n___c_a_l_l_b_a_c_k procedure is called with a type value equal
to the symbolic constant
_X_T___C_O_N_V_E_R_T___F_A_I_L
so that the requestor can dispose of the partial selection value it has
collected up until that point. Upon receiving
_X_T___C_O_N_V_E_R_T___F_A_I_L,
the requesting client must determine for itself whether or not a
partially completed transfer is meaningful.
The
_X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s_I_n_c_r_e_m_e_n_t_a_l
function is similar to
_X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_t_a_l
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_I_n_c_r_e_m_e_n_t_a_l.
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_I_n_c_r_e_m_e_n_t_a_l
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_I_n_c_r_e_m_e_n_t_a_l
repeatedly.
SEE ALSO
_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