XmeTransferAddDoneProc()



     XmeTransferAddDoneProc(3X)UNIX System VXmeTransferAddDoneProc(3X)



     NAME
          XmeTransferAddDoneProc - A toolkit function that establishes
          a procedure to be called when data transfer is complete

     SYNOPSIS
          #include <Xm/TransferP.h>
          void XmeTransferAddDoneProc(
          XtPointer transferid,
          XmSelectionFinishedProc doneproc);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeTransferAddDoneProc establishes a procedure to be called
          by the toolkit when a data transfer operation is complete.
          This routine can be called from an
          XmNdestinationCallbackprocedure or from any function called
          as a result, including the following:

             ⊕  From the selection procedures called as a result of
                calls to XmTransferValue,

             ⊕  From a destinationProc trait method; destinationProc
                is one of the trait methods of the XmQTtransfer trait.

          If more than one such procedure has been established for a
          given transfer operation, all procedures are called when the
          transfer operation is complete.

          The done_proc argument holds a function of type
          XmSelectionFinishedProc, which has the following definition:

          void (* XmSelectionFinishedProc)(
          Widget widget,
          XtEnum operation,
          XmTransferDoneCallbackStruct *calldata);

          widget    Specifies the widget that requested the
                    conversion.

          operation Specifies the transfer operation.  Possible values
                    are XmMOVE, XmCOPY, XmLINK, and XmOTHER.

          call_data Specifies a pointer to an
                    XmTransferDoneCallbackStruct structure containing
                    information about the status of the transfer.

          XmTransferDoneCallbackStruct is defined as follows:

          typedef struct {
                  int     reason;



     Page 1                                          (printed 1/22/99)



     XmeTransferAddDoneProc(3X)UNIX System VXmeTransferAddDoneProc(3X)



                  XEvent  *event;
                  Atom    selection;
                  XtPointer       transfer_id;
                  XmTransferStatus        status;
                  XtPointer       client_data;
          } XmTransferDoneCallbackStruct;

          reason    Indicates why the callback was invoked.

          event     Points to the XEvent that triggered the callback.
                    It can be NULL.

          selection Indicates the selection being converted.

          transfer_id
                    Specifies a unique indentifier for the data
                    transfer operation.

          status    Indicates whether or not the transfer completed
                    successfully.  Following are the possible values:

                    XmTRANSFERDONESUCCEED
                              The transfer completed successfully.

                    XmTRANSFERDONEFAIL
                              The transfer did not complete
                              successfully.

          client_data
                    Specifies data to be passed to the callback
                    procedure.

          The XmeTransferAddDoneProc routine takes the following
          arguments:

          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
                    XmDestinationCallbackStruct passed to the
                    XmNdestinationCallback procedure or the
                    destinationProcXmQTtransfer trait method.

          done_proc Specifies a procedure to be called when the data
                    transfer is complete.  The procedure is of type
                    XmSelectionFinishedProc.

     RELATED
          XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3),
          XmeClipboardSink(3), XmeClipboardSource(3),
          XmeConvertMerge(3), XmeDragSource(3), XmeDropSink(3),
          XmeGetEncodingAtom(3), XmePrimarySink(3),



     Page 2                                          (printed 1/22/99)



     XmeTransferAddDoneProc(3X)UNIX System VXmeTransferAddDoneProc(3X)



          XmePrimarySource(3), XmeSecondarySink(3),
          XmeSecondarySource(3), XmeSecondaryTransfer(3),
          XmeStandardConvert(3), and XmeStandardTargets(3).




















































     Page 3                                          (printed 1/22/99)

Museum