Name

XtSelectionDoneProc — prototype procedure called after a data transfer completes. 

Synopsis

typedef void (∗XtSelectionDoneProc)(Widget, Atom ∗, Atom ∗);

    Widget w;
    Atom ∗selection;
    Atom ∗target;

Arguments

wSpecifies the widget that owns the converted selection. 

selectionSpecifies the atom that describes the selection type that was converted. 

targetSpecifies the target type to which the conversion was done. 

Description

The Intrinsics call the XtSelectionDoneProc registered in the call to XtOwnSelection when the data transfer is actually complete. 

If the selection owner has registered an XtSelectionDoneProc, the function will be called once for each conversion that it performs after the converted value has been successfully transferred to the requestor. 

If the selection owner has registered an XtSelectionDoneProc, the selection owner also owns the storage containing the converted selection value.  XtSelectionDoneProc can be used by the selection owner to deallocate memory allocated in XtConvertSelectionProc, XtGetSelectionValueIncremental, and XtOwnSelectionIncremental. 

Chapter 10, Interclient Communications, in Volume Four, X Toolkit Intrinsics Programming Manual, presents a complete example widget that both sends and receives data using selections. 

See Also

XtDisownSelection(1), XtGetSelectionValue(1), XtGetSelectionValues(1), XtOwnSelection(1),
XtConvertSelectionProc(2).