hpux man page for xconvertselection

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()