このページでは

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
継承元:

QItemModelScatterDataProxy

プロパティ

パブリック関数

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)
void resetScaleArray(QList<QVector3D> newArray)
QVector3D scaleAt(qsizetype index) const
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 : qsizetype

このプロパティは、配列に含まれる要素の数を保持します。

アクセス関数:

qsizetype itemCount() const

通知シグナル:

void itemCountChanged(qsizetype count)

[read-only] series : QScatter3DSeries*

このプロパティには、このプロキシが関連付けられているシリーズが格納されます。

アクセス関数:

QScatter3DSeries *series() const

通知シグナル:

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)

このシグナルは、`count ` で指定された数の項目が、`startIndex` の位置から順に変更されたときに発せられます。setItem()` またはsetItems() を呼び出さずに配列内の項目を変更した場合、グラフを更新するためにこのシグナルを発する必要があります。

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

このシグナルは、startIndex の位置から、count で指定された数の要素が挿入されたときに発せられます。insertItem() またはinsertItems() を呼び出さずに配列に要素を挿入した場合、グラフを更新するためにこのシグナルを発する必要があります。

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

このシグナルは、`count ` で指定された行数が、位置 `startIndex` から順に削除されたときに発信されます。配列の末尾から要素が削除される場合、インデックスは現在の配列のサイズを超えることがあります。removeItems() を呼び出さずに配列から要素を削除した場合は、グラフを更新するためにこのシグナルを発信する必要があります。

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

index で指定された位置から、removeCount で指定された数の要素を削除します。配列の末尾より先の要素を削除しようとしても、何も起こりません。

void QScatterDataProxy::resetArray()

既存の配列をクリアし、arrayReset() 信号をトリガーします。

void QScatterDataProxy::resetArray(QScatterDataArray newArray)

newArray から配列を設定します。新しい配列が既存の配列と等しい場合、この関数は単にarrayReset() 信号をトリガーします。

void QScatterDataProxy::resetScaleArray(QList<QVector3D> newArray)

newArray から scale 配列を設定します。新しい配列が既存の配列と等しい場合、この関数は単に scaleArrayReset() シグナルをトリガーします。

QVector3D QScatterDataProxy::scaleAt(qsizetype index) const

インデックスindex にあるスケールデータを返します。このデータが有効なのは、データを変更する次の呼び出しが行われるまでです。

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

位置index にある項目を、項目item に置き換えます。

void QScatterDataProxy::setItems(qsizetype index, QScatterDataArray items)

位置index から始まる項目を、items で指定された項目に置き換えます。

関連する非メンバー

[alias] QScatterDataArray

QScatterDataItem オブジェクトの一覧。

© 2026 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.