XtDisownSelection()XtDisownSelection()NameXtDisownSelection - 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.
DescriptionXtDisownSelection() 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 AlsoXtGetSelectionValue(1), XtOwnSelection(1),
XtConvertProc(2), XtDoneProc(2), XtLoseSelectionProc(2).
Xt - Selections XtDisownSelection()