Manual Pages for UNIX Operating System command usage for man XtCreateSelectionRequest

XT FUNCTIONS                        XtCreateSelectionRequest(3xt)



NAME
     XtCreateSelectionRequest, XtSendSelectionRequest, XtCancel-
     SelectionRequest - bundle multiple selection conversion
     requests into a single request using MULTIPLE target

SYNTAX
     cc [ flag... ] file... -lXt [ library... ]

     void XtCreateSelectionRequest(Widget requestor, Atom selec-
          tion):

     void XtSendSelectionRequest(Widget requestor, Atom selec-
          tion, Time time);

     void XtCancelSelectionRequest(Widget requestor, Atom selec-
          tion);

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 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 request is safe from interference by
     another thread assembling a different request naming the
     same widget and selection.




X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                        XtCreateSelectionRequest(3xt)



     When XtCancelSelectionRequest is called, any requests queued
     since the last call to XtCreateSelectionRequest are cleaned
     up. Subsequent calls to XtGetSelectionValue, XtGetSelection-
     Values, XtGetSelectionValueIncremental, and XtGetSelection-
     ValuesIncremental will not be deferred.

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


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Availability                | x11/library/toolkit/libxt         |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed                         |
    |_____________________________|___________________________________|
    | MT-Level                    | See XtToolkitThreadInitialize(3XT)|
    |_____________________________|___________________________________|































X Version 11        Last change: libXt 1.0.8                    2