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: |
プロパティ
- columnLabels : QStringList
- rowCount : const int
- rowLabels : QStringList
- series : QBar3DSeries* const
パブリック関数
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)
新しいrows をlabels とともに配列の末尾に追加する。
最初に追加された行のインデックスを返します。
const QBarDataArray *QBarDataProxy::array() const
データ配列へのポインタを返します。
[signal]
void QBarDataProxy::arrayReset()
このシグナルは、データ配列がリセットされたときに発せられる。resetArray()を呼び出さずに配列全体の内容が変更された場合、グラフを更新するためにこのシグナルを発する必要がある。
void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)
新しい行row をrowIndex に挿入する。rowIndex が配列サイズと等しい場合、行は配列の末尾に追加される。既存の行ラベルは影響を受けない。
注意: 挿入された行の先にラベルが付けられた行がある場合、この呼び出しの後、行ラベル配列は行配列と同期しなくなります。
void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row, const QString &label)
label のラベルを持つ新しい行row をrowIndex に挿入する。rowIndex が配列サイズと等しい場合、行は配列の末尾に追加される。
void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows)
新しいrows をrowIndex に挿入する。rowIndex が配列サイズと等しい場合、行は配列の最後に追加される。既存の行ラベルは影響を受けない。
注意: 挿入された行の先にラベルが付けられた行がある場合、この呼び出しの後、行ラベル配列は行配列と同期しなくなります。
void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
labels を持つ新しいrows をrowIndex に挿入する。rowIndex が配列サイズと等しい場合、その行は配列の最後に追加される。
const QBarDataItem *QBarDataProxy::itemAt(const QPoint &position) const
position の位置にある項目へのポインタを返す。position の x 値は行を表し、y 値は列を表す。この項目は、データを変更する次の呼び出しまで有効であることが保証される。
const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const
rowIndex とcolumnIndex で指定された位置にある項目へのポインタを返す。 この項目は、データを変更する次の呼び出しまで有効であることが保証される。
[signal]
void QBarDataProxy::itemChanged(int rowIndex, int columnIndex)
このシグナルは、rowIndex とcolumnIndex で指定された位置の項目が変更されたときに発せられる。setItem() を呼び出さずに配列内の項目が変更された場合、グラフを更新するためにこのシグナルを発する必要がある。
void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)
rowIndex の位置から、removeCount で指定された行数を削除する。配列の末尾を越えて行を削除しようとしても何もしない。removeLabels がtrue
の場合、対応する行ラベルも削除される。そうでない場合、行ラベルは影響を受けない。
注意: removeLabels がfalse
の場合、削除された行の先にラベルの付いた行があると、行ラベルの配列は行配列と同期しなくなります。
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 配列を渡すと、古い配列は削除され、新しい空の配列が作成されます。
rowLabels とcolumnLabels のリストは、行と列の新しいラベルを指定する。
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)
rowIndex とcolumnIndex で指定された位置にある単一の項目を、項目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 に格納されている既存の行と同じにすることができます。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。