XConvertSelection man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



XSetSelectionOwner(3X11)  XLIB FUNCTIONS XSetSelectionOwner(3X11)

NAME
       XSetSelectionOwner, XGetSelectionOwner, XConvertSelection
       - manipulate window selection

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

       Window XGetSelectionOwner(display, selection)
	     Display *display;
	     Atom selection;

       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.

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

DESCRIPTION
       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

X Version 11		Release 6.4				1

XSetSelectionOwner(3X11)  XLIB FUNCTIONS XSetSelectionOwner(3X11)

       same as the current owner of the selection and the current
       owner is not None, the current owner is sent a Selection-
       Clear event.  If the client that is the owner of a selec-
       tion 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 speci-
       fied selection.	If no selection was specified, the func-
       tion 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 SelectionRequest event to that owner.

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

SEE ALSO
       Xlib - C Language X Interface

X Version 11		Release 6.4				2

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net