XtSetSelectionParameters(3XXT FUNCTIXtSetSelectionParameters(3Xt)NAMEXtSetSelectionParameters - 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 XtGetSe-
lectionValue or to XtGetSelectionValueIncremental specify-
ing the same requestor widget and selection atomm will
generate a ConvertSelection request referring referring to
the property containing the parameters. If XtSetSelection-
Parameters 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 subse-
quent 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, pre-
cede individual calls to XtGetSelectionValue and
X Version 11 Release 6.4 1
XtSetSelectionParameters(3XXT FUNCTIXtSetSelectionParameters(3Xt)
XtGetSelectionValueIncremental with corresponding individ-
ual calls to XtSetSelectionParameters, and enclose these
all within XtCreateSelectionRequest and
XtSendSelectionRequest. XtGetSelectionValues and XtGetSe-
lectionValuesIncremental cannot be used to make selection
requests with parameterized targets.
SEE ALSOXtGetSelectionParameters(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
X Version 11 Release 6.4 2