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() に対して以下のフォーマットタグをサポートしています：
| @rowTitle | 行軸からのタイトル |
| @colTitle | 列軸のタイトル |
| @valueTitle | 値軸のタイトル |
| @rowIdx | 表示される行のインデックス。グラフのロケールを使用してローカライズされます。 |
| @colIdx | 表示されている列のインデックス。グラフのロケールを使用してローカライズされます。 |
| @rowLabel | 行軸のラベル |
| @colLabel | 列軸のラベル |
| @valueLabel | グラフに紐付けられた値軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::labelFormat を参照してください。 |
| @seriesName | 系列名 |
| %<書式指定> | 指定された形式の項目の値。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) |
通知シグナル:
| 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)
親要素であるparent を使用して、3Dバーシリーズを構築します。
[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()も参照してください 。
© 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.
