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 arg_count);

     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:

             o  Sets the selection member to _MOTIF_DROP.

             o  Sets the operation member to the following value:

                   o  XmCOPY, if the operation member of the
                      XmDropProcCallbackStruct passed to the
                      XmNdropProc is XmDROP_COPY and the dropAction
                      member of the XmDropProcCallbackStruct is not
                      XmDROP_HELP.

                   o  XmMOVE, if the operation member of the
                      XmDropProcCallbackStruct passed to the
                      XmNdropProc is XmDROP_MOVE and the dropAction
                      member of the XmDropProcCallbackStruct is not
                      XmDROP_HELP.

                   o  XmLINK, if the operation member of the
                      XmDropProcCallbackStruct passed to the
                      XmNdropProc is XmDROP_LINK and the dropAction
                      member of the XmDropProcCallbackStruct is not
                      XmDROP_HELP.

                   o  XmOTHER, if the operation member of the
                      XmDropProcCallbackStruct passed to the
                      XmNdropProc is XmDROP_NOOP or if the dropAction
                      member of the XmDropProcCallbackStruct is
                      XmDROP_HELP.

             o  Sets the destination_data member to a pointer to the
                XmDropProcCallbackStruct passed to the XmNdropProc.

             o  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
                XmTRANSFER_DONE_DEFAULT, 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).