XtLoseSelectionIncrProc() XtLoseSelectionIncrProc()
Name
XtLoseSelectionIncrProc - interface definition for a procedure called when the selection owner loses ownership.
Synopsis
typedef void (*XtLoseSelectionIncrProc)(Widget, Atom*, XtPointer);
Widget w;
Atom *selection;
XtPointer client_data;
Inputs
w Specifies the widget that has lost the selection ownership.
selection Specifies the atom that names the selection.
client_data
Specifies the value passed in by the widget when it took ownership of the selection.
Availability
Release 4 and later.
Description
An XtLoseSelectionIncrProc is optionally registered in a call to XtOwnSelectionIncremental(), and is called by the Intrinsics to inform the
selection owner that the selection has been claimed by another widget or another client. This procedure is not called if the selection
owner relinquishes selection ownership by calling XtDisownSelection(). It should do whatever is appropriate for the widget or application
upon losing the ownership of the selection.
Note that this procedure is not a request to the widget to relinquish selection ownership; it is called after the widget has already lost
the selection.
Usage
Most selection owners will want to display selected data specially highlighted, and so will need to be informed when they lose the selec-
tion so that they can unhighlight that data.
An XtLoseSelectionIncrProc is used in the Intrinsics incremental selection transfer mechanism. An XtLoseSelectionProc is a similar proce-
dure used by the more convenient atomic transfer mechanism. An XtLoseSelectionProc does not have a client_data argument.
See Also
XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1), XtOwnSelectionIncremental(1),
XtCancelConvertSelectionProc(2), XtConvertSelectionIncrProc(2), XtLoseSelectionProc(2), XtSelectionDoneIncrProc(2).
Xt - Selections XtLoseSelectionIncrProc()