hpux man page for xtloseselea

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()