noble (3) XmTransferSetParameters.3.gz

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)