NAME

       XmTransferSetParameters  —  A toolkit function that establishes parameters to be passed by
       the  next  call   to   XmTransferValue   "XmTransferSetParameters"   "toolkit   functions"
       "XmTransferSetParameters"

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(3)