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