NAME
XtSetSelectionParameters - specify target parameters for a selection request with a single target
SYNTAX
void XtSetSelectionParameters(Widget _r_e_q_u_e_s_t_o_r, Atom _s_e_l_e_c_t_i_o_n,
Atom _t_y_p_e, XtPointer _v_a_l_u_e, unsigned long _l_e_n_g_t_h, int
_f_o_r_m_a_t);
ARGUMENTS
-
_r_e_q_u_e_s_t_o_r
Specifies the widget making the request. Must be of class Core or any
-
subclass thereof.
-
_s_e_l_e_c_t_i_o_n
Specifies the atom that names the selection.
-
-
_t_y_p_e
Specifies the type of the property in which the parameters will be passed.
-
-
_v_a_l_u_e
Specifies a pointer to the parameters.
-
-
_l_e_n_g_t_h
Specifies the number of elements containing data in _v_a_l_u_e, each
-
element of a sized indicated by _f_o_r_m_a_t.
-
_f_o_r_m_a_t
Specifies the size in bits of the data in the elements of _v_a_l_u_e.
-
DESCRIPTION
The specified parameters will be copied and stored in a new property of
the specified type and format on the requestor's window. To initiate a
selection request with a target and these parameters, a subsequent call to
_X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e
or 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
specifying the same requestor widget and selection atom will generate a
_C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n
request referring referring to the property containing the parameters. If
_X_t_S_e_t_S_e_l_e_c_t_i_o_n_P_a_r_a_m_e_t_e_r_s
is called more than once with the same widget and selection without a
call to specify a request, the most recently specified parameters are
used in the subsequent request.
The possible values of _f_o_r_m_a_t may be 8, 16, or 32. If the _f_o_r_m_a_t
is 8, the elements of _v_a_l_u_e are assumed to be sizeof(char); if 16,
sizeof(short); if 32, sizeof(long).
To generate a MULTIPLE target request with parameters for any of the
multiple targets of the selection request, precede individual calls to
_X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e
and
_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
with corresponding individual calls to
_X_t_S_e_t_S_e_l_e_c_t_i_o_n_P_a_r_a_m_e_t_e_r_s,
and enclose these all within
_X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t
and
_X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t.
_X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s
and
_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
cannot be used to make selection requests with parameterized targets.
SEE ALSO
XtGetSelectionParameters(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