XtCancelConvertSelectionProc()XtCancelConvertSelectionProc()NameXtCancelConvertSelectionProc - interface definition for procedure to
cancel incremental selection transfer.
Synopsis
typedef void (*XtCancelConvertSelectionProc)(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
Specifies an opaque identification for a specific request.
client_data
Specifies the value passed in by the widget when it took own‐
ership of the selection.
Availability
Release 4 and later.
Description
This procedure is registered in a call to XtOwnSelectionIncremental(),
and is called by the Intrinsics to abort an incremental transfer when
(as determined by the selection timeout or other mechanism) any remain‐
ing segments of the selection no longer need to be transferred. Upon
receiving this callback, the selection request is considered complete
and the owner should free the memory and any other resources that have
been allocated for the transfer.
The w, selection, and client_data arguments are those passed in the
call to XtOwnSelectionIncremental(). The target and request_id argu‐
ments are the selection target type specified by the selection
requestor, and the unique ID assigned to this transfer by the Intrin‐
sics. Both will have been passed to a previous call to the XtConvertS‐
electionIncrProc also registered with XtOwnSelectionIncremental().
See AlsoXtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1),
XtGetSelectionTimeout(1), XtOwnSelectionIncremental(1), XtSetSelection‐
Timeout(1),
XtConvertSelectionIncrProc(2), XtLoseSelectionIncrProc(2), XtSelection‐
DoneIncrProc(2).
Xt - Selections XtCancelConvertSelectionProc()