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 own‐
ership 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 wid‐
get 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 selec‐
tion transfer mechanism. An XtLoseSelectionProc is a similar procedure
used by the more convenient atomic transfer mechanism. An XtLoseSelec‐
tionProc does not have a client_data argument.
See AlsoXtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1),
XtOwnSelectionIncremental(1),
XtCancelConvertSelectionProc(2), XtConvertSelectionIncrProc(2), XtLos‐
eSelectionProc(2), XtSelectionDoneIncrProc(2).
Xt - Selections XtLoseSelectionIncrProc()