XtCreateSelectionRequest(3XXT FUNCTIXtCreateSelectionRequest(3Xt)NAME
XtCreateSelectionRequest, XtSendSelectionRequest,
XtCancelSelectionRequest - bundle multiple selection con-
version requests into a single request using MULTIPLE tar-
get
SYNTAX
void XtCreateSelectionRequest(requestor, selection)
Widget requestor;
Atom selection;
void XtSendSelectionRequest(requestor, selection, time)
Widget requestor;
Atom selection;
Time time;
void XtCancelSelectionRequest(requestor, selection)
Widget requestor;
Atom selection;
ARGUMENTS
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.
DESCRIPTION
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 tar-
get 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 XtGetSelectionValueIncremen-
tal are invoked in turn.
Multi-threaded applications should lock the application
context 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.
X Version 11 Release 6.4 1
XtCreateSelectionRequest(3XXT FUNCTIXtCreateSelectionRequest(3Xt)
When XtCancelSelectionRequest is called, any requests
queued since the last call to XtCreateSelectionRequest are
cleaned up. Subsequent calls to XtGetSelectionValue,
XtGetSelectionValues, XtGetSelectionValueIncremental, and
XtGetSelectionValuesIncremental will not be defered.
SEE ALSO
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
X Version 11 Release 6.4 2