XmTransferSetParameters(3X)

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

Showing IRIX 6.5.30 (default release). Added in IRIX 6.5.5.

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

     VERSION
          This page documents Motif 2.1.

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