XmDropTransferStart(library call)         XmDropTransferStart(library call)




 NAME    [Toc]    [Back]
      XmDropTransferStart - A Drag and Drop function that initiates a drop
      transfer

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/DragDrop.h>
      Widget XmDropTransferStart(
      Widget widget,
      ArgList arglist,
      Cardinal argcount);

 DESCRIPTION    [Toc]    [Back]
      XmDropTransferStart initiates a drop transfer and uses the specified
      argument 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 using the widget pointer is
      undefined. The DropTransfer object is freed by the toolkit when a
      transfer is complete.

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

      arglist   Specifies 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(3).

 RETURN    [Toc]    [Back]
      Returns the ID of the DropTransfer widget.

 RELATED    [Toc]    [Back]
      XmDragContext(3), XmDropTransfer(3), and XmDropTransferAdd(3).


                                    - 1 -       Formatted:  January 24, 2005