QScatterDataProxy Class

The QScatterDataProxy class is the data proxy for 3D scatter graphs. 更多...

头: #include <QScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML: ScatterDataProxy
继承: QAbstractDataProxy
继承者:

QItemModelScatterDataProxy

特性

公共函数

QScatterDataProxy (QObject * parent = nullptr)
virtual ~QScatterDataProxy () override
qsizetype addItem (QScatterDataItem item )
qsizetype addItems (QScatterDataArray )
void insertItem (qsizetype index , QScatterDataItem item )
void insertItems (qsizetype index , QScatterDataArray )
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 )

信号

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 )
QScatterDataArray

详细描述

A scatter data proxy handles adding, inserting, changing, and removing data items. Since data is stored in series, it is necessary to create a series associated with the proxy before using these functions for the dataset.

QScatterDataProxy takes ownership of all QtGraphs::QScatterDataArray and QScatterDataItem objects passed to it.

另请参阅 Qt Graphs Data Handling with 3D .

特性文档编制

[read-only] itemCount : const qsizetype

This property holds the number of items in the array.

访问函数:

qsizetype itemCount () const

通知程序信号:

void itemCountChanged (qsizetype count )

[read-only] series : QScatter3DSeries * const

This property holds the series this proxy is attached to.

访问函数:

QScatter3DSeries * series () const

通知程序信号:

void seriesChanged (QScatter3DSeries * series )

成员函数文档编制

[explicit] QScatterDataProxy:: QScatterDataProxy ( QObject * parent = nullptr)

Constructs QScatterDataProxy with the given parent .

[override virtual noexcept] QScatterDataProxy:: ~QScatterDataProxy ()

Deletes the scatter data proxy.

qsizetype QScatterDataProxy:: addItem ( QScatterDataItem item )

Adds the item item to the end of the array.

Returns the index of the added item.

qsizetype QScatterDataProxy:: addItems ( QScatterDataArray )

Adds the items specified by items to the end of the array.

Returns the index of the first added item.

[signal] void QScatterDataProxy:: arrayReset ()

This signal is emitted when the data array is reset. If the contents of the whole array are changed without calling resetArray (), this signal needs to be emitted to update the graph.

void QScatterDataProxy:: insertItem ( qsizetype index , QScatterDataItem item )

Inserts the item item to the position index . If the index is equal to the data array size, the item is added to the array.

void QScatterDataProxy:: insertItems ( qsizetype index , QScatterDataArray )

Inserts the items specified by items to the position index . If the index is equal to data array size, the items are added to the array.

const QScatterDataItem &QScatterDataProxy:: itemAt ( qsizetype index ) const

Returns the pointer to the item at the index index . It is guaranteed to be valid only until the next call that modifies data.

[signal] void QScatterDataProxy:: itemsAdded ( qsizetype startIndex , qsizetype count )

This signal is emitted when the number of items specified by count are added, starting at the position startIndex . If items are added to the array without calling addItem () 或 addItems (), this signal needs to be emitted to update the graph.

[signal] void QScatterDataProxy:: itemsChanged ( qsizetype startIndex , qsizetype count )

This signal is emitted when the number of items specified by count are changed, starting at the position startIndex . If items are changed in the array without calling setItem () 或 setItems (), this signal needs to be emitted to update the graph.

[signal] void QScatterDataProxy:: itemsInserted ( qsizetype startIndex , qsizetype count )

This signal is emitted when the number of items specified by count are inserted, starting at the position startIndex . If items are inserted into the array without calling insertItem () 或 insertItems (), this signal needs to be emitted to update the graph.

[signal] void QScatterDataProxy:: itemsRemoved ( qsizetype startIndex , qsizetype count )

This signal is emitted when the number of rows specified by count are removed, starting at the position startIndex . The index may be larger than the current array size if items are removed from the end. If items are removed from the array without calling removeItems (), this signal needs to be emitted to update the graph.

void QScatterDataProxy:: removeItems ( qsizetype index , qsizetype removeCount )

Removes the number of items specified by removeCount starting at the position index . Attempting to remove items past the end of the array does nothing.

void QScatterDataProxy:: resetArray ()

Clears the existing array and triggers the arrayReset () 信号。

void QScatterDataProxy:: resetArray ( QScatterDataArray newArray )

Sets the array from newArray . If the new array is equal to the existing one, this function simply triggers the arrayReset () 信号。

void QScatterDataProxy:: setItem ( qsizetype index , QScatterDataItem item )

Replaces the item at the position index with the item item .

void QScatterDataProxy:: setItems ( qsizetype index , QScatterDataArray )

Replaces the items starting from the position index with the items specified by items .

相关非成员

[alias] QScatterDataArray

A list of QScatterDataItem 对象。