XSetSelectionOwner, XGetSelectionOwner, XConvertSelection − manipulate window selection


int XSetSelectionOwner(Display *display, Atom selection, Window owner, Time time);

Window XGetSelectionOwner(Display *display, Atom selection);

int XConvertSelection(Display *display, Atom selection, Atom target, Atom property, Window requestor, Time time);



Specifies the connection to the X server.


Specifies the owner of the specified selection atom. You can pass a window or None.


Specifies the property name. You also can pass None.


Specifies the requestor.


Specifies the selection atom.


Specifies the target atom.


Specifies the time. You can pass either a timestamp or CurrentTime.


The XSetSelectionOwner 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 CurrentTime replaced by the current server time. If the owner window is specified as None, then the owner of the selection becomes None (that is, no owner). Otherwise, the owner of the selection becomes the client executing the request.

If the new owner (whether a client or None) is not the same as the current owner of the selection and the current owner is not None, the current owner is sent a SelectionClear 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 None, but the last-change time is not affected. The selection atom is uninterpreted by the X server. XGetSelectionOwner returns the owner window, which is reported in SelectionRequest and SelectionClear events. Selections are global to the X server.

XSetSelectionOwner can generate BadAtom and BadWindow errors.

The XGetSelectionOwner function returns the window ID associated with the window that currently owns the specified selection. If no selection was specified, the function returns the constant None. If None is returned, there is no owner for the selection.

XGetSelectionOwner can generate a BadAtom error.

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 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.



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


A value for a Window argument does not name a defined Window.


Xlib − C Language X Interface

More Linux Commands

csin(3) - complex sine function (Library - Linux man page)
The complex sine function is defined as: csin(z) = (exp(i * z) - exp(-i * z)) / (2 * i) VERSIONS These functions first appeared in glibc in version 2.1. CONFORM

resgen(1) - Mono/CLI Resource Generator - Linux manual page
Convert a resource file from one format to another. The currently supported formats are text, resources, resx and po. .txt, .text Used to process text files, th

growisofs(1) - combined mkisofs frontend/DVD recording progr
growisofs was originally designed as a frontend to mkisofs to facilitate appending of data to ISO9660 volumes residing on random-access media such as DVD+RW, DV

irqbalance(1) - distribute hardware interrupts across proces
The purpose of irqbalance is distribute hardware interrupts across processors on a multiprocessor system in order to increase performance. OPTIONS -o, --oneshot

glIndexdv(3gl) - set the current color index (Man Page).....
glIndex updates the current (single-valued) color index. It takes one argument, the new value for the current color index. The current index is stored as a floa

_Exit(2) - terminate the calling process - Linux man page...
The function _exit() terminates the calling process immediately. Any open file descriptors belonging to the process are closed; any children of the process are

Net::Server::Proto::SSLEAY(3pm) - Custom Net::Server SSL pro
This module is relatively new and has only served a couple of months in production environments. If anybody has any successes or ideas for improvment under SSLE

Tcl_SetListObj(3) - manipulate Tcl objects as lists.........
Tcl list objects have an internal representation that supports the efficient indexing and appending. The procedures described in this man page are used to creat

sane-dc25(5) - SANE backend for Kodak DC20/DC25 Digital Came
The sane-dc25 library implements a SANE (Scanner Access Now Easy) backend that provides access to Kodak DC20 and DC25 cameras. At present, only the DC25 has bee

libstorage(3) - InterNetNews Storage API library routines...
Libstorage is a library of common utility (the storage manager) routines for accessing Usenet articles and related data independent of particular storage method

cacoshf(3) - complex arc hyperbolic cosine - Linux man page
The cacosh() function calculates the complex arc hyperbolic cosine of z. If y = cacosh(z), then z = ccosh(y). The imaginary part of y is chosen in the interval

siga(1) System Information GAthering - Linux manual page....
This is siga, System Information GAthering. It collects various information on your system and outputs it in HTML or ASCII format. Since it needs root permissio

We can't live, work or learn in freedom unless the software we use is free.