QBar3DSeries Class
QBar3DSeriesクラスは、3D棒グラフのデータ系列を表します。詳細...
| ヘッダー | #include <QBar3DSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| QML で | Bar3DSeries |
| 継承： | QAbstract3DSeries |
- 継承メンバを含む全メンバのリスト
- QBar3DSeries はQt Graphs C++ Classes for 3D に含まれます。
プロパティ
|
|
パブリック機能
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QStringList | columnLabels() const |
| QBarDataArray | dataArray() && |
| const QBarDataArray & | dataArray() const & |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
シグナル
| void | columnLabelsChanged() |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
静的パブリックメンバ
| QPoint | invalidSelectionPosition() |
詳細説明
このクラスは、シリーズ固有のビジュアル要素と、（データプロキシを介した）シリーズデータを管理します。
プロキシとシリーズの関係については、いくつかの重要なポイントを強調することが重要です。このコンテキストでは、データは系列に格納され、ユーザは系列を通してデータセットにアクセスできる。この系列はプロキシオブジェクトによって制御または表現される。したがって、このプロキシを使って、データに対する様々な操作を管理し、実際のデータセットを更新することができる。ただし、データセットを編集するには、このプロキシに関連付けられた系列を作成する必要がある。
シリーズに明示的にデータプロキシが設定されていない場合、シリーズはデフォルトのプロキシを作成する。別のプロキシを設定すると、既存のプロキシとシリーズに追加されたすべてのデータが破棄されます。
QBar3DSeries はQAbstract3DSeries::setItemLabelFormat() で以下のフォーマットタグをサポートしています：
| 行タイトル | 行軸からのタイトル |
| colTitle | 列軸からのタイトル |
| 値軸からのタイトル | 値軸からのタイトル |
| 行インデックス | 可視行インデックス。グラフロケールでローカライズ。 |
| colIdx | 可視の列インデックス。グラフロケールを使用してローカライズされます。 |
| 行ラベル | 行軸のラベル。 |
| colLabel | 列軸のラベル |
| 値ラベル | グラフに付属する値軸の書式を使用してフォーマットされた項目値。詳細については、QValue3DAxis::labelFormat を参照してください。 |
| シリーズ名 | 系列の名前。 |
| <フォーマット仕様 | 指定された形式での項目値。QValue3DAxis::labelFormat と同じルールを使用してフォーマットされます。 |
例えば、以下のようになります：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Graphs 3Dによるデータ処理およびQ3DGraphsWidgetItem::localeも参照してください 。
プロパティ・ドキュメンテーション
columnLabels : QStringList
このプロパティは、配列のオプションの列ラベルを保持する。
この配列のインデックスは、行の列インデックスと一致する。リストが最長の行よりも短い場合、すべての列はラベルを取得しません。
アクセス関数：
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
通知シグナル：
| void | columnLabelsChanged() |
dataArray : QBarDataArray
シリーズのデータ配列。
データ配列の参照を保持する。
dataArrayChanged シグナルは、データ配列が設定されたときに発行される。ただし、newDataArray が前のものと同一である場合を除く。
注： dataArrayに関して何かを行う前に、関連するプロキシに対してシリーズを作成する必要があります。
アクセス関数：
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
通知シグナル：
| void | dataArrayChanged(const QBarDataArray &array) |
clearRow(qsizetype rowIndex) およびclearArray()も参照のこと 。
dataProxy : QBarDataProxy*
このプロパティは、アクティブなデータプロキシを保持する。
この系列は、その系列に設定されているプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されていたプロキシは削除される。プロキシをNULLにしたり、他の系列に設定したりすることはできません。
アクセス関数：
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
通知シグナル：
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
このプロパティは、一連の回転角度を度単位で保持する。
このプロパティを設定することは、以下の呼び出しと等価である：
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
注： このプロパティを読み込む場合、浮動小数点精度を使用してQAbstract3DSeries::meshRotation の値から計算され、常に 0 度から 360 度までの値が返される。
アクセス関数：
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
ノーティファイアシグナル：
| void | meshAngleChanged(float angle) |
QAbstract3DSeries::meshRotationも参照のこと 。
rowColors : QList<QColor>
このプロパティは、シリーズの行の色のリストを保持する。
このプロパティを使用して、シリーズの行を異なる色で着色することができる。このプロパティを使用するには、QGraphsTheme::ColorStyle をQGraphsTheme::ColorStyle::Uniform に設定する必要があります。
アクセス関数：
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
通知シグナル：
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
QGraphsTheme::ColorStyle::Uniformも参照のこと 。
rowLabels : QStringList
このプロパティは、配列のオプションの行ラベルを保持する。
この配列のインデックスは、データ配列の行インデックスと一致する。リストが行数より短い場合は、すべての行にラベルが付与されません。
アクセス関数：
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
通知シグナル：
| void | rowLabelsChanged() |
selectedBar : QPoint
このプロパティは、選択されているシリーズ内のバーを保持する。
アクセス関数：
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
通知シグナル：
| void | selectedBarChanged(QPoint position) |
メンバ関数ドキュメント
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
parent を親とする棒 3D 系列を構築する。
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent を用いて棒グラフの 3D 系列を構築します。
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
バー3Dシリーズを削除する。
void QBar3DSeries::clearArray()
既存の配列をクリアする。
void QBar3DSeries::clearRow(qsizetype rowIndex)
与えられたrowIndex に従って、配列の既存の行をクリアします。
[static] QPoint QBar3DSeries::invalidSelectionPosition()
無効な選択位置を返す。この位置はselectedBar プロパティに設定され、このシリーズからの選択をクリアします。
Q3DGraphsWidgetItem::clearSelection()も参照してください 。
void QBar3DSeries::setSelectedBar(QPoint position)
position の位置にあるバーを選択します。この位置は、系列データ配列の行と列で指定します。
一度に選択できるバーは1つだけである。
この系列から選択を解除するには、invalidSelectionPosition() をposition とする。
この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、または無効となった場合に選択を調整することができる。追加された別の系列のバーを選択すると、選択範囲もクリアされる。
選択されたバーの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じバーが選択されたままになるように選択が調整される。
注： selectedBar プロパティのセッター関数。
selectedBar() およびQ3DGraphsWidgetItem::clearSelection()も参照 。
© 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.
