XtGetSelectionRequest (3)

Leading comments

Copyright (c) 1993, 1994  X Consortium

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software furnished to do so, subject to the following conditions:

The above copyright notice...

(The comments found at the beginning of the groff file "man3/XtGetSelectionRequest.3".)

NAME

XtGetSelectionRequest - retrieve the event that triggered the XtConvertSelectionProc

SYNTAX

XSelectionRequestEvent* XtGetSelectionRequest(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.

SEE ALSO

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