Museum

 XmGetDragContext(Xm)           6 January 1993           XmGetDragContext(Xm)


 Name

    XmGetDragContext - a Drag and Drop function that retrieves the
    DragContext widget ID associated with a timestamp

 Syntax


    #include <Xm/DragC.h>

    Widget XmGetDragContext (refwidget, timestamp)
    Widget  refwidget;
    Time  timestamp;


 Description

    XmGetDragContext returns the widget ID of the active DragContext associ-
    ated with a given display and timestamp. A timestamp uniquely identifies
    which DragContext is active when more than one drag and drop transaction
    has been initiated on a display. If the specified timestamp matches a
    timestamp processed between the start and finish of a single drag and
    drop transaction, the function returns the corresponding DragContext ID.

    refwidget
            Specifies the ID of the widget that the routine uses to identify
            the intended display. The function returns the ID of the DragCon-
            text associated with the display value passed by this widget.

    timestamp
            Specifies a timestamp.

    For a complete definition of DragContext and its associated resources,
    see XmDragContext(Xm).

 Return value

    Returns the ID of the DragContext widget that is active for the specified
    timestamp. Otherwise, returns NULL if no active DragContext is found.

 See also

    XmDragContext(Xm)