XmTransferDone(3X) UNIX System V XmTransferDone(3X)
NAME
XmTransferDone - A toolkit function that completes a data
transfer
SYNOPSIS
#include <Xm/Xm.h>
void XmTransferDone(
XtPointer transferid,
XmTransferStatus status);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmTransferDone completes an already-initiated data transfer
operation. An application can call this routine from an
XmNdestinationCallback procedure or any function called as a
result, including the selection procedures called as a
result of calls to XmTransferValue.
The caller of XmTransferDone supplies an identifier for the
transfer operation and an indication of the completion
status. XmTransferDone causes any remaining transfers for
the operation to be discarded.
transferid
Specifies a unique indentifier for the data
transfer operation. The value must be the same as
the value of the transferid member of the
XmDestinationCallbackStruct passed to the
XmNdestinationCallback procedure.
status Specifies the completion status of the data
transfer. Following are the possible values:
XmTRANSFERDONESUCCEED
The transfer was completed successfully.
This status has the following additional
effects:
⊕ For a move operation, the
selection owner receives a request
to convert the selection to the
DELETE target.
⊕ If a TRANSACT operation is in
progress, the owner receives a
request to commit the transaction.
⊕ If a PERSIST or MOTIFSNAPSHOT
operation is in progress, the
Page 1 (printed 1/22/99)
XmTransferDone(3X) UNIX System V XmTransferDone(3X)
owner receives a notification that
the operation is finished.
⊕ The widget class destination
procedure is not called.
XmTRANSFERDONEFAIL
The transfer was completed
unsuccessfully. This status has the
following additional effects:
⊕ For a move operation, the
selection owner does not receive a
request to convert the selection
to the DELETE target.
⊕ For a drag and drop operation, the
DropTransfer's XmNtransferStatus
is set to XmTRANSFERFAILURE.
⊕ If a TRANSACT operation is in
progress, the owner receives a
request to abort the transaction.
⊕ If a PERSIST or MOTIFSNAPSHOT
operation is in progress, the
owner receives a notification that
the operation is finished.
⊕ The widget class destination
procedure is not called.
XmTRANSFERDONECONTINUE
This status has the same effect as
XmTRANSFERDONESUCCEED, except that if
a PERSIST or MOTIFSNAPSHOT operation
is in progress, the owner does not
receive a notification that the
operation is finished.
XmTRANSFERDONEDEFAULT
The widget class destination procedure
is called. Further effects depend on
the actions of that procedure.
RELATED
XmTransferSendRequest(3), XmTransferStartRequest(3),
XmTransferStartRequest(3), and XmTransferValue(3).
Page 2 (printed 1/22/99)