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)