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