QBar3DSeries Class
QBar3DSeriesクラスは、3D棒グラフのデータ系列を表します。詳細...
| Header: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Bar3DSeries |
| Inherits: | 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 Data Handlingおよび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()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
