Manual Pages for UNIX Operating System command usage for man XtGetSelectionValuesIncremental

XT FUNCTIONS                  XtGetSelectionValueIncremental(3xt)



NAME
     XtGetSelectionValueIncremental, XtGetSelectionValues-
     Incremental - obtain selection values

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

     void XtGetSelectionValueIncremental(Widget w, Atom selec-
          tion, Atom target, XtSelectionCallbackProc callback,
          XtPointer client_data, Time time);

     void XtGetSelectionValuesIncremental(Widget w, Atom selec-
          tion, Atom *targets, int count, XtSelectionCallbackProc
          callback, XtPointer client_data, Time time);

ARGUMENTS
     callback  Specifies the callback procedure that is to be
               called when the selection value has been obtained.

     client_data
               Specifies the argument that is to be passed to the
               specified procedure when it is called.

     client_data
               Specifies the client data (one for each target
               type) that is passed to the callback procedure
               when it is called for that target.

     count     Specifies the length of the targets and
               client_data lists.

     selection Specifies the particular selection desired (that
               is, primary or secondary).

     target    Specifies the type of the information that is
               needed about the selection.

     targets   Specifies the types of information that is needed
               about the selection.

     time      Specifies the timestamp that indicates when the
               selection value is desired.

     w         Specifies the widget that is making the request.

DESCRIPTION
     The XtGetSelectionValueIncremental function is similar to
     XtGetSelectionValue except that the selection_callback pro-
     cedure will be called repeatedly upon delivery of multiple
     segments of the selection value.  The end of the selection
     value is indicated when selection_callback is called with a
     non-NULL value of length zero, which must still be freed by



X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                  XtGetSelectionValueIncremental(3xt)



     the client. If the transfer of the selection is aborted in
     the middle of a transfer (for example, because to timeout),
     the selection_callback procedure is called with a type value
     equal to the symbolic constant XT_CONVERT_FAIL so that the
     requestor can dispose of the partial selection value it has
     collected up until that point. Upon receiving
     XT_CONVERT_FAIL, the requesting client must determine for
     itself whether or not a partially completed transfer is
     meaningful.

     The XtGetSelectionValuesIncremental function is similar to
     XtGetSelectionValueIncremental except that it takes a list
     of target types and a list of client data and obtains the
     current value of the selection converted to each of the tar-
     gets.  The effect is as if each target were specified in a
     separate call to XtGetSelectionValueIncremental.  The call-
     back is called once with the corresponding client data for
     each target.  XtGetSelectionValuesIncremental does guarantee
     that all the conversions will use the same selection value
     because the ownership of the selection cannot change in the
     middle of the list, as would be when calling XtGetSelection-
     ValueIncremental repeatedly.

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