XtSetSelectionParameters(3) XT FUNCTIONS XtSetSelectionParameters(3)

# [NAME](#NAME)

XtSetSelectionParameters - specify target parameters for a selection request with a single target

# [SYNTAX](#SYNTAX)

#include <X11/Intrinsic.h>

void XtSetSelectionParameters(Widget *requestor*, Atom *selection*, Atom *type*, XtPointer *value*, unsigned long *length*, int *format*);

# [ARGUMENTS](#ARGUMENTS)

[*requestor*](#requestor)

Specifies the widget making the request. Must be of class Core or any subclass thereof.

[*selection*](#selection)

Specifies the atom that names the selection.

[*type*](#type)

Specifies the type of the property in which the parameters will be passed.

[*value*](#value)

Specifies a pointer to the parameters.

[*length*](#length)

Specifies the number of elements containing data in *value*, each element of a sized indicated by *format*.

[*format*](#format)

Specifies the size in bits of the data in the elements of *value*.

# [DESCRIPTION](#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 atom 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 **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](#SEE_ALSO)

[XtGetSelectionParameters(3)](/man/os/libxt/XtGetSelectionParameters.3)  
*X Toolkit Intrinsics - C Language Interface*  
*Xlib - C Language X Interface*

libXt 1.3.1 X Version 11

---

Document: XtSetSelectionParameters(3) from libxt 1.3.1-r9 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxt.git