XmTransferSetParameters - Man Page

A toolkit function that establishes parameters to be passed by the next call to XmTransferValue

Synopsis

#include <Xm/Transfer​.h>

void XmTransferSetParameters(
XtPointer transfer_id,
XtPointer parm,
int parm_fmt,
unsigned long parm_length,
Atom parm_type);

Description

XmTransferSetParameters establishes a parameter definition​. Your application calls XmTransferSetParameters just before calling XmTransferValue, and only if XmTransferValue needs to transfer a value containing a parameter​.

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​.

parm

Specifies parameters to be passed to the conversion routine (and the XmNconvertCallback procedures, if any) of the widget that owns the selection​. The type and length of parameters are target-specific​. If the target takes no parameters, the value is NULL​.

parm_fmt

Specifies whether the data in parm should be viewed as a list of 8-bit, 16-bit, or 32-bit quantities​. Possible values are 0 (when parm is NULL), 8, 16, and 32​.

parm_length

Specifies the number of elements of data in parm, where each element has the number of bits specified by parm_fmt​. When parm is NULL, the value is 0​.

parm_type

Specifies the type of parm​.