XmDragStart(3X)

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

SYNOPSIS
     #include <Xm/DragDrop.h>

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


VERSION
     This page documents version 1.2 of the Motif library.

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.

     arglistSpecifies the argument list.  Any XmDragContext resources not speci-
            fied 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(3X).

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

RELATED INFORMATION
     XmDragCancel(3X) and XmDragContext(3X).

                                                                 XmDragStart(3X)