NAME

XSetSelectionOwner, XGetSelectionOwner, XConvertSelection - manipulate window selection

SYNTAX

int XSetSelectionOwner(Display *_d_i_s_p_l_a_y, Atom _s_e_l_e_c_t_i_o_n, Window _o_w_n_e_r, Time _t_i_m_e); Window XGetSelectionOwner(Display *_d_i_s_p_l_a_y, Atom _s_e_l_e_c_t_i_o_n); int XConvertSelection(Display *_d_i_s_p_l_a_y, Atom _s_e_l_e_c_t_i_o_n, Atom _t_a_r_g_e_t, Atom _p_r_o_p_e_r_t_y, Window _r_e_q_u_e_s_t_o_r, Time _t_i_m_e);

ARGUMENTS

_d_i_s_p_l_a_y Specifies the connection to the X server.
_o_w_n_e_r Specifies the owner of the specified selection atom.
You can pass a window or _N_o_n_e.
_p_r_o_p_e_r_t_y Specifies the property name.
You also can pass _N_o_n_e.
_r_e_q_u_e_s_t_o_r Specifies the requestor.
_s_e_l_e_c_t_i_o_n Specifies the selection atom.
_t_a_r_g_e_t Specifies the target atom.
_t_i_m_e Specifies the time.
You can pass either a timestamp or _C_u_r_r_e_n_t_T_i_m_e.

DESCRIPTION

The _X_S_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r function changes the owner and last-change time for the specified selection and has no effect if the specified time is earlier than the current last-change time of the specified selection or is later than the current X server time. Otherwise, the last-change time is set to the specified time, with _C_u_r_r_e_n_t_T_i_m_e replaced by the current server time. If the owner window is specified as _N_o_n_e, then the owner of the selection becomes _N_o_n_e (that is, no owner). Otherwise, the owner of the selection becomes the client executing the request.

If the new owner (whether a client or _N_o_n_e) is not the same as the current owner of the selection and the current owner is not _N_o_n_e, the current owner is sent a _S_e_l_e_c_t_i_o_n_C_l_e_a_r event. If the client that is the owner of a selection is later terminated (that is, its connection is closed) or if the owner window it has specified in the request is later destroyed, the owner of the selection automatically reverts to _N_o_n_e, but the last-change time is not affected. The selection atom is uninterpreted by the X server. _X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r returns the owner window, which is reported in _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t and _S_e_l_e_c_t_i_o_n_C_l_e_a_r events. Selections are global to the X server.

_X_S_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r can generate _B_a_d_A_t_o_m and _B_a_d_W_i_n_d_o_w errors.

The _X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r function returns the window ID associated with the window that currently owns the specified selection. If no selection was specified, the function returns the constant _N_o_n_e. If _N_o_n_e is returned, there is no owner for the selection.

_X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r can generate a _B_a_d_A_t_o_m error.

_X_C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n requests that the specified selection be converted to the specified target type:

· If the specified selection has an owner, the X server sends a
_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t event to that owner.
· If no owner for the specified
selection exists, the X server generates a _S_e_l_e_c_t_i_o_n_N_o_t_i_f_y event to the requestor with property _N_o_n_e.

The arguments are passed on unchanged in either of the events. There are two predefined selection atoms: PRIMARY and SECONDARY.

_X_C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n can generate _B_a_d_A_t_o_m and _B_a_d_W_i_n_d_o_w errors.

DIAGNOSTICS

_B_a_d_A_t_o_m
A value for an Atom argument does not name a defined Atom.
_B_a_d_W_i_n_d_o_w
A value for a Window argument does not name a defined Window.

SEE ALSO

_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e