XmGetDragContext(3X) UNIX System V XmGetDragContext(3X)
NAME
XmGetDragContext - A Drag and Drop function that retrieves
the DragContext widget ID associated with a timestamp
SYNOPSIS
#include <Xm/DragC.h>
Widget XmGetDragContext (refwidget, timestamp)
Widget refwidget;
Time timestamp;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
XmGetDragContext returns the widget ID of the active
DragContext associated 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 DragContext 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(3X).
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.
RELATED INFORMATION
XmDragContext(3X).
Page 1 (printed 4/30/98)