Name

XtGetSelectionRequest — retrieve the SelectionRequest event that triggered the XtConvertSelectionProc. 

Synopsis

XSelectionRequestEvent ∗XtGetSelectionRequest(w, selection, request_id)

      Widget w;
      Atom selection;
      XtRequestId request_id;

Arguments

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. 

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 request_id, XtGetSelectionRequest returns NULL. 

See Also

XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtGetSelectionValues(1), XtGetSelectionValuesIncremental(1), XtOwnSelection(1), XtOwnSelectionIncremental(1).