[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference

XmTransferSetParameters

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

Format

#include
<Xm/Transfer.h>
void XmTransferSetParameters
XtPointer
transfer_idXtPointer parmint
parm_fmtunsigned long
parm_lengthAtom 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.

RELATED

XmTransferSendRequest (3), XmTransferStartRequest (3), and XmTransferValue (3).

[ Previous | Next | Contents | Glossary | Home | Search ]