DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmDragStart(Xm)


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

Syntax

#include <Xm/DragDrop.h>

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

Description

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(Xm).

Return value

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

See also

XmDragCancel(Xm) and XmDragContext(Xm).


© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003