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