NAME¶
XmDropTransferStart — A Drag and Drop function that initiates a
drop transfer "XmDropTransferStart" "Drag and Drop
functions" "XmDropTransferStart"
SYNOPSIS¶
#include <Xm/DragDrop.h>
Widget XmDropTransferStart(
Widget widget,
ArgList arglist,
Cardinal argcount);
DESCRIPTION¶
XmDropTransferStart initiates a drop transfer and uses the specified
argument list to initialize an
XmDropTransfer object. The DropTransfer
object can be manipulated with
XtSetValues and
XtGetValues until
the last call to the
XmNtransferProc procedure is made. After that
point, the result of using the widget pointer is undefined. The DropTransfer
object is freed by the toolkit when a transfer is complete.
- widget
- Specifies the ID of the DragContext widget associated with the
transaction
- arglist
- Specifies the argument list
- argcount
- Specifies the number of attribute/value pairs in the argument list (
arglist)
For a complete definition of DropTransfer and its associated resources, see
XmDropTransfer(3).
RETURN¶
Returns the ID of the DropTransfer widget.
XmDragContext(3),
XmDropTransfer(3), and
XmDropTransferAdd(3).