QBarDataProxy Class

QBarDataProxyクラスは、3D棒グラフのデータプロキシです。詳細...

ヘッダー #include <QBarDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
以来:QtDataVisualization 1.0
QML で: BarDataProxy
を継承: QAbstractDataProxy
継承元:

QItemModelBarDataProxy

プロパティ

パブリック機能

QBarDataProxy(QObject *parent = nullptr)
virtual ~QBarDataProxy()
int addRow(QBarDataRow *row)
int addRow(QBarDataRow *row, const QString &label)
int addRows(const QBarDataArray &rows)
int addRows(const QBarDataArray &rows, const QStringList &labels)
const QBarDataArray *array() const
QStringList columnLabels() const
void insertRow(int rowIndex, QBarDataRow *row)
void insertRow(int rowIndex, QBarDataRow *row, const QString &label)
void insertRows(int rowIndex, const QBarDataArray &rows)
void insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
const QBarDataItem *itemAt(const QPoint &position) const
const QBarDataItem *itemAt(int rowIndex, int columnIndex) const
void removeRows(int rowIndex, int removeCount, bool removeLabels = true)
void resetArray()
void resetArray(QBarDataArray *newArray)
void resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)
const QBarDataRow *rowAt(int rowIndex) const
int rowCount() const
QStringList rowLabels() const
QBar3DSeries *series() const
void setColumnLabels(const QStringList &labels)
void setItem(const QPoint &position, const QBarDataItem &item)
void setItem(int rowIndex, int columnIndex, const QBarDataItem &item)
void setRow(int rowIndex, QBarDataRow *row)
void setRow(int rowIndex, QBarDataRow *row, const QString &label)
void setRowLabels(const QStringList &labels)
void setRows(int rowIndex, const QBarDataArray &rows)
void setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

シグナル

void arrayReset()
void columnLabelsChanged()
void itemChanged(int rowIndex, int columnIndex)
void rowCountChanged(int count)
void rowLabelsChanged()
void rowsAdded(int startIndex, int count)
void rowsChanged(int startIndex, int count)
void rowsInserted(int startIndex, int count)
void rowsRemoved(int startIndex, int count)
void seriesChanged(QBar3DSeries *series)

詳細説明

バーデータプロキシは、データ行の追加、挿入、変更、削除を処理します。

データ配列は、QBarDataItem インスタンスのベクトル(行)のリストです。各行は、異なる数の項目を含むことができ、NULLであることもできます。

QBarDataProxy は、QtDataVisualization::QBarDataRow オブジェクトの所有権を持ちます。プロキシに配列を追加した後、バーデータの行ポインタを使用してデータを直接変更する場合は、グラフを更新するために適切なシグナルを発信する必要があります。

QBarDataProxyは、オプションで行ラベルと列ラベルの追跡を保持し、QCategory3DAxis 、軸ラベルの表示に利用できます。行ラベルと列ラベルはデータとは別の配列に格納され、行操作メソッドは行ラベルに影響を与えない代替バージョンを提供します。これにより、データそのものではなく、配列内のデータの位置に関連する行ラベルを持つことができます。

Qt Data Visualization データ処理も参照

プロパティのドキュメント

columnLabels : QStringList

このプロパティは、配列のオプションの列ラベルを保持する。

この配列のインデックスは、行の列インデックスと一致する。リストが最長の行よりも短い場合、すべての列はラベルを取得しません。

アクセス関数:

QStringList columnLabels() const
void setColumnLabels(const QStringList &labels)

通知シグナル:

void columnLabelsChanged()

[read-only] rowCount : const int

このプロパティは、配列の行数を保持する。

アクセス関数:

int rowCount() const

通知シグナル

void rowCountChanged(int count)

rowLabels : QStringList

このプロパティは、配列のオプションの行ラベルを保持する。

この配列のインデックスは、データ配列の行インデックスと一致する。リストが行数より短い場合は、すべての行にラベルが付与されません。

アクセス関数:

QStringList rowLabels() const
void setRowLabels(const QStringList &labels)

通知シグナル:

void rowLabelsChanged()

[read-only] series : QBar3DSeries* const

このプロパティは、このプロキシがアタッチされているシリーズを保持する。

アクセス関数:

QBar3DSeries *series() const

通知シグナル

void seriesChanged(QBar3DSeries *series)

メンバ関数ドキュメント

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

与えられたparent でバーデータプロキシを構築する。

[virtual noexcept] QBarDataProxy::~QBarDataProxy()

小節データのプロキシを削除する。

int QBarDataProxy::addRow(QBarDataRow *row)

新しい行row を配列の最後に追加する。既存の行ラベルは影響を受けません。

追加された行のインデックスを返します。

int QBarDataProxy::addRow(QBarDataRow *row, const QString &label)

ラベルがlabel の新しい行row を配列の末尾に追加します。

追加された行のインデックスを返します。

int QBarDataProxy::addRows(const QBarDataArray &rows)

新しいrows を配列の末尾に追加する。既存の行ラベルは影響を受けません。

最初に追加された行のインデックスを返します。

int QBarDataProxy::addRows(const QBarDataArray &rows, const QStringList &labels)

新しいrowslabels とともに配列の末尾に追加する。

