QBarDataProxy Class

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

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

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

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