Museum

 XmDragStart(Xm)                6 January 1993                XmDragStart(Xm)


 Name

    XmDragStart - a Drag and Drop function that initiates a drag and drop
    transaction

 Syntax


    #include <Xm/DragDrop.h>

    Widget XmDragStart (widget, event, arglist, argcount)
    Widget widget;
    XEvent *event;
    ArgList arglist;
    Cardinal argcount;


 Description

    XmDragStart initiates a drag operation. This routine returns the DragCon-
    text widget that it initializes for the associated drag transaction. The
    toolkit is responsible for freeing the DragContext when the drag and drop
    transaction is complete.

    widget  Specifies the ID of the smallest widget and/or gadget that
            encloses the source elements selected for a drag operation.

    event   Specifies the XEvent that triggered the drag operation. This
            event must be a ButtonPress event.

    arglist Specifies the argument list. Any XmDragContext resources not
            specified in the argument list are obtained from the resource
            database or are set to their default values.

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

    For a complete definition of DragContext and its associated resources,
    see XmDragContext(Xm).

 Return value

    Returns the ID of the DragContext widget that controls this drag and drop
    transaction.

 See also

    XmDragCancel(Xm) and XmDragContext(Xm).