hpux man page for xtselectiob

XtSelectionDoneIncrProc()												 XtSelectionDoneIncrProc()

Name
  XtSelectionDoneIncrProc - interface definition for procedure called when an incremental selection transfer completes.

Synopsis
  typedef void (*XtSelectionDoneIncrProc)(Widget, Atom *, Atom *,
  XtRequestId *, XtPointer);
	 Widget w;
	 Atom *selection;
	 Atom *target;
	 XtRequestId *request_id;
	 XtPointer client_data;

Inputs
  w	    Specifies the widget that owns the selection.

  selection Specifies the atom that names the selection being transferred.

  target    Specifies the target type to which the conversion was done.

  request_id
	    Identifies the specific conversion request that completed.

  client_data
	    Specifies data registered with this procedure when the widget took ownership of the selection.

Availability
  Release 4 and later.

Description
  An  XtSelectionDoneIncrProc  is  optionally  registered in a call to XtOwnSelectionIncremental(), and is called by the Intrinsics after the
  requestor has retrieved the final (zero-length) segment of the incremental transfer to indicate that the entire transfer is complete.   The
  w,  selection,  and  client_data  arguments are those passed to XtOwnSelectionIncremental().	The target and request_id arguments are those
  that were passed to the XtConvertSelectionIncrProc registered with this procedure.

  An XtSelectionDoneIncrProc should free any memory that was allocated for the transfer of the selection value.  If no	procedure  is  speci-
  fied,  the Intrinsics will automatically free (using XtFree()) the last value returned by the XtConvertSelectionIncrProc.  If a single buf-
  fer is used to transfer all the chunks of the selection, this automatic freeing by the Intrinsics should be sufficient.  If  separate  buf-
  fers	are used or other memory or resources are allocated to transfer the selection value, an XtSelectionDoneIncrProc should be provided to
  free them.

Usage
  It is usually more convenient to use the Intrinsics atomic selection transfer mechanism which transfers the selection  value	in  a  single
  chunk.  See XtOwnSelection(1) and XtSelectionDoneProc for more information.

See Also
  XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1), XtOwnSelection(1), XtOwnSelectionIncremental(1),
  XtCancelConvertSelectionProc(2), XtConvertSelectionIncrProc(2), XtLoseSelectionIncrProc(2), XtSelectionDoneProc(2).

Xt - Selections 													 XtSelectionDoneIncrProc()