QAbstractBarSeries Class
QAbstractBarSeries クラスは、すべての棒系列クラスの抽象親クラスです。詳細...
| Header: | #include <QAbstractBarSeries> |
| In QML: | AbstractBarSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries |
パブリック型
| 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として扱われる。幅をゼロに設定することは、x軸のスケールに関係なく、画面上のバーの幅が1ピクセルであることを意味する。ゼロより幅の広いバーは、x軸のスケールを使用して拡大縮小される。
注： QBarSeries と共に使用する場合、この値は、単一のバーの幅ではなく、バーのグループの幅を指定する。
アクセス関数：
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
QBarSeriesも参照のこと 。
[read-only] count : const int
このプロパティは、バーシリーズ内のバーセットの数を保持する。
アクセス関数：
| int | count() const |
通知シグナル：
| void | countChanged() |
labelsAngle : qreal
このプロパティは、値ラベルの角度を度単位で保持する。
アクセス関数
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
通知シグナル
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
このプロパティは、棒系列でラベルを表示するために使用されるフォーマットを保持する。
QAbstractBarSeries は以下のフォーマットタグをサポートしています：
| 値 | 棒グラフの値 |
例えば、以下のフォーマット・タグの使用法は、値の後に単位(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) |
Notifier シグナル：
| 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 で指定されたバー・セットがシリーズに追加されたときに発せられる。
[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
barSet関数は、バーシリーズ内のバーセットの数を返します。
注： プロパティ 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)
index で指定された位置のシリーズに、set で指定されたバーセットを挿入し、セットの所有権を取得します。セットが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 を返します。
© 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.
