QAbstractBarSeries Class
QAbstractBarSeries クラスは、すべての棒グラフシリーズクラスの抽象親クラスです。詳細...
| Header: | #include <QAbstractBarSeries> |
| In QML: | AbstractBarSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
| enum | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
プロパティ
|
|
パブリック関数
| virtual | ~QAbstractBarSeries() |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBarSet *set) |
| bool | isLabelsVisible() const |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | remove(QBarSet *set) |
| void | setBarWidth(qreal width) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| bool | take(QBarSet *set) |
シグナル
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | clicked(int index, QBarSet *barset) |
| void | countChanged() |
| void | doubleClicked(int index, QBarSet *barset) |
| void | hovered(bool status, int index, QBarSet *barset) |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged() |
| void | pressed(int index, QBarSet *barset) |
| void | released(int index, QBarSet *barset) |
詳細な説明
棒グラフにおいて、棒は各カテゴリごとに 1 つのデータ値を含む棒セットとして定義されます。棒の位置はカテゴリによって指定され、その高さはデータ値によって決定されます。複数の棒セットを含む棒系列は、同じカテゴリに属する棒をまとめてグループ化します。 棒の表示方法は、棒グラフの作成に選択されたこのクラスのサブクラスによって決まります。
メインの棒グラフ軸に `QBarCategoryAxis ` の代わりに `QValueAxis ` を使用する場合、棒はカテゴリのインデックス値を中心にグループ化されます。
QBarSeries クラスを使用して簡単な棒グラフを作成する方法については、「ウィジェット付きグラフギャラリー」を参照してください。
関連項目： QBarSet 、QBarSeries 、QStackedBarSeries 、QPercentBarSeries 、QHorizontalBarSeries 、QHorizontalStackedBarSeries 、およびQHorizontalPercentBarSeries 。
メンバータイプのドキュメント
enum QAbstractBarSeries::LabelsPosition
この列挙値は、データ値ラベルの位置を表します：
| 定数 | 値 | 説明 |
|---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | ラベルはバーの中央に配置されます。 |
QAbstractBarSeries::LabelsInsideEnd | 1 | ラベルは棒グラフの上部に配置されます。 |
QAbstractBarSeries::LabelsInsideBase | 2 | ラベルはバーの内側、下部に配置されます。 |
QAbstractBarSeries::LabelsOutsideEnd | 3 | ラベルはバーの外側、上部にあります。 |
プロパティのドキュメント
barWidth : qreal
このプロパティは、シリーズの棒グラフの幅を指定します。
幅の単位は x 軸の単位と同じです。棒グラフの最小幅は 0 であり、負の値は 0 として扱われます。幅を 0 に設定すると、x 軸のスケールに関係なく、画面上の棒グラフの幅は 1 ピクセルになります。0 より広い幅の棒グラフは、x 軸のスケールに基づいて拡大・縮小されます。
注： QBarSeries と併用する場合 、この値は個々の棒グラフの幅ではなく、棒グラフのグループ全体の幅を指定します。
アクセス関数：
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
関連項目： QBarSeries 。
[read-only] count : int
このプロパティは、バー系列に含まれるバーセットの数を保持します。
アクセス関数：
| int | count() const |
通知信号：
| void | countChanged() |
labelsAngle : qreal
このプロパティには、値ラベルの角度（度単位）が格納されます。
アクセス関数：
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
通知シグナル:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
このプロパティは、棒グラフの系列でラベルを表示する際に使用される書式を保持します。
QAbstractBarSeries 以下のフォーマットタグをサポートしています:
| @value | 棒グラフの値 |
たとえば、フォーマットタグを次のように使用すると、値の後に単位（u）が続くラベルが表示されます:
series->setLabelsFormat("@value u");デフォルトでは、ラベルには棒グラフの値が表示されます。パーセント棒グラフシリーズの場合、値の後に「%」が追加されます。ラベルはプロット領域に表示されますが、棒グラフが互いに近接している場合、ラベルが重なってしまうことがあります。
アクセス関数：
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
通知シグナル：
| void | labelsFormatChanged(const QString &format) |
関連項目 ：labelsVisible 、labelsPosition 、およびlabelsPrecisionも参照してください 。
labelsPosition : LabelsPosition
このプロパティは、値ラベルの位置を指定します。
アクセス関数：
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
通知シグナル：
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
関連項目: labelsVisible およびlabelsFormat 。
labelsPrecision : int
このプロパティは、値ラベルに表示される有効桁数の最大値を指定します。
デフォルト値は 6 です。
アクセス関数：
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
通知信号：
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
このプロパティは、棒グラフシリーズ内のラベルの表示設定を指定します。
アクセス関数：
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
通知シグナル：
| void | labelsVisibleChanged() |
メンバ関数のドキュメント
[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()
抽象的な棒グラフシリーズと、それが所有する棒グラフセットを削除します。
bool QAbstractBarSeries::append(QBarSet *set)
set で指定されたバーのセットをバー系列に追加し、その所有権を取得します。セットが null である場合、またはすでにその系列に属している場合は、追加されません。追加に成功した場合は、true を返します。
bool QAbstractBarSeries::append(const QList<QBarSet *> &sets)
sets で指定されたバーセットのリストをバー系列に追加し、それらのセットの所有権を取得します。 すべてのセットが正常に追加された場合、true を返します。いずれかのセットがnullであるか、または以前にそのシリーズに追加されていた場合、何も追加されず、この関数はfalse を返します。リスト内に同じセットが複数回含まれている場合、何も追加されず、この関数はfalse を返します。
QList<QBarSet *> QAbstractBarSeries::barSets() const
バー系列に含まれるバーセットのリストを返します。バーセットの所有権は保持されます。
qreal QAbstractBarSeries::barWidth() const
このシリーズの棒グラフの幅を返します。
注： プロパティ barWidthのゲッター関数です 。
関連項目： setBarWidth()。
[signal] void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
このシグナルは、sets で指定されたバーがシリーズに追加されたときに発行されます。
append() およびinsert()も参照してください 。
[signal] void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
このシグナルは、sets で指定されたバーがシリーズから削除されたときに発行されます。
remove()も参照してください 。
void QAbstractBarSeries::clear()
そのシリーズからすべてのバーセットを削除し、完全に消去します。
[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)
このシグナルは、ユーザーが `barset` で指定されたバーセット内の、`index ` で指定されたバーをクリックしたときに発生します。
int QAbstractBarSeries::count() const
バー系列に含まれるバーセットの数を返します。
注： プロパティ「count」のゲッター 関数です。
[signal] void QAbstractBarSeries::countChanged()
このシグナルは、append() やremove() などの呼び出しによって、バーセットの数が変更された際に発生します。
注： プロパティ `count` に対する通知 シグナルです。
[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)
このシグナルは、ユーザーが `barset` で指定されたバーセット内の、`index ` で指定されたバーをダブルクリックしたときに発生します。
[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)
このシグナルは、barset で指定されたバーセット内の、index で指定されたバーにマウスをホバーさせたときに発生します。マウスがバーの上を移動すると、status はtrue に変わり、マウスが再びバーから離れると、false に変わります。
bool QAbstractBarSeries::insert(int index, QBarSet *set)
set で指定されたバーセットを、index で指定された位置にシリーズに挿入し、そのセットの所有権を取得します。セットが null であるか、すでにそのシリーズに属している場合は、挿入されません。挿入に成功した場合は、true を返します。
bool QAbstractBarSeries::isLabelsVisible() const
ラベルの表示状態を取得します。
注： プロパティ `labelsVisible`のゲッター 関数です。
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
このシグナルは、値ラベルのangle が変更されたときに発火します。
注： プロパティ「labelsAngle 」の通知 シグナルです。
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
このシグナルは、データ値ラベルのformat が変更されたときに発火します。
注： プロパティ「labelsFormat 」の通知 シグナルです。
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
このシグナルは、値ラベルのposition が変更されたときに発火します。
注： プロパティ「labelsPosition 」の通知用 シグナルです。
[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)
このシグナルは、値ラベルのprecision が変更されたときに発火します。
注： プロパティ「labelsPrecision 」の通知 シグナルです。
[signal] void QAbstractBarSeries::labelsVisibleChanged()
このシグナルは、ラベルの表示状態が変更されたときに発火します。
注： プロパティ `labelsVisible` に対する通知 シグナルです。
isLabelsVisible() およびsetLabelsVisible()も参照してください 。
[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)
このシグナルは、ユーザーが `barset ` で指定されたバーセット内の、`index ` で指定されたバーをクリックし、マウスボタンを押し続けたときに発生します。
[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)
このシグナルは、barset で指定されたバーセット内の、index で指定されたバー上で、ユーザーがマウスボタンを離したときに発せられます。
bool QAbstractBarSeries::remove(QBarSet *set)
set で指定されたバーセットをシリーズから削除し、削除に成功した場合はそれを完全に削除します。セットが削除された場合は、true を返します。
void QAbstractBarSeries::setBarWidth(qreal width)
シリーズの棒グラフの幅をwidth に設定します。
注： プロパティ `barWidth`のセッター 関数です。
barWidth()も参照してください 。
void QAbstractBarSeries::setLabelsVisible(bool visible = true)
棒グラフシリーズ内のラベルの表示設定を「visible 」に設定します。
注： labelsVisible プロパティのセッター 関数です。
isLabelsVisible()も参照してください 。
bool QAbstractBarSeries::take(QBarSet *set)
シリーズから単一のset を取得します。バーセットオブジェクトは削除されません。
注：シリーズは バーセットの親オブジェクトのままです。完全な所有権を取得するには、親オブジェクトを設定する必要があります。
take操作が成功した場合、true を返します。
© 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.
