QBarSeries Class
QBarSeries クラスは、データを棒グラフで表示します。詳細...
| Header: | #include <QBarSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | BarSeries |
| Inherits: | 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
この enum 値は、棒系列の型を記述する：
| 定数 | 値 | 説明 |
|---|---|---|
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 | ラベルは上部のバーの外側に位置する。 |
プロパティ Documentation
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) |
Notifier シグナル：
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *> const
このプロパティは、シリーズに追加されたセットのリストを保持する。
アクセス関数
| QList<QBarSet *> | barSets() const |
Notifier signal: このプロパティは、シリーズに追加されたセットのリストを保持する：
| 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 を参照。
Notifier シグナル：
| 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)
QObject でparent の子である空のバーシリーズを構築します。
[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
バーセット数： バーシリーズ内のバーセット数を返します。
注： この関数は、メタオブジェクトシステム経由でも、QML からも呼び出すことができます。Q_INVOKABLE を参照。
注： プロパティカウントのゲッター関数。
[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
QAbstractSeries::type を参照してください。
バーシリーズを返します。
[signal] void QBarSeries::updatedBars()
このシグナルは、バーが更新されたときに発せられます。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
