XmeDropSink(3X) UNIX System V XmeDropSink(3X)
NAME
XmeDropSink - A toolkit function that establishes a widget
as a drop site
SYNOPSIS
#include <Xm/TransferP.h>
void XmeDropSink(
Widget widget,
ArgList args,
Cardinal argcount);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmeDropSink establishes a widget as a drop site for drag and
drop operations. This routine calls XmDropSiteRegister with
the widget specified in widget and the arguments specified
in args. It overrides any setting of XmNdropProc in args.
This routine sets the DropSite's XmNdropProc to a function
that initializes an XmDestinationCallbackStruct as follows:
⊕ Sets the selection member to MOTIFDROP.
⊕ Sets the operation member to the following value:
⊕ XmCOPY, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROPCOPY and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROPHELP.
⊕ XmMOVE, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROPMOVE and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROPHELP.
⊕ XmLINK, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROPLINK and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROPHELP.
⊕ XmOTHER, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROPNOOP or if the dropAction
member of the XmDropProcCallbackStruct is
XmDROPHELP.
⊕ Sets the destination_data member to a pointer to the
Page 1 (printed 1/22/99)
XmeDropSink(3X) UNIX System V XmeDropSink(3X)
XmDropProcCallbackStruct passed to the XmNdropProc.
⊕ Sets the time member to the timeStamp member of the
XmDropProcCallbackStruct passed to the XmNdropProc.
XmeDropSink makes the following sequence of calls:
1. Calls the destination widget's
destinationPreHookProctrait method, if any;
destinationPreHookProcis one of the trait methods of
the XmQTtransfer trait. XmeDropSink passes the
initialized XmDestinationCallbackStruct as the
call_data argument.
2. Calls any XmNdestinationCallback procedures that the
application has attached to the destination widget.
3. Calls the destination widget's destinationProctrait
method, if any, after all transfers initiated by
XmNdestinationCallbackprocedures have finished.
However, if an XmNdestinationCallback procedure has
called XmTransferDone with a status of
XmTRANSFERDONEDEFAULT, XmePrimarySink does not call
the destinationProctrait method.
widget Specifies the widget that is the drop site.
args Specifies arguments to be passed to
XmDropSiteRegister.
arg_count Specifies the number of arguments in args.
RELATED
XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3),
XmeClipboardSink(3), XmeClipboardSource(3),
XmeConvertMerge(3), XmeDragSource(3), XmeGetEncodingAtom(3),
XmePrimarySink(3), XmePrimarySource(3), XmeSecondarySink(3),
XmeSecondarySource(3), XmeSecondaryTransfer(3),
XmeStandardConvert(3), XmeStandardTargets(3), and
XmeTransferAddDoneProc(3).
Page 2 (printed 1/22/99)