QBarDataProxy Class

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

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

QItemModelBarDataProxy

プロパティ

パブリック機能

QBarDataProxy(QObject *parent = nullptr)
virtual ~QBarDataProxy() override
qsizetype addRow(QBarDataRow row)
qsizetype addRow(QBarDataRow row, QString label)
qsizetype addRows(QBarDataArray rows)
qsizetype addRows(QBarDataArray rows, QStringList labels)
qsizetype colCount() const
void insertRow(qsizetype rowIndex, QBarDataRow row)
void insertRow(qsizetype rowIndex, QBarDataRow row, QString label)
void insertRows(qsizetype rowIndex, QBarDataArray rows)
void insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
const QBarDataItem &itemAt(QPoint position) const
const QBarDataItem &itemAt(qsizetype rowIndex, qsizetype columnIndex) const
void removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)
void resetArray()
void resetArray(QBarDataArray newArray)
void resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)
const QBarDataRow &rowAt(qsizetype rowIndex) const
qsizetype rowCount() const
QBar3DSeries *series() const
void setItem(QPoint position, QBarDataItem item)
void setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
void setRow(qsizetype rowIndex, QBarDataRow row)
void setRow(qsizetype rowIndex, QBarDataRow row, QString label)
void setRows(qsizetype rowIndex, QBarDataArray rows)
void setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

シグナル

void arrayReset()
void colCountChanged(qsizetype count)
void itemChanged(qsizetype rowIndex, qsizetype columnIndex)
void rowCountChanged(qsizetype count)
void rowsAdded(qsizetype startIndex, qsizetype count)
void rowsChanged(qsizetype startIndex, qsizetype count)
void rowsInserted(qsizetype startIndex, qsizetype count)
void rowsRemoved(qsizetype startIndex, qsizetype count)
void seriesChanged(QBar3DSeries *series)

詳細説明

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

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

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

QBarDataProxyは、オプションで行ラベルと列ラベルの追跡を保持し、QCategory3DAxis 、軸ラベルの表示に利用できます。

行ラベルと列ラベルは、むしろ系列のデータとは別の配列に格納されます。行処理メソッドはプロキシで利用可能で、行ラベルに影響しない代替バージョンを提供します。これにより、データそのものではなく、配列内のデータの位置に関連する行ラベルを持つオプションが可能になります。系列はデータと行ラベルと列ラベルを保持するので、これらの関数を使用する前に、プロキシに関連付けられた系列を作成する必要があります。

Qt Graphs 3Dによるデータ処理も参照してください

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

[read-only] colCount : const qsizetype

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

アクセス関数:

qsizetype colCount() const

通知シグナル

void colCountChanged(qsizetype count)

[read-only] rowCount : const qsizetype

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

アクセス関数:

qsizetype rowCount() const

通知シグナル

void rowCountChanged(qsizetype count)

[read-only] series : QBar3DSeries* const

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

アクセス関数:

QBar3DSeries *series() const

通知シグナル

void seriesChanged(QBar3DSeries *series)

メンバ関数ドキュメント

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

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

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

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

qsizetype QBarDataProxy::addRow(QBarDataRow row)

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

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

qsizetype QBarDataProxy::addRow(QBarDataRow row, QString label)

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

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

qsizetype QBarDataProxy::addRows(QBarDataArray rows)

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

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

qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)

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

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

[signal] void QBarDataProxy::arrayReset()

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

void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row)

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

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

void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row, QString label)

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

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows)

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

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

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

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

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

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

const QBarDataItem &QBarDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const

rowIndexcolumnIndex で指定された位置にあるアイテムへの参照を返す。 これは、データを変更する次の呼び出しまで有効であることが保証される。

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

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

void QBarDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)

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

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

void QBarDataProxy::resetArray()

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

void QBarDataProxy::resetArray(QBarDataArray newArray)

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

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

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

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

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

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

const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const

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

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

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

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

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

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

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

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

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

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

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

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

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

void QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)

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

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row)

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

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row, QString label)

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

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows)

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

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

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

関連する非会員

[alias] QBarDataArray

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

[alias] 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.