Scroll to navigation

XmTransferSetParameters(library call) 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.

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.
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.
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.
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.
Specifies the type of parm.

RELATED

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