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 軸の単位である。棒グラフの幅の最小値はゼロであり、負の値はゼロとして扱われる。幅をゼロに設定することは、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) |
ノーティファイアシグナル：
| 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
バーシリーズ内のバーセットの数を返す。
注： プロパティ 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 を返します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
