XmeConvertMerge(3X)

     NAME
          XmeConvertMerge - A toolkit function that merges data
          converted during a transfer operation

     SYNOPSIS
          #include <Xm/Xm.h>
          void XmeConvertMerge(
          XtPointer data,
          Atom type,
          int format,
          unsigned long length,
          XmConvertCallbackStruct *call_data);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeConvertMerge merges data converted in the course of a
          transfer operation.  The data to be merged is typically two
          list of targets.  An XmNconvertCallback procedure in an
          application may supply some elements of the list, and the
          convertProc trait method of a widget may supply others.
          Therefore, the convertProc trait method will need to call
          XmeConvertMerge to merge the two target lists.

          XmeConvertMerge can only be called from an
          XmNconvertCallback procedure or from a convertProc trait
          method.

          A convertProc trait method usually calls XmeConvertMergewhen
          an XmNconvertCallback procedure returns an
          XmConvertCallbackStruct structure containing a status of
          XmCONVERT_MERGE.

          XmeConvertMerge uses XtRealloc to increase the allocated
          storage for the value member of the
          XmConvertCallbackStructpassed in the call_data argument.  It
          then appends data to the data already present in the value
          member.  The type and format passed as arguments to
          XmeConvertMergemust match the type and format fields passed
          in the XmConvertCallbackStruct.

          data      Specifies the data to be added to the value member
                    of the callback struct.

          type      Indicates the type of data.

          format    Specifies how the call should interpret data.  You
                    must specify 8, 16, or 32. A value of 8 implies
                    that datais an array of char. A value of 16
                    implies that data is an array of short. A value of
                    32 implies that data is an array of long. It is
                    possible that the specified number may not match
                    the actual number of bits passed in data. For
                    example, a value of 32 may actually correspond to
                    a 64-bit data structure on some machines.

          length    Specifies the number of elements in data, where
                    each element has the number of bits specified by
                    format.

          call_data Specifies a pointer to the XmConvertCallbackStruct
                    that is to be modified.

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