QBarSeries Class
QBarSeries クラスは、データを棒グラフで表示します。詳細...
| ヘッダー | #include <QBarSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| QML で | BarSeries |
| 継承： | QAbstractSeries |
- 継承メンバを含む全メンバのリスト
- QBarSeries はQt Graphs C++ Classes for 2D に含まれます。
パブリックタイプ
| enum class | BarsType { Groups, Stacked, StackedPercent } |
| enum class | LabelsPosition { Center, InsideEnd, InsideBase, OutsideEnd } |
プロパティ
|
|
パブリック関数
| QBarSeries(QObject *parent = nullptr) | |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QBarSet * | at(qsizetype index) |
| QQmlComponent * | barDelegate() const |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| QBarSeries::BarsType | barsType() const |
| QList<QColor> | borderColors() const |
| void | clear() |
| qsizetype | count() const |
| qsizetype | find(QBarSet *set) const |
| bool | insert(qsizetype index, QBarSet *set) |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| qreal | labelsMargin() const |
| QBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | labelsVisible() const |
| bool | remove(QBarSet *set) |
| bool | remove(qsizetype index) |
| void | removeMultiple(qsizetype index, qsizetype count) |
| bool | replace(const QList<QBarSet *> &sets) |
| bool | replace(QBarSet *oldValue, QBarSet *newValue) |
| void | replace(qsizetype index, QBarSet *set) |
| QList<QColor> | seriesColors() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
| void | setBarWidth(qreal width) |
| void | setBarsType(QBarSeries::BarsType type) |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsMargin(qreal margin) |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
| bool | take(QBarSet *set) |
再実装パブリック関数
| virtual QAbstractSeries::SeriesType | type() const override |
シグナル
| void | barDelegateChanged() |
| void | barSetsChanged() |
| void | barWidthChanged() |
| void | barsTypeChanged(QBarSeries::BarsType type) |
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | borderColorsChanged() |
| void | countChanged() |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsMarginChanged(qreal margin) |
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged(bool visible) |
| void | seriesColorsChanged() |
| void | setValueAdded(qsizetype index, qsizetype count, QBarSet *barset) |
| void | setValueChanged(qsizetype index, QBarSet *barset) |
| void | setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset) |
| void | updatedBars() |
詳細説明
このクラスは、デフォルトでは、カテゴリごとにグループ化された一連のバーとしてデータを描画し、各バーセットからカテゴリごとに1つのバーがシリーズに追加されます。また、横棒や積み重ね棒のグループ化もサポートします。
棒グラフの系列には、GraphsView x 軸をBarCategoryAxis に設定し、y 軸をValueAxis に設定する必要がある。
QBarSet およびQAbstractSeriesも参照のこと 。
メンバ型ドキュメント
enum class QBarSeries::BarsType
この列挙値は、棒系列のタイプを記述する：
| 定数 | 値 | 説明 |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | 棒グラフはカテゴリごとにグループ化される。 |
QBarSeries::BarsType::Stacked | 1 | 棒グラフは、カテゴリー別に積み重ねられる。 |
QBarSeries::BarsType::StackedPercent | 2 | バー・セットは、カテゴリーごとに互いに積み重ねられる。セグメント・サイズは、スタック内のすべてのセグメントの合計値と比較したセグメント値のパーセンテージに対応します。 |
enum class QBarSeries::LabelsPosition
この列挙値は、データ値ラベルの位置を記述する：
| 定数 | 値 | 説明 |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | ラベルはバーの中央に位置する。 |
QBarSeries::LabelsPosition::InsideEnd | 1 | ラベルは上部のバーの内側にある。 |
QBarSeries::LabelsPosition::InsideBase | 2 | ラベルが下のバーの内側にある。 |
QBarSeries::LabelsPosition::OutsideEnd | 3 | ラベルは上部のバーの外側に位置する。 |
プロパティの説明
barDelegate : QQmlComponent*
このプロパティは、各バーを視覚化するために使用されるカスタム QML コンポーネントを保持します。このコンポーネントのインスタンスは、各バーごとに作成されます。このコンポーネントが定義されていない場合、小節の視覚化にはデフォルトの矩形が使用されます。
このコンポーネントで使用可能な動的プロパティは以下のとおりです：
| タイプ | 名前 | 説明 |
|---|---|---|
| QColor | バーの色 | バーの塗りつぶし色。この値はQGraphsTheme から、またはQBarSet が色を上書きする場合はQBarSet::color から取得します。 |
| QColor | バー境界色 | バーのボーダーの色。この値はQGraphsTheme またはQBarSet が色を上書きする場合はQBarSet::borderColor から取得します。 |
| qreal | barBorderWidth | バーの境界線の幅。この値はQGraphsTheme またはQBarSet が幅を上書きする場合はQBarSet::borderWidth から取得します。 |
| qreal | バー値 | バーの値。この値はQBarSet::values から取得します。 |
| QString | barLabel | バーのラベル。この値はQBarSet::label に由来します。 |
| ブール | barSelected | この値は、バーが選択されているとき、つまりバーのインデックスがQBarSet::selectedBars にあるときに真になります。 |
これらのいずれかを使用するには、定義された名前のプロパティをカスタム・コンポーネントに追加します。例えば、"property color barColor" や"property real barValue" などです。
アクセス関数：
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
ノーティファイア・シグナル：
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *> const
このプロパティは、シリーズに追加されたセットのリストを保持する。
アクセス関数：
| QList<QBarSet *> | barSets() const |
通知シグナル
| void | barSetsChanged() |
barWidth : qreal
このプロパティは、系列のバーの幅を保持する。
幅の単位はx軸の単位である。棒グラフの幅の最小値は0であり、負の値は0として扱われる。幅をゼロに設定することは、x軸のスケールに関係なく、画面上のバーの幅が1ピクセルであることを意味する。ゼロより幅の広いバーは、x 軸のスケールを使用してスケーリングされます。
デフォルトでは、barWidthは0.5です（バーは利用可能な幅の50％を占めます）。有効な値の範囲は、0.0 (0%) から 1.0 (100%) です。
注： QBarSeries と併用する場合、この値は、単一のバーの幅ではなく、バーのグループの幅を指定する。
アクセス関数：
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
Notifier シグナル：
| void | barWidthChanged() |
QBarSeriesも参照のこと 。
barsType : BarsType
このプロパティは、棒系列のタイプを保持する。
アクセス関数：
| QBarSeries::BarsType | barsType() const |
| void | setBarsType(QBarSeries::BarsType type) |
通知シグナル
| void | barsTypeChanged(QBarSeries::BarsType type) |
borderColors : QList<QColor>
このプロパティは、シリーズ内のすべてのオブジェクトに使用されるボーダーカラーのリストを保持する。
シリーズが色より多い場合、色リストは折り返され、リストの最初の色から再スタートします。これが設定されていない場合 (デフォルト)、QGraphsTheme::borderColors の色が使用されます。
アクセス関数：
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
通知シグナル：
| void | borderColorsChanged() |
[read-only] count : const qsizetype
このプロパティは、バーシリーズ内のバーセットの数を保持する。
アクセス関数：
| qsizetype | count() const | [see note below] |
注： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照。
通知シグナル：
| void | countChanged() |
labelsAngle : qreal
このプロパティは、値ラベルの角度を度単位で保持する。
アクセス関数
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
通知シグナル
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
このプロパティは、棒系列でラベルを表示するために使用されるフォーマットを保持する。
QBarSeries は以下のフォーマットタグをサポートしています：
| 値 | 棒グラフの値 |
例えば、以下のフォーマット・タグの使用法は、値の後に単位(u)を表示するラベルを作成する：
series->setLabelsFormat("@value u");
デフォルトでは、ラベルには棒の値が表示される。パーセント棒系列では、値の後に% が追加される。ラベルはプロット・エリアに表示されるが、棒グラフが近接している場合はラベルが重なることがある。
アクセス機能：
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
通知シグナル：
| void | labelsFormatChanged(const QString &format) |
labelsVisible 、labelsPosition 、labelsPrecisionも参照の こと。
labelsMargin : qreal
このプロパティは、値ラベルのマージンをピクセル単位で保持する。
この横からのマージンは、labelsPosition がLabelsPosition.Center 以外に設定されている場合に使用されます。 デフォルト値は0 です。
アクセス関数：
| qreal | labelsMargin() const |
| void | setLabelsMargin(qreal margin) |
通知シグナル：
| void | labelsMarginChanged(qreal margin) |
labelsPosition : LabelsPosition
このプロパティは、値ラベルの位置を保持する。
アクセス関数
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
ノーティファイア・シグナル：
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
labelsVisible およびlabelsFormatも参照のこと 。
labelsPrecision : int
このプロパティは、値ラベルに表示される最大有効桁数を保持する。
デフォルト値は6である。
アクセス関数：
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
通知シグナル：
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
このプロパティは、棒系列内のラベルの可視性を保持する。デフォルトのラベルの可視性はfalse です。
アクセス関数：
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
通知シグナル：
| void | labelsVisibleChanged(bool visible) |
seriesColors : QList<QColor>
このプロパティは、シリーズ内のすべてのオブジェクトに使用される基本色のリストを保持します。
シリーズが色よりも多い場合、色リストは折り返され、リストの最初の色から再スタートします。これが設定されていない場合 (デフォルト)、QGraphsTheme::seriesColors の色が使用されます。
アクセス関数：
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
通知シグナル：
| void | seriesColorsChanged() |
メンバ関数ドキュメント
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
parent の子であり、QObject である空のバー・シリーズを構築する。
[invokable] bool QBarSeries::append(QBarSet *set)
set で指定されたバーのセットをバーシリーズに追加し、その所有権を取得します。セットがNULLであるか、すでにシリーズに属している場合は、追加されません。追加に成功した場合はtrue を返す。
注： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
sets で指定されたバー・セットのリストをバー・シリーズに追加し、セットの所有権を取得する。すべてのセットが正常に追加された場合、true を返す。セットのいずれかがNULLであるか、以前にシリーズに追加されていた場合、何も追加されず、この関数はfalse を返す。セットのいずれかがリストに複数回表示された場合、何も追加されず、この関数はfalse を返す。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QBarSet *QBarSeries::at(qsizetype index)
index の位置で指定されたBarSet を取得する。BarSet が見つからない場合は null を返す。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QList<QBarSet *> QBarSeries::barSets() const
バー・シリーズ内のバー・セットのリストを返します。バー セットの所有権を保持します。
注: プロパティ barSets のゲッター関数です。
qreal QBarSeries::barWidth() const
シリーズのバーの幅を返します。
注： プロパティ barWidth のゲッター関数。
setBarWidth()も参照 。
[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
このシグナルは、sets で指定されたバー・セットがシリーズに追加されたときに発せられる。
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
このシグナルは、sets で指定されたバーセットがシリーズから削除されたときに発せられる。
remove()も参照のこと 。
[invokable] void QBarSeries::clear()
シリーズからすべてのバーセットを削除し、それらを永久に削除する。
注： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] qsizetype QBarSeries::count() const
bar set number of bar sets in a bar series：棒グラフのセット数を返します。
注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照。
注： プロパティ count のゲッター関数。
[invokable] qsizetype QBarSeries::find(QBarSet *set) const
set で定義されているように、最初に見つかったBarSet のインデックスを返す。BarSet が見つからなかった場合は -1 を返す。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
index で指定された位置のシリーズに、set で指定されたバーセットを挿入し、セットの所有権を取得します。セットがNULLであるか、すでにシリーズに属している場合は、追加されません。挿入に成功した場合、true を返す。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
bool QBarSeries::labelsVisible() const
ラベルの可視性を返す。
注： プロパティ labelsVisible のゲッター関数。
setLabelsVisible()も参照してください 。
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
このシグナルは、ラベルの可視性がvisible に変更されたときに発行される。
注： labelsVisible プロパティのノーティファイア・シグナル。
labelsVisible() およびsetLabelsVisible()も参照してください 。
[invokable] bool QBarSeries::remove(QBarSet *set)
set で指定されたバーセットをシリーズから削除し、削除に成功した場合は永久に削除する。セットが削除された場合はtrue を返す。
注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QBarSeries::remove(qsizetype index)
index にあるBarSet を削除する。BarSet は永久に削除されます。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
index からcount の数まで、シリーズから複数の BarSets を削除します。 BarSets は永久に削除されます。
注： この関数は、メタ・オブジェクト・システムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
このBarSeries 内のBarSet リスト全体を、sets で指定された BarSets で置き換えます。元の BarSets はすべて永久に削除されます。すべての BarSets が置換された場合、true を返します。
注意： この関数は、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
oldValue で指定されたBarSet をnewValue のものと置き換える。oldValue 内のBarSet は、シリーズ内で見つかった場合、永久に削除されます。置換が成功した場合、true を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
index に存在するBarSet をset で置き換える。元のBarSet は永久に削除されます。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
void QBarSeries::setBarWidth(qreal width)
シリーズのバーの幅をwidth に設定する。
注： barWidth プロパティのセッター関数。
barWidth()も参照 。
void QBarSeries::setLabelsVisible(bool visible = true)
バーシリーズのラベルの可視性をvisible に設定します。
注: プロパティのセッター関数labelsVisible 。
labelsVisible()も参照 。
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
このシグナルは、バーセットの値が変更されたときに発せられる。index は、シリーズ内のバーセットのインデックス。追加された値の番号はcount である。barset は、変更されたセットへのポインタである。
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
このシグナルは、バーセットの値が変更されたときに発せられる。index は、シリーズ内のバーセットのインデックス。barset は変更されたセットへのポインタ。
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
このシグナルは、バーセットの値が変更されたときに発せられる。index は、シリーズ内のバーセットのインデックス。削除された値の数はcount である。barset は、変更されたセットへのポインタである。
[invokable] bool QBarSeries::take(QBarSet *set)
シリーズからシングルset 。バーセットオブジェクトは削除しません。
注意: シリーズはバーセットの親オブジェクトのままです。完全な所有権を取得するには、親オブジェクトを設定する必要があります。
take 操作が成功した場合、true を返します。
注意 : この関数は、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
バー系列を返します。
[signal] void QBarSeries::updatedBars()
このシグナルはバーが更新されたときに発せられる。
© 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.
