X Version 11 (Release 6.1)

XtGetSelectionRequest(X3xt)


XtGetSelectionRequest -- retrieve the event that triggered the XtConvertSelectionProc

Synopsis

XSelectionRequestEvent* XtGetSelectionRequest(w, selection,
              request_id)
    Widget w;
    Atom selection;
    XtRequestId request_id;

Arguments


w
Specifies the widget.

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.

Description

XtGetSelectionRequest may only be called from within an XtConvertSelectionProc procedure and returns a pointer to the SelectionRequest event that caused the conversion 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.

References

X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004