このページでは

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

QItemModelScatterDataProxy

ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

パブリック関数

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 : int

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

アクセス関数:

int itemCount() const

通知シグナル:

void itemCountChanged(int count)

[read-only] series : QScatter3DSeries*

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

アクセス関数:

QScatter3DSeries *series() const

通知シグナル:

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)

このシグナルは、`count ` で指定された数の項目が、位置 `startIndex` から順に追加されたときに発信されます。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)

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

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

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

void QScatterDataProxy::resetArray(QScatterDataArray *newArray)

配列newArray の所有権を取得します。新しい配列が既存の配列と異なる場合、既存の配列をクリアします。配列が同じ場合、この関数は単にarrayReset()シグナルをトリガーするだけです。

null 配列を渡すと、古い配列が削除され、新しい空の配列が作成されます。

void QScatterDataProxy::setItem(int index, const QScatterDataItem &item)

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

void QScatterDataProxy::setItems(int index, const QScatterDataArray &items)

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

関連する非メンバー

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.