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