NAME

XtCancelConvertSelectionProc − 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

wSpecifies the widget that owns the selection. 

selectionSpecifies the atom that names the selection being transferred. 

targetSpecifies 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 ownership 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 remaining 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 arguments are the selection target type specified by the selection requestor, and the unique ID assigned to this transfer by the Intrinsics.  Both will have been passed to a previous call to the XtConvertSelectionIncrProc also registered with XtOwnSelectionIncremental(). 

See Also

XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1), XtGetSelectionTimeout(1), XtOwnSelectionIncremental(1), XtSetSelectionTimeout(1),
XtConvertSelectionIncrProc(2), XtLoseSelectionIncrProc(2), XtSelectionDoneIncrProc(2). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates