XmDropTransferStart(3X)

NAME
     XmDropTransferStart --A Drag and Drop function that initiates a drop trans-
     fer

SYNOPSIS
     #include <Xm/DragDrop.h>

     Widget XmDropTransferStart (widget, arglist, argcount)
          Widget      widget;
          ArgList     arglist;
          Cardinal    argcount;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmDropTransferStart  initiates a drop transfer and uses the specified argu-
     ment list to initialize an XmDropTransfer object.  The DropTransfer  object
     can  be manipulated with XtSetValues and XtGetValues until the last call to
     the XmNtransferProc procedure is made.  After that point, the result of us-
     ing the widget pointer is undefined.  The DropTransfer object is  freed  by
     the toolkit when a transfer is complete.


     refwidget
            Specifies  the  ID  of  the  DragContext  widget associated with the
            transaction

     arglistSpecifies the argument list

     argcount
            Specifies the number of attribute/value pairs in the  argument  list
            (arglist)


     For a complete definition of DropTransfer and its associated resources, see
     XmDropTransfer(3X).

RETURN VALUE
     Returns the ID of the DropTransfer widget.

RELATED INFORMATION
     XmDragContext(3X), XmDropTransfer(3X), and XmDropTransferAdd(3X).

                                                         XmDropTransferStart(3X)