A toolkit function that transfers data from the secondary selection to the destination widget
#include <Xm/TransferP.h> void XmeSecondaryTransferWidget widgetAtom targetXtEnum opTime time
XmeSecondaryTransfer transfers the data from the secondary selection to the destination widget. A widget usually calls this function from an action routine that ends a secondary selection. The destination widget is the owner of the _MOTIF_DESTINATION selection.
If the destination widget has used XmeSecondarySink to take ownership of that selection, XmeSecondaryTransfer initializes an XmDestinationCallbackStruct as follows:
XmeSecondaryTransfer makes the following sequence of calls:
It is the responsibility of the destination widget's XmNdestinationCallback procedures and the destinationProc trait method to transfer any data to the widget.
If op is XmMOVE and the data is successfully transferred, XmeSecondaryTransfer asks the owner of the SECONDARY selection to convert that selection to the DELETE target. In all cases, when the transfer operation is complete, XmeSecondaryTransfer asks the owner of the SECONDARY selection to convert that selection to the _MOTIF_LOSE_SELECTION target.
If the selection owner has called XmeSecondarySource to take ownership of the selection, these conversion requests first call the owner's XmNconvertCallback procedures, if any. If no XmNconvertCallback procedures exist or if these procedures return a status of XmCONVERT_DEFAULT or XmCONVERT_MERGE, these requests then call the owner's convertProc trait method; convertProc is a trait method of the XmQTtransfer trait.
XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3), XmeClipboardSink(3), XmeClipboardSource(3), XmeConvertMerge(3), XmeDragSource(3), XmeDropSink(3), XmeGetEncodingAtom(3), XmePrimarySink(3), XmePrimarySource(3), XmeSecondarySink(3), XmeSecondarySource(3), XmeStandardConvert(3), XmeStandardTargets(3), and XmeTransferAddDoneProc(3).