---
name: "XtGetSelectionRequest"
section: "3x"
platform: "linux"
package: "libxt-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XtGetSelectionRequest/3x"
---

# XtGetSelectionRequest(3x)

retrieve the event that triggered the XtConvertSelectionProc

## NAME

XtGetSelectionRequest - retrieve the event that triggered the XtConvertSelectionProc

## SYNTAX

XSelectionRequestEvent\* XtGetSelectionRequest(Widget *w*, Atom *selection*, XtRequestId *request\_id*);

## ARGUMENTS

- *w*

  Specifies the widget.

- *selection*

  Specifies the selection being processed.

- *request\_id*

  Specifies the requestor id in the case of incremental selections, or NULL in the case of atomic transfers.

## DESCRIPTION

*XtGetSelectionRequest* may only be called from within an *XtConvertSelectionProc* procedure and returns a pointer to the *SelectionRequest* event that caused the conversion procedure to be invoked. *Request\_id* specifies a unique id for the individual request in the case that multiple incremental transfers are outstanding. For atomic transfers, *request\_id* must be specified as NULL. If no *SelectionRequest* event is being processed for the specified *widget*, *selection*, and *request\_id*, *XtGetSelectionRequest* returns NULL.

## SEE ALSO

*X Toolkit Intrinsics - C Language Interface*\
 *Xlib - C Language X Interface*
