XmeSecondarySink(3X)

     NAME
          XmeSecondarySink - A toolkit function that establishes a
          widget as the destination for secondary transfer

     SYNOPSIS
          #include <Xm/TransferP.h>
          Boolean XmeSecondarySink(
          Widget widget,
          Time time);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeSecondarySink establishes a widget as the destination for
          secondary transfer operations.  When the VendorShell
          XmNkeyboardFocusPolicy is XmEXPLICIT, the destination is the
          editable component that last had focus.  When the
          VendorShell XmNkeyboardFocusPolicy is XmPOINTER, the
          destination is the editable component that last received
          mouse button or keyboard input.

          XmeSecondarySink establishes a widget as the destination by
          taking ownership of the _MOTIF_DESTINATION selection.

          XmeSecondarySink also establishes a function that is called
          when the widget loses the selection.  That function makes
          the following sequence of calls:

             1. Calls the widget's XmNconvertCallback procedures, if
                any.  XmeSecondarySink passes an
                XmConvertCallbackStructto each of these
                XmNconvertCallback procedures.  XmeSecondarySink
                initializes the XmConvertCallbackStructas follows:

                   o  Sets the selection member to _MOTIF_DESTINATION

                   o  Sets the target member to _MOTIF_LOSE_SELECTION

             2. Calls the source widget's convertProc trait method.
                However, if any XmNconvertCallback procedure returns
                XmCONVERT_DONE or XmCONVERT_REFUSE, then
                XmePrimarySource will not call convertProc.

          widget    Specifies the widget that is to be the
                    destination.

          time      Specifies the time of the transfer.  This is
                    usually the timestamp from the event passed to an
                    action routine.  You should call
                    XtLastTimeStampProcessed to generate the
                    timevalue.  If you set time to CurrentTime or 0,
                    UTM will automatically change the call to
                    XtLastTimeStampProcessed.

     RETURN
          This function returns False if the widget cannot take
          ownership of the _MOTIF_DESTINATION selection.  Otherwise,
          it returns True.

     RELATED
          XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3),
          XmeClipboardSink(3), XmeClipboardSource(3),
          XmeConvertMerge(3), XmeDragSource(3), XmeDropSink(3),
          XmeGetEncodingAtom(3), XmePrimarySink(3),
          XmePrimarySource(3), XmeSecondarySource(3),
          XmeSecondaryTransfer(3), XmeStandardConvert(3),
          XmeStandardTargets(3), and XmeTransferAddDoneProc(3).