XConvertSelection

Syntax

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.
selection	Specifies the selection atom.
target	Specifies the target atom.
property	Specifies the property name. You also can pass None .
requestor	Specifies the requestor.
time	Specifies the time. You can pass either a timestamp or CurrentTime.

Description

XConvertSelection() requests that the specified selection be converted to the specified target type:

If the specified selection has an owner, the X server sends a .PN SelectionRequest event to that owner.
If no owner for the specified selection exists, the X server generates a SelectionNotify event to the requestor with property None.

The arguments are passed on unchanged in either of the events. There are two predefined selection atoms: PRIMARY and SECONDARY.

XConvertSelection() can generate BadAtom and BadWindow errors.

Diagnostics

BadAtom	A value for an Atom argument does not name a defined Atom.
BadWindow	A value for a Window argument does not name a defined Window.

XConvertSelection

Syntax

Arguments

Description

Diagnostics

See also