このページでは

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(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)

静的パブリックメンバー

詳細な説明

このクラスは、シリーズ固有の視覚的要素と、シリーズデータ(データプロキシを介して)を管理します。

プロキシとシリーズの関係に関しては、いくつかの重要な点を強調しておくことが不可欠です。 このコンテキストでは、データはシリーズに格納され、ユーザーはシリーズを通じてデータセットにアクセスできます。このシリーズは、プロキシオブジェクトによって制御または表現されます。したがって、プロキシを使用して、データに対するさまざまな操作を管理し、実際のデータセットを更新することができます。ただし、データセットを編集するには、このプロキシに関連付けられたシリーズを作成する必要があります。

シリーズに対してデータプロキシが明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシおよびシリーズに追加されたすべてのデータが破棄されます。

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.