XtLoseSelectionProc()XtLoseSelectionProc()Name
XtLoseSelectionProc - interface definition for procedure to notify the
selection owner it has lost selection ownership.
Synopsis
typedef void (*XtLoseSelectionProc)(Widget, Atom *);
Widget w;
Atom *selection;
Inputs
w Specifies the widget that has lost selection ownership.
selection Specifies the atom that names the selection.
Description
An XtLoseSelectionProc is optionally registered in a call to XtOwnSe‐
lection() and is called by the Intrinsics when the widget it was regis‐
tered with loses the selection because another widget or client has
claimed the selection. It is not called when the selection owner
relinquishes selection ownership with XtDisownSelection(). This proce‐
dure should take whatever action is appropriate for the widget or
application when it loses selection ownership.
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 (widgets or applications) will want to display
selected data highlighted in some way, and so will need to be informed
when they lose the selection so that they can unhighlight that data.
An XtLoseSelectionIncrProc is a similar procedure type used by the
Intrinsics incremental selection transfer mechanism. It takes an addi‐
tional client_data argument.
Example
The XtLoseSelectionProc below is from the xcalc client. It simply
unhighlights the value currently shown in the calculator display.
/*
* called when xcalc loses ownership of the selection.
*/
/*ARGSUSED*/
void lose(w, selection)
Widget w;
Atom *selection;
{
XawToggleUnsetCurrent(LCD);
}
See AlsoXtDisownSelection(1), XtGetSelectionValue(1), XtGetSelectionValueIncre‐
mental(1), XtOwnSelection(1),
XtLoseSelectionIncrProc(2).
Xt - Selections XtLoseSelectionProc()