XmDragStart(library call)                         XmDragStart(library call)




 NAME    [Toc]    [Back]
      XmDragStart - A Drag and Drop function that initiates a drag and drop
      transaction

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

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      Returns the ID of the DragContext widget that controls this drag and
      drop transaction.  Returns NULL if the drag cannot be initiated.

 RELATED    [Toc]    [Back]
      XmDragCancel(3) and XmDragContext(3).


                                    - 1 -       Formatted:  January 24, 2005