xtgetselectionrequest(3xt) [xfree86 man page]

XtGetSelectionRequest(3Xt)					   XT FUNCTIONS 					XtGetSelectionRequest(3Xt)

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 mul-
       tiple 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

XFree86 							   Version 4.7.0					XtGetSelectionRequest(3Xt)

XtGetSelectionRequest() 												   XtGetSelectionRequest()

Name
  XtGetSelectionRequest - retrieve the SelectionRequest event that triggered a XtConvertSelectionProc.

Synopsis
  XSelectionRequestEvent *XtGetSelectionRequest(w, selection, request_id)
	   Widget w;
	   Atom selection;
	   XtRequestId request_id;

Inputs
  w	    Specifies the widget which currently owns this selection.

  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.

Returns
  A pointer to a SelectionRequest event structure.

Availability
  Release 4 and later.

Description
  XtGetSelectionRequest()  may only be called from within an XtConvertSelectionProc and returns a pointer to the SelectionRequest event which
  caused the 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 ID, XtGetSelectionRequest() returns NULL.

Usage
  An XtConvertSelectionProc is not passed the event that triggered it, but it needs the timestamp of this event in order to comply  with  the
  ICCCM.  XtGetSelectionRequest() was added in Release 4 as a work-around to this problem.

See Also
  XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtOwnSelection(1),
  XtConvertSelectionProc(2).

Xt - Selections 													   XtGetSelectionRequest()