XmTransferSetParameters(library call) XmTransferSetParameters(library call)
NAME [Toc] [Back]
XmTransferSetParameters - A toolkit function that establishes
parameters to be passed by the next call to XmTransferValue
SYNOPSIS [Toc] [Back]
#include <Xm/Transfer.h>
void XmTransferSetParameters(
XtPointer transfer_id,
XtPointer parm,
int parm_fmt,
unsigned long parm_length,
Atom parm_type);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
XmTransferSendRequest(3), XmTransferStartRequest(3), and
XmTransferValue(3).
- 1 - Formatted: January 24, 2005 [ Back ] |