QScatterDataProxy Class
QScatterDataProxy 类是 3D 散点图的数据代理。更多
头文件: | #include <QScatterDataProxy> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
qmake: | QT += graphs |
在 QML 中: | ScatterDataProxy |
继承: | QAbstractDataProxy |
继承于: |
- 所有成员的列表,包括继承成员
- QScatterDataProxy 是Qt Graphs C++ Classes for 3D 的一部分。
属性
公共功能
QScatterDataProxy(QObject *parent = nullptr) | |
virtual | ~QScatterDataProxy() override |
qsizetype | addItem(QScatterDataItem item) |
qsizetype | addItems(QScatterDataArray items) |
void | insertItem(qsizetype index, QScatterDataItem item) |
void | insertItems(qsizetype index, QScatterDataArray items) |
const QScatterDataItem & | itemAt(qsizetype index) const |
qsizetype | itemCount() const |
void | removeItems(qsizetype index, qsizetype removeCount) |
void | resetArray() |
void | resetArray(QScatterDataArray newArray) |
QScatter3DSeries * | series() const |
void | setItem(qsizetype index, QScatterDataItem item) |
void | setItems(qsizetype index, QScatterDataArray items) |
信号
void | arrayReset() |
void | itemCountChanged(qsizetype count) |
void | itemsAdded(qsizetype startIndex, qsizetype count) |
void | itemsChanged(qsizetype startIndex, qsizetype count) |
void | itemsInserted(qsizetype startIndex, qsizetype count) |
void | itemsRemoved(qsizetype startIndex, qsizetype count) |
void | seriesChanged(QScatter3DSeries *series) |
相关非成员
详细说明
散点数据代理可处理数据项的添加、插入、更改和删除。由于数据存储在系列中,因此在使用数据集的这些函数之前,有必要创建一个与代理相关联的系列。
QScatterDataProxy 拥有传递给它的所有 QtGraphs::QScatterDataArray 和QScatterDataItem 对象的所有权。
另请参阅 Qt Graphs 3D 数据处理。
属性文档
[read-only]
itemCount : const qsizetype
此属性用于保存数组中的条目数。
访问功能:
qsizetype | itemCount() const |
通知信号:
void | itemCountChanged(qsizetype count) |
[read-only]
series : QScatter3DSeries* const
此属性表示此代理所连接的系列。
访问功能:
QScatter3DSeries * | series() const |
Notifier 信号:
void | seriesChanged(QScatter3DSeries *series) |
成员函数 文档
[explicit]
QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)
使用给定的parent 构建 QScatterDataProxy。
[override virtual noexcept]
QScatterDataProxy::~QScatterDataProxy()
删除散点数据代理。
qsizetype QScatterDataProxy::addItem(QScatterDataItem item)
将项目item 添加到数组末尾。
返回添加项的索引。
qsizetype QScatterDataProxy::addItems(QScatterDataArray items)
将items 指定的项目添加到数组末尾。
返回第一个添加项的索引。
[signal]
void QScatterDataProxy::arrayReset()
数据数组重置时会发出该信号。如果在未调用resetArray() 的情况下更改了整个数组的内容,则需要发出此信号来更新图形。
void QScatterDataProxy::insertItem(qsizetype index, QScatterDataItem item)
将项目item 插入位置index 。如果索引等于数据数组的大小,则将项目添加到数组中。
void QScatterDataProxy::insertItems(qsizetype index, QScatterDataArray items)
将items 指定的项目插入index 位置。如果索引等于数据数组的大小,则项目将被添加到数组中。
const QScatterDataItem &QScatterDataProxy::itemAt(qsizetype index) const
返回位于索引index 处的项目指针。在下一次调用修改数据之前,该指针保证有效。
[signal]
void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)
从位置startIndex 开始,添加count 指定数量的项目时,会发出该信号。如果在未调用addItem() 或addItems() 的情况下将项目添加到数组,则需要发出此信号以更新图形。
[signal]
void QScatterDataProxy::itemsChanged(qsizetype startIndex, qsizetype count)
从startIndex 位置开始,当count 指定的项目数发生变化时,将发出该信号。如果没有调用setItem() 或setItems() 就更改了数组中的项目,则需要发出此信号来更新图形。
[signal]
void QScatterDataProxy::itemsInserted(qsizetype startIndex, qsizetype count)
当从startIndex 位置开始插入count 指定数量的项目时,将发出该信号。如果在未调用insertItem() 或insertItems() 的情况下将项目插入数组,则需要发出此信号以更新图形。
[signal]
void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)
当从startIndex 位置开始移除count 指定的行数时,会发出该信号。如果从末尾删除了条目,索引可能会大于当前数组的大小。如果在未调用removeItems() 的情况下从数组中移除项目,则需要发出此信号以更新图形。
void QScatterDataProxy::removeItems(qsizetype index, qsizetype removeCount)
从index 位置开始,移除removeCount 指定数量的条目。如果试图删除数组末尾的项目,则不会有任何效果。
void QScatterDataProxy::resetArray()
清除现有数组并触发arrayReset() 信号。
void QScatterDataProxy::resetArray(QScatterDataArray newArray)
从newArray 开始设置数组。如果新数组与现有数组相等,该函数会触发arrayReset() 信号。
void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)
用item 替换位置index 上的项目。
void QScatterDataProxy::setItems(qsizetype index, 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.