QBar3DSeries Class
QBar3DSeriesクラスは、3D棒グラフのデータ系列を表します。詳細...
| ヘッダー | #include <QBar3DSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake： | QT += datavisualization |
| 以来： | QtDataVisualization 1.0 |
| QML で： | Bar3DSeries |
| 継承： | QAbstract3DSeries |
プロパティ
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
パブリック機能
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
シグナル
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
静的パブリックメンバ
| QPoint | invalidSelectionPosition() |
詳細説明
このクラスは、シリーズ固有のビジュアルエレメントと（データプロキシを介した）シリーズデータを管理します。
データプロキシがシリーズに対して明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシとそれに追加されたすべてのデータが破棄されます。
QBar3DSeries は、QAbstract3DSeries::setItemLabelFormat() で以下のフォーマットタグをサポートしています：
| 行タイトル | 行軸からのタイトル |
| colTitle | 列軸からのタイトル |
| 値軸からのタイトル | 値軸からのタイトル |
| 行インデックス | 可視行インデックス。グラフロケールでローカライズ。 |
| colIdx | 可視の列インデックス。グラフロケールを使用してローカライズされます。 |
| 行ラベル | 行軸のラベル。 |
| colLabel | 列軸のラベル |
| 値ラベル | グラフに付属する値軸の書式を使用してフォーマットされた項目値。詳細については、QValue3DAxis::labelFormat を参照してください。 |
| シリーズ名 | 系列の名前。 |
| <フォーマット仕様 | 指定された形式での項目値。QValue3DAxis::labelFormat と同じルールを使用してフォーマットされます。 |
例えば、以下のようになります：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Data Visualization データ処理およびQAbstract3DGraph::localeも参照してください 。
プロパティ・ドキュメンテーション
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も参照のこと 。
[since 6.3] rowColors : QList<QColor>
このプロパティは、シリーズの行の色のリストを保持する。
このプロパティを使用して、シリーズの行を異なる色で着色することができる。このプロパティを使用するには、Q3DTheme::ColorStyle をQ3DTheme::ColorStyleUniform に設定する必要があります。
このプロパティは Qt 6.3 で導入されました。
アクセス関数です：
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Notifier シグナル：
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Q3DTheme::ColorStyleUniformも参照してください 。
selectedBar : QPoint
このプロパティは、選択されているシリーズ内のバーを保持する。
アクセス関数：
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
通知シグナル：
| void | selectedBarChanged(const QPoint &position) |
メンバ関数ドキュメント
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
バー3Dシリーズを親parent 。
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent を用いて棒グラフの 3D 系列を構築します。
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
バー3Dシリーズを削除する。
[static] QPoint QBar3DSeries::invalidSelectionPosition()
無効な選択位置を返す。この位置はselectedBar プロパティに設定され、このシリーズからの選択をクリアします。
QAbstract3DGraph::clearSelection()も参照してください 。
void QBar3DSeries::setSelectedBar(const QPoint &position)
position の位置にあるバーを選択します。この位置は、系列データ配列の行と列で指定します。
一度に選択できるバーは1つだけである。
この系列から選択を解除するには、invalidSelectionPosition() をposition とする。
この系列がグラフに追加された場合、グラフはユーザーとの対話に応じて、または無効となった場合に選択を調整することができる。追加された別の系列のバーを選択すると、選択範囲もクリアされる。
選択されたバーの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じバーが選択されたままになるように選択が調整される。
注： selectedBar プロパティのセッター関数。
selectedBar() およびQAbstract3DGraph::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.
