Museum

     XmeNamedSource(3X)        UNIX System V        XmeNamedSource(3X)



     NAME
          XmeNamedSource - A toolkit function that takes ownership of
          a named selection

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeNamedSource takes ownership of the specified selection.

          This routine establishes a function that is called when the
          widget is asked to convert the selection named
          named_selection.  That function makes the following sequence
          of calls:

             1. Calls the application's XmNconvertCallback procedures,
                if any.  XmeNamedSource passes an
                XmConvertCallbackStruct(with the selection member set
                to named_selection) to each of these
                XmNconvertCallback procedures.

             2. Calls the source widget's convertProc trait method;
                convertProc is one of the trait methods of the
                XmQTtransfertrait. However, if any XmNconvertCallback
                procedure returns XmCONVERTDONE or XmCONVERTREFUSE,
                then XmeNamedSource will not call convertProc.

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

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

                   ⊕  Sets the selection member to the named_selection
                      argument

                   ⊕  Sets the target member to MOTIFLOSESELECTION

             2. Calls the source widget's convertProc trait method.
                However, if any XmNconvertCallback procedure returns
                XmCONVERTDONE or XmCONVERTREFUSE, then



     Page 1                                          (printed 1/22/99)

     XmeNamedSource(3X)        UNIX System V        XmeNamedSource(3X)



                XmeNamedSource will not call convertProc.

          widget    Specifies the widget that is to take ownership of
                    the selection.

          named_selection
                    Specifies the Atom that names the selection to
                    own.

          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 specified 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), XmeNamedSink(3),
          XmeSecondarySink(3), XmeSecondarySource(3),
          XmeSecondaryTransfer(3), XmeStandardConvert(3),
          XmeStandardTargets(3), and XmeTransferAddDoneProc(3).

























     Page 2                                          (printed 1/22/99)