hpux man page for xtgetseleca

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()