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 trans‐
ferred.
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 incre‐
mental transfer to indicate that the entire transfer is complete. The
w, selection, and client_data arguments are those passed to XtOwnSelec‐
tionIncremental(). The target and request_id arguments are those that
were passed to the XtConvertSelectionIncrProc registered with this pro‐
cedure.
An XtSelectionDoneIncrProc should free any memory that was allocated
for the transfer of the selection value. If no procedure is specified,
the Intrinsics will automatically free (using XtFree()) the last value
returned by the XtConvertSelectionIncrProc. If a single buffer is used
to transfer all the chunks of the selection, this automatic freeing by
the Intrinsics should be sufficient. If separate buffers 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 informa‐
tion.
See AlsoXtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1),
XtOwnSelection(1), XtOwnSelectionIncremental(1),
XtCancelConvertSelectionProc(2), XtConvertSelectionIncrProc(2), XtLos‐
eSelectionIncrProc(2), XtSelectionDoneProc(2).
Xt - Selections XtSelectionDoneIncrProc()