Museum

 XmDropTransferStart(Xm)        6 January 1993        XmDropTransferStart(Xm)


 Name

    XmDropTransferStart - a Drag and Drop function that initiates a drop
    transfer

 Syntax


    #include <Xm/DragDrop.h>

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


 Description

    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.

    refwidget
            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(Xm).

 Return value

    Returns the ID of the DropTransfer widget.

 See also

    XmDragContext(Xm), XmDropTransfer(Xm) and XmDropTransferAdd(Xm).