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

wSpecifies the widget which currently owns this selection. 

selectionSpecifies 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). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates