XSetSelectionOwner(3X11) X11R5 XSetSelectionOwner(3X11)NAME
XSetSelectionOwner, XGetSelectionOwner, XConvertSelection - manipulate
window selection
SYNTAX
XSetSelectionOwner(display, selection, owner, time)
Display *display;
Atom selection;
Window owner;
Time time;
Window XGetSelectionOwner(display, selection)
Display *display;
Atom selection;
XConvertSelection(display, selection, target, property, requestor,
time)
Display *display;
Atom selection, target;
Atom property;
Window requestor;
Time time;
ARGUMENTS
display Specifies the connection to the X server.
owner Specifies the owner of the specified selection atom. You can
pass a window or
property Specifies the property name. You also can pass
requestor Specifies the requestor.
selection Specifies the selection atom.
target Specifies the target atom.
time Specifies the time. You can pass either a timestamp or
DESCRIPTION
The 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 replaced by the current server time. If the
owner window is specified as then the owner of the selection becomes
(that is, no owner). Otherwise, the owner of the selection becomes the
client executing the request.
If the new owner (whether a client or is not the same as the current
owner of the selection and the current owner is not the current owner
is sent a 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 but the last-change time is not
affected. The selection atom is uninterpreted by the X server.
returns the owner window, which is reported in and events. Selections
are global to the X server.
can generate and errors.
The function returns the window ID associated with the window that cur‐
rently owns the specified selection. If no selection was specified,
the function returns the constant If is returned, there is no owner for
the selection.
can generate a error.
requests that the specified selection be converted to the specified
target type:
· If the specified selection has an owner, the X server sends a
event to that owner.
· If no owner for the specified selection exists, the X server gen‐
erates a event to the requestor with property
The arguments are passed on unchanged in either of the events. There
are two predefined selection atoms: PRIMARY and SECONDARY.
can generate and errors.
DIAGNOSTICS
A value for an Atom argument does not name a defined Atom.
A value for a Window argument does not name a defined Window.
SEE ALSO
Xlib - C Language X Interface
XSetSelectionOwner(3X11)