Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XSetSelectionOwner(3)		XLIB FUNCTIONS		 XSetSelectionOwner(3)

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

       display	 Specifies the connection to the X server.

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

       property	 Specifies the property	name.  You also	can pass None.

       requestor Specifies the requestor.

       selection Specifies the selection atom.

       target	 Specifies the target atom.

       time	 Specifies  the	time.  You can pass either a timestamp or Cur-

       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).	Other-
       wise,  the  owner of the	selection becomes the client executing the re-

       If the new owner	(whether a client or None) is not the same as the cur-
       rent owner of the selection and the current owner is not	None, the cur-
       rent 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	 unin-
       terpreted  by  the X server.  XGetSelectionOwner	returns	the owner win-
       dow, 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	selec-
       tion 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:

       o    If	the specified selection	has an owner, the X server sends a Se-
	    lectionRequest event to that owner.

       o    If no owner	for the	specified selection exists, the	X server  gen-
	    erates  a  SelectionNotify	event  to  the requestor with property

       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.

       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.

       Xlib - C	Language X Interface

X Version 11			 libX11	1.7.2		 XSetSelectionOwner(3)


Want to link to this manual page? Use this URL:

home | help