QBarDataProxy Class

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

Header: #include <QBarDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
In QML: BarDataProxy
Inherits: QAbstractDataProxy
Inherited By:

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

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

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)

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

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

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

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

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

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

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

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

位置position にある 1 つの項目を、項目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 オブジェクトのリスト。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。