NAME

XtDisownSelection − indicate that selection data is no longer available. 

Synopsis

void XtDisownSelection(w, selection, time)

    Widget w;
    Atom selection;
    Time time;

Inputs

wSpecifies the widget relinquishing selection ownership. 

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

timeSpecifies 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 XtDisownSelection() 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 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). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates