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 の3D用C++クラスの一部です。
プロパティ
|
|
パブリック関数
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QCategory3DAxis * | columnAxis() const |
| QStringList | columnLabels() const |
| QStringList | customColumnLabels() const |
| QStringList | customRowLabels() const |
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| QBarDataProxy * | dataProxy() const |
| bool | isValueColoringEnabled() const |
| float | meshAngle() const |
| void | resetColumnAxis() |
| void | resetRowAxis() |
| void | resetValueAxis() |
| QCategory3DAxis * | rowAxis() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | setColumnLabels(const QStringList &labels) |
| void | setCustomColumnLabels(const QStringList &labels) |
| void | setCustomRowLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
| void | setValueAxis(QValue3DAxis *axis) |
| void | setValueColoringEnabled(bool enabled) |
| QValue3DAxis * | valueAxis() const |
シグナル
| void | columnAxisChanged(QCategory3DAxis *axis) |
| void | columnLabelsChanged() |
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowAxisChanged(QCategory3DAxis *axis) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
| void | valueAxisChanged(QValue3DAxis *axis) |
| void | valueColoringEnabledChanged(bool enabled) |
静的パブリックメンバー
| QPoint | invalidSelectionPosition() |
詳細な説明
このクラスは、シリーズ固有の視覚的要素と、シリーズデータ(データプロキシを介して)を管理します。
プロキシとシリーズの関係に関しては、いくつかの重要な点を強調しておくことが不可欠です。 このコンテキストでは、データはシリーズに格納され、ユーザーはシリーズを通じてデータセットにアクセスできます。このシリーズは、プロキシオブジェクトによって制御または表現されます。したがって、プロキシを使用して、データに対するさまざまな操作を管理し、実際のデータセットを更新することができます。ただし、データセットを編集するには、このプロキシに関連付けられたシリーズを作成する必要があります。
シリーズに対してデータプロキシが明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシおよびシリーズに追加されたすべてのデータが破棄されます。
QBar3DSeriesは、QAbstract3DSeries::setItemLabelFormat()に対して以下のフォーマットタグをサポートしています:
| @rowTitle | 行軸からのタイトル |
| @colTitle | 列軸のタイトル |
| @valueTitle | 値軸のタイトル |
| @rowIdx | 表示される行のインデックス。グラフのロケールを使用してローカライズされます。 |
| @colIdx | 表示される列のインデックス。グラフのロケールを使用してローカライズされます。 |
| @rowLabel | 行軸のラベル |
| @colLabel | 列軸のラベル |
| @valueLabel | グラフに紐付けられた値軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::labelFormat を参照してください。 |
| @seriesName | 系列名 |
| %<書式指定> | 指定された形式の項目値。QValue3DAxis::labelFormat と同じルールに基づいて書式設定されます。 |
例:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Qt Graphs 「3D を使用したデータ処理」およびQ3DGraphsWidgetItem::localeも参照してください 。
プロパティのドキュメント
[since 6.11] columnAxis : QCategory3DAxis*
その系列用に追加の縦軸を表示します
注:この 追加の軸は グラフのフィットを調整するものではありませんが、ラベルと軸グリッドを追加で表示できるようになります。
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Notifierシグナル:
| void | columnAxisChanged(QCategory3DAxis *axis) |
columnLabels : QStringList
このプロパティには、配列のオプションの列ラベルが格納されます。
この配列のインデックスは、行の列インデックスと一致します。リストの長さが最も長い行の長さよりも短い場合、すべての列にラベルが付与されるわけではありません。
アクセス関数:
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
通知シグナル:
| void | columnLabelsChanged() |
[since 6.11] customColumnLabels : QStringList
このプロパティには、配列のオプションのカスタム列ラベルが格納されます。
これらのラベルは、プロキシによって生成されたラベルを上書きします。この配列のインデックスは、行の列インデックスと一致します。リストの長さが最長の行よりも短い場合、すべての列にラベルが付与されるわけではありません。
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Notifier シグナル:
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
このプロパティには、配列用のオプションのカスタム行ラベルが格納されます。
これらのラベルは、プロキシによって生成されたラベルよりも優先されます。この配列のインデックスは、データ配列の行インデックスと一致します。リストの要素数が行数より少ない場合、すべての行にラベルが付与されるわけではありません。
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Notifierシグナル:
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
dataArray : QBarDataArray
シリーズ用のデータ配列。
データ配列への参照を保持します。
データ配列が設定された際、newDataArray が前回と同じでない限り、dataArrayChangedシグナルが発信されます。
注: 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」も参照してください 。
[since 6.11] rowAxis : QCategory3DAxis*
その系列用に追加の横軸を設定します
注:この 追加の軸は グラフのフィットを調整するものではありませんが、ラベルと軸グリッドを追加で表示できるようになります。
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Notifier シグナル:
| void | rowAxisChanged(QCategory3DAxis *axis) |
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) |
[since 6.11] valueAxis : QValue3DAxis*
この系列に対して追加の値軸を設定します。軸が指定された場合、その系列は軸の最小値と最大値に合わせて調整されます。
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Notifier シグナル:
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
指定された値を使用して、範囲のグラデーションに基づいて棒グラフ全体を着色します
このプロパティを使用すると、各バーの値と指定された範囲のグラデーションに基づいて、各バーを個別に着色できます。このプロパティを使用するには、QGraphsTheme::ColorStyle をQGraphsTheme::ColorStyle::RangeGradient に設定する必要があります。
この列挙型はQt 6.9で導入されました。
アクセス関数:
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
通知シグナル:
| void | valueColoringEnabledChanged(bool enabled) |
「QGraphsTheme::ColorStyle::RangeGradient」も参照してください 。
メンバ関数のドキュメント
[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()も参照してください 。
© 2026 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.