XmeConvertMerge

A toolkit function that merges data converted during a transfer operation

Format

#include <Xm/Xm.h>
void XmeConvertMergeXtPointer
dataAtom typeint
formatunsigned long
lengthXmConvertCallbackStruct
*call_data

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 XmeConvertMerge when 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 XmConvertCallbackStruct passed 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 XmeConvertMerge must match the type and format fields passed in the XmConvertCallbackStruct.