diff options
author | Tomi Korpipää <tomi.korpipaa@digia.com> | 2013-08-16 07:14:35 +0300 |
---|---|---|
committer | Tomi Korpipää <tomi.korpipaa@digia.com> | 2013-08-16 07:14:35 +0300 |
commit | 6c0334496d50aaf4e11dcda7ed642fac565d6145 (patch) | |
tree | aa6e7aeef9b00ba46910c30bd85fedbc53df39a0 /src/datavis3d/data/qscatterdataproxy.h | |
parent | 3288b23502c195d03e097cb372a22f3a1ac4ba87 (diff) | |
parent | 29f6433606cebe3299e9915ae32bae7dfaed2770 (diff) |
Merge remote-tracking branch 'origin/develop'
Change-Id: I544af544ecd946cdcccfe9c17d03e47f8d0c1151
Diffstat (limited to 'src/datavis3d/data/qscatterdataproxy.h')
-rw-r--r-- | src/datavis3d/data/qscatterdataproxy.h | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/src/datavis3d/data/qscatterdataproxy.h b/src/datavis3d/data/qscatterdataproxy.h new file mode 100644 index 00000000..9e139c00 --- /dev/null +++ b/src/datavis3d/data/qscatterdataproxy.h @@ -0,0 +1,87 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVis3D module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +#ifndef QSCATTERDATAPROXY_H +#define QSCATTERDATAPROXY_H + +#include <QtDataVis3D/qabstractdataproxy.h> +#include <QtDataVis3D/qscatterdataitem.h> + +QT_DATAVIS3D_BEGIN_NAMESPACE + +typedef QVector<QScatterDataItem> QScatterDataArray; + +class QScatterDataProxyPrivate; + +class QT_DATAVIS3D_EXPORT QScatterDataProxy : public QAbstractDataProxy +{ + Q_OBJECT + +public: + explicit QScatterDataProxy(); + explicit QScatterDataProxy(QScatterDataProxyPrivate *d); + virtual ~QScatterDataProxy(); + + // QScatterDataProxy is optimized to use cases where the only defining characteristics of an + // individual scatter item are it's position and size. Modifying other data that might be + // added in the future such as color requires allocating additional data object for the bar. + + // Item pointers are guaranteed to be valid only until next call that modifies data. + // Array pointer is guaranteed to be valid for lifetime of proxy. + int itemCount() const; + const QScatterDataArray *array() const; + const QScatterDataItem *itemAt(int index) const; + + // Clears the existing array and takes ownership of the new array. + // Passing null array clears all data. + void resetArray(QScatterDataArray *newArray); + + // Change existing items + void setItem(int index, const QScatterDataItem &item); + void setItems(int index, const QScatterDataArray &items); + + int addItem(const QScatterDataItem &item); // returns the index of added item + int addItems(const QScatterDataArray &items); // returns the index of first added item + + // If index is equal to data array size, item(s) are added to the array. + void insertItem(int index, const QScatterDataItem &item); + void insertItems(int index, const QScatterDataArray &items); + + // Attempting to remove items past the end of the array does nothing. + void removeItems(int index, int removeCount); + +signals: + void arrayReset(); + void itemsAdded(int startIndex, int count); + void itemsChanged(int startIndex, int count); + void itemsRemoved(int startIndex, int count); // Index may be over current array size if removed from end + void itemsInserted(int startIndex, int count); + +protected: + QScatterDataProxyPrivate *dptr(); + const QScatterDataProxyPrivate *dptrc() const; + +private: + Q_DISABLE_COPY(QScatterDataProxy) + + friend class Scatter3DController; +}; + +QT_DATAVIS3D_END_NAMESPACE + +#endif |