最初に追加された行のインデックスを返します。

const QBarDataArray *QBarDataProxy::array() const

データ配列へのポインタを返します。

[signal] void QBarDataProxy::arrayReset()

このシグナルは、データ配列がリセットされたときに発せられる。resetArray() を呼び出さずに配列全体の内容が変更された場合、グラフを更新するためにこのシグナルを発する必要がある。

void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)

新しい行rowrowIndex に挿入する。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加される。既存の行ラベルは影響を受けない。

注意: 挿入された行の先にラベルの付いた行がある場合、この呼び出しの後、行ラベル配列は行配列と同期しなくなります。

void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row, const QString &label)

ラベルlabel を持つ新しい行rowrowIndex に挿入する。rowIndex が配列サイズと等しい場合、行は配列の末尾に追加される。

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows)

新しいrowsrowIndex に挿入する。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加される。既存の行ラベルは影響を受けない。

注意: 挿入された行の先にラベルの付いた行があった場合、この呼び出しの後、行ラベル配列は行配列と同期しなくなります。

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

labels を持つ新しいrowsrowIndex に挿入する。rowIndex が配列のサイズと等しい場合、行は配列の最後に追加される。

const QBarDataItem *QBarDataProxy::itemAt(const QPoint &position) const

位置position にある項目へのポインタを返す。position のx値は行を、y値は列を示す。この項目は、データを変更する次の呼び出しまで有効であることが保証される。

const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const

rowIndexcolumnIndex で指定された位置にある項目へのポインタを返す。 このポインタは、データを変更する次の呼び出しまで有効であることが保証されている。

[signal] void QBarDataProxy::itemChanged(int rowIndex, int columnIndex)

このシグナルは、rowIndexcolumnIndex で指定された位置の項目が変更されたときに発せられる。setItem() を呼び出さずにアイテムが配列内で変更された場合、グラフを更新するためにこのシグナルを発する必要がある。

void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)

rowIndex の位置から、removeCount で指定された行数を削除する。配列の末尾を越えて行を削除しようとしても何もしない。removeLabelstrue の場合、対応する行ラベルも削除される。それ以外の場合、行ラベルは影響を受けない。

注意: removeLabelsfalse の場合、削除された行の先にラベルの付いた行があると、行ラベル配列は行配列と同期しない。

void QBarDataProxy::resetArray()

既存の配列と行と列のラベルを消去する。

void QBarDataProxy::resetArray(QBarDataArray *newArray)

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

null 配列を渡すと、古い配列は削除され、新しい空の配列が作成されます。行と列のラベルは影響を受けません。

void QBarDataProxy::resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)

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

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

rowLabelscolumnLabels のリストは、行と列の新しいラベルを指定します。

const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const

位置rowIndex にある行へのポインタを返す。このポインタは、データを変更する次の呼び出しまで有効であることが保証される。

[signal] void QBarDataProxy::rowsAdded(int startIndex, int count)

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

[signal] void QBarDataProxy::rowsChanged(int startIndex, int count)

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

[signal] void QBarDataProxy::rowsInserted(int startIndex, int count)

このシグナルは、count で指定された数の行がstartIndex の位置に挿入されたときに発せられる。

insertRow() またはinsertRows() を呼び出さずに行が配列に挿入された場合、グラフを更新するためにこのシグナルを発行する必要がある。

[signal] void QBarDataProxy::rowsRemoved(int startIndex, int count)

このシグナルは、count で指定された行数が、startIndex の位置から削除されたときに発せられる。

インデックスには、配列の末尾から行が削除された場合の現在の配列サイズを指定する。removeRows()を呼び出さずに配列から行が削除された場合、グラフを更新するためにこのシグナルを発する必要がある。

void QBarDataProxy::setItem(const QPoint &position, const QBarDataItem &item)

位置position の単一項目を項目item に変更する。position の x 値は行を、y 値は列を示す。

void QBarDataProxy::setItem(int rowIndex, int columnIndex, const QBarDataItem &item)

rowIndexcolumnIndex で指定された位置の単一項目を、項目item に変更する。

void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row)

rowIndex の位置の行を、row で指定された新しい行に置き換えることで、既存の行を変更する。新しい行は、既にrowIndex に格納されている既存の行と同じにすることができる。既存の行ラベルは影響を受けない。

void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row, const QString &label)

rowIndex の位置の行を、row で指定された新しい行に置き換えることで、既存の行を変更する。新しい行は、既にrowIndex に格納されている既存の行と同じにすることができる。行ラベルをlabel に変更する。

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows)

rowIndex の位置から始まる行をrows で指定される新しい行に置き換えることで、既存の行を変更します。既存の行ラベルは影響を受けない。配列rows の行は、すでにrowIndex に格納されている既存の行と同じにすることができる。

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

rowIndex の位置から始まる行を、rows で指定される新しい行に置き換えることで、既存の行を変更する。行のラベルはlabels に変更される。rows 配列の行は、既にrowIndex に格納されている既存の行と同じにすることができる。

関連する非会員

QBarDataArray

QBarDataRow オブジェクトへのポインタのリスト。

QBarDataRow

QBarDataItem オブジェクトのリスト。

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