Name

XtGetSelectionValuesIncremental — obtain multiple selection values using incremental transfers. 

Synopsis

void XtGetSelectionValuesIncremental(w, selection, targets, count, selection_callback, client_data, time)

      Widget w;
      Atom selection;
      Atom ∗targets;
      int count;
      XtSelectionIncrCallbackProc selection_callback;
      XtPointer ∗client_data;
      Time time;

Arguments

wSpecifies the widget that is making the request. 

selectionSpecifies the particular selection desired (e.g., XA_PRIMARY or XA_SECONDARY). 

targetsSpecifies the types of information that is needed about the selection (e.g., HOST, USER). 

countSpecifies the length of the targets and client_data lists. 

selection_callback
Specifies the callback procedure that is to be called to receive each selection value.

client_data
Specifies a list of client data (one for each target type) that is passed to the callback procedures when they are invoked for the corresponding target.

timeSpecifies the timestamp that indicates when the selection request was initiated.  This should be the timestamp of the event which triggered this request; the value CurrentTime is not acceptable. 

Description

XtGetSelectionValuesIncremental is similar to XtGetSelectionValueIncremental except that the former takes a list of targets and client_data.  XtGetSelectionValuesIncremental is equivalent to calling XtGetSelectionValueIncremental successively for each target/client_data pair except that XtGetSelectionValuesIncremental guarantees 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 possible when calling XtGetSelectionValueIncremental repeatedly. 

See Also

XtGetSelectionValue(1), XtGetSelectionValueIncremental(1), XtOwnSelectionIncremental(1).