NAME

XmTransferSetParameters — 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.

RELATED

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