NAME

       XmDragStart  —  A  Drag  and  Drop  function  that  initiates  a drag and drop transaction
       "XmDragStart" "Drag and Drop functions" "XmDragStart"

SYNOPSIS

       #include <Xm/DragDrop.h>
       Widget XmDragStart(
       Widget widget,
       XEvent *event,
       ArgList arglist,
       Cardinal argcount);

DESCRIPTION

       XmDragStart initiates a drag operation. This routine returns the DragContext  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(3).

RETURN

       Returns  the  ID  of  the DragContext widget that controls this drag and drop transaction.
       Returns NULL if the drag cannot be initiated.

RELATED

       XmDragCancel(3) and XmDragContext(3).

                                                                                   XmDragStart(3)