XtGetSelectionRequest()XtGetSelectionRequest()Name
XtGetSelectionRequest - retrieve the SelectionRequest event that trig‐
gered 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 selec‐
tions, or NULL in the case of atomic transfers.
Returns
A pointer to a SelectionRequest event structure.
Availability
Release 4 and later.
DescriptionXtGetSelectionRequest() may only be called from within an XtConvertSe‐
lectionProc 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 trans‐
fers are outstanding. For atomic transfers, request_id must be speci‐
fied 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 AlsoXtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtOwnSelec‐
tion(1),
XtConvertSelectionProc(2).
Xt - Selections XtGetSelectionRequest()