Name
XtDisownSelection — indicate that selection data is no longer available.
Synopsis
void XtDisownSelection(w, selection, time)
Widget w;
Atom selection;
Time time;
Arguments
wSpecifies the widget relinquishing selection ownership.
selectionSpecifies which selection the widget is giving up (XA_PRIMARY or XA_SECONDARY).
timeSpecifies the timestamp that indicates when the selection is relinquished.
Description
Usually the Intrinsics selection mechanism informs an application when one of its widgets has lost ownership of the selection. However, in response to some user actions (for example, when a user deletes the information selected), the application should use XtDisownSelection to inform the Intrinsics explicitly that its widget no longer should be the selection owner.
XtDisownSelection renounces ownership of a selection. It informs the Intrinsics that new requests for selection data should be directed elsewhere. No subsequent requests will be sent to the XtConvertProc registered when the widget called XtOwnSelection.
If the widget does not currently own 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 with a timestamp indicating the period that it owned the selection. However, its XtDoneProc will be called if a conversion that started before the call to XtDisownSelection finishes after the call to XtDisownSelection.
If the selection has changed hands because another client has claimed it (rather than as a result of a call to XtDisownSelection), the Intrinsics inform the application of the loss by calling its XtLoseSelectionProc.
An example widget that sends and receives data using selection is presented in Chapter 10, Interclient Communications, in Volume Four, X Toolkit Intrinsics Programming Manual.
See Also
XtGetSelectionValue(1), XtOwnSelection(1),
XtConvertProc(2), XtDoneProc(2), XtLoseSelectionProc(2).