QScatterDataProxy Class
QScatterDataProxy 类是 3D 散点图的数据代理。更多
头文件: | #include <QScatterDataProxy> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
qmake: | QT += datavisualization |
自 | QtDataVisualization 1.0 |
在 QML 中: | ScatterDataProxy |
继承于: | QAbstractDataProxy |
继承于: |
属性
公共功能
QScatterDataProxy(QObject *parent = nullptr) | |
virtual | ~QScatterDataProxy() |
int | addItem(const QScatterDataItem &item) |
int | addItems(const QScatterDataArray &items) |
const QScatterDataArray * | array() const |
void | insertItem(int index, const QScatterDataItem &item) |
void | insertItems(int index, const QScatterDataArray &items) |
const QScatterDataItem * | itemAt(int index) const |
int | itemCount() const |
void | removeItems(int index, int removeCount) |
void | resetArray(QScatterDataArray *newArray) |
QScatter3DSeries * | series() const |
void | setItem(int index, const QScatterDataItem &item) |
void | setItems(int index, const QScatterDataArray &items) |
信号
void | arrayReset() |
void | itemCountChanged(int count) |
void | itemsAdded(int startIndex, int count) |
void | itemsChanged(int startIndex, int count) |
void | itemsInserted(int startIndex, int count) |
void | itemsRemoved(int startIndex, int count) |
void | seriesChanged(QScatter3DSeries *series) |
相关非成员
详细说明
散点数据代理处理数据项的添加、插入、更改和删除。
QScatterDataProxy 拥有传递给它的所有 QtDataVisualization::QScatterDataArray 和QScatterDataItem 对象的所有权。
另请参阅 Qt Data Visualization 数据处理。
属性文档
[read-only]
itemCount : const int
此属性用于保存数组中的条目数。
访问功能:
int | itemCount() const |
通知信号:
void | itemCountChanged(int count) |
[read-only]
series : QScatter3DSeries* const
此属性表示此代理所连接的系列。
访问功能:
QScatter3DSeries * | series() const |
Notifier 信号:
void | seriesChanged(QScatter3DSeries *series) |
成员函数 文档
[explicit]
QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)
使用给定的parent 构建 QScatterDataProxy。
[virtual noexcept]
QScatterDataProxy::~QScatterDataProxy()
删除散点数据代理。
int QScatterDataProxy::addItem(const QScatterDataItem &item)
将项目item 添加到数组末尾。
返回添加项的索引。
int QScatterDataProxy::addItems(const QScatterDataArray &items)
将items 指定的项目添加到数组末尾。
返回第一个添加项的索引。
const QScatterDataArray *QScatterDataProxy::array() const
返回数据数组的指针。
[signal]
void QScatterDataProxy::arrayReset()
数据数组重置时会发出该信号。如果在未调用resetArray() 的情况下更改了整个数组的内容,则需要发出此信号来更新图形。
void QScatterDataProxy::insertItem(int index, const QScatterDataItem &item)
将项目item 插入位置index 。如果索引等于数据数组的大小,则将项目添加到数组中。
void QScatterDataProxy::insertItems(int index, const QScatterDataArray &items)
将items 指定的项目插入index 位置。如果索引等于数据数组的大小,则项目将被添加到数组中。
const QScatterDataItem *QScatterDataProxy::itemAt(int index) const
返回位于索引index 处的项目指针。在下一次调用修改数据之前,该指针保证有效。
[signal]
void QScatterDataProxy::itemsAdded(int startIndex, int count)
当从startIndex 位置开始添加count 指定数量的项目时,将发出该信号。如果在未调用addItem() 或addItems() 的情况下将项目添加到数组,则需要发出此信号以更新图形。
[signal]
void QScatterDataProxy::itemsChanged(int startIndex, int count)
当count 指定的条目数从startIndex 位置开始发生变化时,将发出该信号。如果没有调用setItem() 或setItems() 就更改了数组中的项目,则需要发出此信号来更新图形。
[signal]
void QScatterDataProxy::itemsInserted(int startIndex, int count)
从startIndex 位置开始插入count 指定数量的项目时,将发出该信号。如果在未调用insertItem() 或insertItems() 的情况下将项目插入数组,则需要发出此信号以更新图形。
[signal]
void QScatterDataProxy::itemsRemoved(int startIndex, int count)
当从startIndex 位置开始移除count 指定的行数时,会发出该信号。如果从末尾删除了条目,索引可能会大于当前数组的大小。如果在未调用removeItems() 的情况下从数组中移除项目,则需要发出此信号以更新图形。
void QScatterDataProxy::removeItems(int index, int removeCount)
从index 位置开始,移除removeCount 指定数量的条目。如果试图删除数组末尾的项目,则不会有任何效果。
void QScatterDataProxy::resetArray(QScatterDataArray *newArray)
获取数组newArray 的所有权。如果新数组与现有数组不同,则清除现有数组。如果数组相同,该函数只会触发arrayReset() 信号。
传递一个空数组会删除旧数组并创建一个新的空数组。
void QScatterDataProxy::setItem(int index, const QScatterDataItem &item)
用item 替换位置index 上的项目。
void QScatterDataProxy::setItems(int index, const QScatterDataArray &items)
用items 指定的项目替换从位置index 开始的项目。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.