XmDragStart(3X)

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

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

     VERSION
          This page documents Motif 2.1.

     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).