DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmGetDragContext(Xm)


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 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(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)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003