XConvertSelection() XConvertSelection()
Name
XConvertSelection - 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 property 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 selection
request.
Description
XConvertSelection() 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 specified 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 Also
XGetSelectionOwner(), XSetSelectionOwner().
Xlib - Selections XConvertSelection()
