Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for xmtransferdone (centos section 3)

XmTransferDone(library call)					     XmTransferDone(library call)

NAME
       XmTransferDone -- A toolkit function that completes a data transfer

SYNOPSIS
       #include <Xm/Xm.h>

       void XmTransferDone(
       XtPointer transfer_id,
       XmTransferStatus status);

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.

       transfer_id
		 Specifies  a unique indentifier for the data transfer operation.  The value must
		 be the same as the value of the transfer_id member of the XmDestinationCallback-
		 Struct passed to the XmNdestinationCallback procedure.

       status	 Specifies  the completion status of the data transfer.  Following are the possi-
		 ble values:

		 XmTRANSFER_DONE_SUCCEED
			   The transfer was completed successfully.  This status has the  follow-
			   ing additional effects:

			      o  For  a move operation, the selection owner receives a request to
				 convert the selection to the DELETE target.

			      o  If a TRANSACT operation is in progress,  the  owner  receives	a
				 request to commit the transaction.

			      o  If  a	PERSIST  or _MOTIF_SNAPSHOT operation is in progress, the
				 owner receives a notification that the operation is finished.

			      o  The widget class destination procedure is not called.

		 XmTRANSFER_DONE_FAIL
			   The transfer was completed unsuccessfully.  This status has	the  fol-
			   lowing additional effects:

			      o  For  a  move  operation,  the selection owner does not receive a
				 request to convert the selection to the DELETE target.

			      o  For a drag and drop operation, the  DropTransfer's  XmNtransfer-
				 Status is set to XmTRANSFER_FAILURE.

			      o  If  a	TRANSACT  operation  is in progress, the owner receives a
				 request to abort the transaction.

			      o  If a PERSIST or _MOTIF_SNAPSHOT operation is  in  progress,  the
				 owner receives a notification that the operation is finished.

			      o  The widget class destination procedure is not called.

		 XmTRANSFER_DONE_CONTINUE
			   This  status  has  the  same effect as XmTRANSFER_DONE_SUCCEED, except
			   that if a PERSIST or _MOTIF_SNAPSHOT operation  is  in  progress,  the
			   owner does not receive a notification that the operation is finished.

		 XmTRANSFER_DONE_DEFAULT
			   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).

								     XmTransferDone(library call)


All times are GMT -4. The time now is 02:50 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password