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 XtOwnSelection() 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 procedure 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 Also
XtDisownSelection(1), XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtOwnSelection(1),
XtLoseSelectionIncrProc(2).
Xt - Selections XtLoseSelectionProc()