XtSetSelectionParameXeVersion 11 (ReXtSetSelectionParameters(3Xt)
NAME
XtSetSelectionParameters - specify target parameters for a
selection request with a single target
SYNTAX
void XtSetSelectionParameters(requestor, selection, type,
value, length, format)
Widget requestor;
Atom selection;
Atom type;
XtPointer value;
unsigned long length;
int format;
ARGUMENTS
requestor Specifies the widget making the request. Must be
of clase Core or any subclass thereof.
selection Specifies the atom that names the selection.
type Specifies the type of the property in which the
parameters will be passed.
value Specifies a pointer to the parameters.
length Specifies the number of elements containing data
in value, each element of a sized indicated by
format.
format Specifies the size in bits of the data in the
elements of value.
DESCRIPTION
The specified parameters will be copied and stored in a new
property of the specified type and format on the requestor's
window. To initiate a selection request with a target and
these parameters, a subsequent call to XtGetSelectionValue
or to XtGetSelectionValueIncremental specifying the same
requestor widget and selection atomm will generate a
ConvertSelection request referring referring to the property
containing the parameters. If XtSetSelectionParameters is
called more than once with the same widget and selection
without a call to specify a request, the most recently
specified parameters are used in the subsequent request.
The possible values of format may be 8, 16, or 32. If the
format is 8, the elements of value are assumed to be
sizeof(char); if 16, sizeof(short); if 32, sizeof(long).
To generate a MULTIPLE target request with parameters for
any of the multiple targets of the selection request,
precede individual calls to XtGetSelectionValue and
Page 1 (printed 7/20/06)
XtSetSelectionParameXeVersion 11 (ReXtSetSelectionParameters(3Xt)
XtGetSelectionValueIncremental with corresponding individual
calls to XtSetSelectionParameters, and enclose these all
within XtCreateSelectionRequest and XtSendSelectionRequest.
XtGetSelectionValues and XtGetSelectionValuesIncremental
cannot be used to make selection requests with
parameterized targets.
SEE ALSO
XtGetSelectionParameters(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
Page 2 (printed 7/20/06)
