XConvertSelection()XConvertSelection()NameXConvertSelection – request conversion of the selection.
Synopsis
XConvertSelection(display, selection, target, property,
requestor, time)
Display *display;
Atom selection, target;
Atom property;
Window requestor;
Time time;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
selection Specifies the selection atom. XA_PRIMARY and XA_SECONDARY
are the standard selection atoms.
target Specifies the atom describing the desired format for the
data.
property Specifies the property in which the requested data is to be
placed. None is also valid, but current conventions specify
that the requestor is in a better position to select a prop‐
erty than the selection owner.
requestor Specifies the requesting window.
time Specifies the time when the conversion should take place.
Pass the timestamp from the event that triggered the selec‐
tion request.
DescriptionXConvertSelection() causes a SelectionRequest event to be sent to the
current selection owner if there is one. This event specifies the
selection property (selection), the format into which to convert that
data before storing it (target), the property in which the owner will
place the information (property), the window that wants the information
(requestor), and the time of the conversion request (time).
The selection owner responds by sending a SelectionNotify event, which
confirms the selected atom and type. If no owner for the specified
selection exists, or if the owner could not convert to the type speci‐
fied by requestor, the X server generates or the owner sends a Selec‐
tionNotify event to the requestor with property None. Whether or not
the owner exists, the arguments are passed unchanged. See Volume One,
Chapter 12, Interclient Communication, for a description of selection
events and selection conventions.
Errors
BadAtom
BadWindow
See AlsoXGetSelectionOwner(), XSetSelectionOwner().
Xlib - Selections XConvertSelection()