XtCreateSelectionRequest(3XXT FUNCTIXtCreateSelectionRequest(3Xt)
XtCreateSelectionRequest, XtSendSelectionRequest, XtCancel-
SelectionRequest - bundle multiple selection conversion
requests into a single request using MULTIPLE target
void XtCreateSelectionRequest(Widget requestor, Atom selec-
tion):
void XtSendSelectionRequest(Widget requestor, Atom selec-
tion, Time time);
void XtCancelSelectionRequest(Widget requestor, Atom selec-
tion);
requestor Specifies the widget making the request. Must be
of class Core or a subclass thereof.
selection Specifies the particular selection desired.
time Specifies the timestamp to be used in making the
request.
When XtCreateSelectionRequest is called, subsequent calls to
XtGetSelectionValue and XtGetSelectionValueIncremental with
the requestor and selection as specified to XtCreate-
SelectionRequest will be bundled into a single selection
conversion request with multiple targets. The request is
actually initiated by calling XtSendSelectionRequest.
When XtSendSelectionRequest is called with a value of
requestor and selection matching a previous call to
XtCreateSelectionRequest, a selection conversion request is
actually sent to the selection owner. If a single target
request is queued, that request is made. If multiple targets
are queued they are bundled into a single request with the
target MULTIPLE using the specified timestamp. As the
conversions are made, the callbacks associated with each
XtGetSelectionValue and XtGetSelectionValueIncremental are
invoked in turn.
Multi-threaded applications should lock the application con-
text before calling XtCreateSelectionRequest and release the
lock after calling XtSendSelectionRequest to ensure that the
thread assembling the reqeuest is safe from interference by
another thread assembling a different request naming the
same widget and selection.
When XtCancelSelectionRequest is called, any requests queued
since the last call to XtCreateSelectionRequest are cleaned
XFree86 Version 4.5.0 1
XtCreateSelectionRequest(3XXT FUNCTIXtCreateSelectionRequest(3Xt)
up. Subsequent calls to XtGetSelectionValue, XtGetSelection-
Values, XtGetSelectionValueIncremental, and XtGetSelection-
ValuesIncremental will not be defered.
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
XFree86 Version 4.5.0 2
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.