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 |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QBarDataProxyは、Qt Graphs の3D用C++クラスの一部です。
プロパティ
パブリック関数
| 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::QBarDataArray コンテナを介して渡されたすべての QtGraphs::QBarDataRow オブジェクトの所有権を取得します。配列をプロキシに追加した後、バーデータ行ポインタを使用してデータを直接変更する場合は、グラフを更新するために適切なシグナルを発行する必要があります。
QBarDataProxy は、オプションで行および列のラベルを追跡し、QCategory3DAxis はこの情報を用いて軸ラベルを表示することができます。
行ラベルと列ラベルは、シリーズ内のデータとは別の配列に格納されます。プロキシには行処理メソッドが用意されており、行ラベルに影響を与えない代替バージョンも提供されています。これにより、データそのものではなく、配列内のデータの位置に関連付けられた行ラベルを設定することが可能になります。 シリーズにはデータと行ラベルおよび列ラベルが格納されているため、これらの関数を使用する前に、プロキシに関連付けられたシリーズを作成する必要があります。
「Qt Graphs 3D でのデータ処理」も参照してください 。
プロパティのドキュメント
[read-only] colCount : qsizetype
このプロパティは、配列の列数を保持します。
アクセス関数:
| qsizetype | colCount() const |
通知信号:
| void | colCountChanged(qsizetype count) |
[read-only] rowCount : qsizetype
このプロパティは、配列の行数を保持します。
アクセス関数:
| qsizetype | rowCount() const |
通知シグナル:
| void | rowCountChanged(qsizetype count) |
[read-only] series : QBar3DSeries*
このプロパティには、このプロキシが関連付けられているシリーズが格納されます。
アクセス関数:
| 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)
配列の末尾に、labels を持つ新しいrows を追加します。
追加された最初の行のインデックスを返します。
[signal] void QBarDataProxy::arrayReset()
このシグナルは、データ配列がリセットされたときに発せられます。resetArray() を呼び出さずに配列全体の内容を変更した場合、グラフを更新するためにこのシグナルを発する必要があります。
void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row)
新しい行row をrowIndex に挿入します。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加されます。既存の行ラベルには影響しません。
注: 挿入された行より先にラベル付き行が存在する場合、この呼び出しの後、行ラベルの 配列と 行の配列は同期が取れなくなります。
void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row, QString label)
ラベルが `label ` の新しい行 `row ` を `rowIndex` に挿入します。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加されます。
void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows)
新しいrows をrowIndex に挿入します。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加されます。既存の行ラベルには影響しません。
注: 挿入された行の後にラベルが付けられた行が存在する場合、この呼び出しの後、行ラベル配列と 行配列の同期が失われます。
void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
rowIndex に、labels を含む新しいrows を挿入します。rowIndex が配列のサイズと等しい場合、行は配列の末尾に追加されます。
const QBarDataItem &QBarDataProxy::itemAt(QPoint position) const
位置 `position` にある項目への参照を返します。position の x 値は行を、y 値は列を示します。この項目が有効であることは、データを変更する次の呼び出しが行われるまで保証されます。
const QBarDataItem &QBarDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const
rowIndex およびcolumnIndex で指定された位置にある項目の参照を返します。この参照は、データを変更する次の呼び出しが行われるまで有効であることが保証されています。
[signal] void QBarDataProxy::itemChanged(qsizetype rowIndex, qsizetype columnIndex)
このシグナルは、rowIndex およびcolumnIndex で指定された位置にある項目が変更されたときに発せられます。setItem() を呼び出さずに配列内の項目を変更した場合、グラフを更新するためにこのシグナルを発する必要があります。
void QBarDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)
`removeCount ` で指定された行数を、`rowIndex` の位置から削除します。配列の末尾より先の行を削除しようとしても、何もしません。`removeLabels ` が `true` の場合、対応する行ラベルも削除されます。それ以外の場合は、行ラベルには影響しません。
注: removeLabels がfalseの場合 、削除された行より先にラベル付き行が存在すると、行ラベル配列と行配列の同期が崩れます。
void QBarDataProxy::resetArray()
既存の配列および行・列のラベルをクリアします。
void QBarDataProxy::resetArray(QBarDataArray newArray)
配列newArray の所有権を取得します。新しい配列が既存の配列と異なる場合、既存の配列をクリアします。配列が同一の場合、この関数は単にarrayReset()シグナルをトリガーするだけです。
null配列を渡すと、古い配列が削除され、新しい空の配列が作成されます。行および列のラベルには影響しません。
void QBarDataProxy::resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)
配列newArray の所有権を取得します。新しい配列が既存の配列と異なる場合、既存の配列をクリアします。配列が同じ場合は、この関数は単にarrayReset()シグナルをトリガーするだけです。
null配列を渡すと、古い配列が削除され、新しい空の配列が作成されます。
rowLabels およびcolumnLabels のリストは、行と列の新しいラベルを指定します。
const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const
位置rowIndex にある行への参照を返します。この参照は、データを変更する次の呼び出しが行われるまでのみ、有効であることが保証されています。
[signal] void QBarDataProxy::rowsAdded(qsizetype startIndex, qsizetype count)
このシグナルは、`count ` で指定された行数が、位置 `startIndex` から順に追加されたときに発せられます。addRow() またはaddRows() を呼び出さずに配列に行が追加された場合、グラフを更新するためにこのシグナルを発する必要があります。
[signal] void QBarDataProxy::rowsChanged(qsizetype startIndex, qsizetype count)
このシグナルは、`count ` で指定された行数が、位置 `startIndex` から変更された際に発せられます。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 にある1つの項目を、item の項目に変更します。position のx値は行を、y値は列を示します。
void QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
rowIndex およびcolumnIndex で指定された位置にある 1 つの項目を、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 オブジェクトの一覧。
© 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.