XmTransferSetParameters(library call)

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

XmTransferSetParameters(library call)