Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XtDisownSelection()					   XtDisownSelection()

Name
  XtDisownSelection  -	indicate  that selection data is no longer avail‐
  able.

Synopsis
  void XtDisownSelection(w, selection, time)
	 Widget w;
	 Atom selection;
	 Time time;

Inputs
  w	    Specifies the widget relinquishing selection ownership.

  selection Specifies which selection the widget is  giving  up	 (usually
	    XA_PRIMARY or XA_SECONDARY).

  time	    Specifies  the  timestamp  that indicates when the request to
	    relinquish selection ownership was initiated.

Description
  XtDisownSelection() informs the Intrinsics selection mechanism that the
  specified  widget is to lose ownership of the specified selection as of
  the specified time.  If the widget does not currently	 own  the  selec‐
  tion,	 either because it lost the selection or because it never had the
  selection to begin with, XtDisownSelection() does nothing.

  After a widget has called XtDisownSelection(), its XtConvertProc is not
  called  even	if  a  request	arrives later with a timestamp during the
  period that this widget owned the selection.	However,  its  XtDoneProc
  will	be  called if a conversion that started before the call to XtDis‐
  ownSelection() finishes after the  call  to  XtDisownSelection().   See
  XtOwnSelection() for more information.

Usage
  Usually,  a selection owner maintains ownership indefinitely until some
  other client requests ownership, at which time the Intrinsics selection
  mechanism  informs the previous owner that it has lost ownership of the
  selection.  However, in response to some  user  actions  (for	 example,
  when a user deletes the information selected), the application may with
  to explicitly inform the Intrinsics that it no  longer  is  to  be  the
  selection owner by calling XtDisownSelection().

  When	the selection changes hands because another client has claimed it
  (rather than as a result of a call to XtDisownSelection()), the Intrin‐
  sics inform the application that it has lost the selection ownership by
  calling its XtLoseSelectionProc.

See Also
  XtGetSelectionValue(1), XtOwnSelection(1),
  XtConvertProc(2), XtDoneProc(2), XtLoseSelectionProc(2).

Xt - Selections						   XtDisownSelection()

Vote for polarhome