hpux man page for xtdisownselection

XtDisownSelection()													       XtDisownSelection()

Name
  XtDisownSelection - indicate that selection data is no longer available.

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 selection, 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 selec-
  tion 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
  Intrinsics 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()