QAreaSeries Class

QAreaSeries クラスは、データをエリア・チャートで表示します。詳細...

Header: #include <QAreaSeries>
In QML: AreaSeries
Inherits: QAbstractSeries

プロパティ

パブリック関数

QAreaSeries(QObject *parent = nullptr)
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
virtual ~QAreaSeries()
QColor borderColor() const
QBrush brush() const
QColor color() const
QLineSeries *lowerSeries() const
QPen pen() const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
bool pointsVisible() const
void setBorderColor(const QColor &color)
void setBrush(const QBrush &brush)
void setColor(const QColor &color)
void setLowerSeries(QLineSeries *series)
void setPen(const QPen &pen)
void setPointLabelsClipping(bool enabled = true)
void setPointLabelsColor(const QColor &color)
void setPointLabelsFont(const QFont &font)
void setPointLabelsFormat(const QString &format)
void setPointLabelsVisible(bool visible = true)
void setPointsVisible(bool visible = true)
void setUpperSeries(QLineSeries *series)
QLineSeries *upperSeries() const

再実装パブリック関数

virtual QAbstractSeries::SeriesType type() const override

シグナル

void borderColorChanged(QColor color)
void clicked(const QPointF &point)
void colorChanged(QColor color)
void doubleClicked(const QPointF &point)
void hovered(const QPointF &point, bool state)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)
void pressed(const QPointF &point)
void released(const QPointF &point)

詳細説明

面積系列は定量的なデータを表示するために使用されます。境界線間の領域を色で強調するという点で、線分系列をベースにしています。面積系列は線系列に基づいているので、QAreaSeriesコンストラクタは、面積の上限を定義するQLineSeries インスタンスを必要とします。エリア・チャートは、デフォルトでは、プロット・エリアの底を下界として描画されます。プロットエリアの底辺の代わりに、別の線で下界を指定することもできる。その場合、QAreaSeriesは2つのQLineSeries インスタンスで初期化されなければならない。

注意: 境界と下境界という用語は、下境界の値が上境界の値よりも大きい場合に誤解を招くことがある。重要なのは、この2つの境界線の間の領域が塗りつぶされるということです。

簡単なエリア・チャートの作成方法については、ウィジェットを使ったチャート・ギャラリーを参照してください。

プロパティのドキュメント

borderColor : QColor

このプロパティは、シリーズの線(ペン)の色を保持する。ペンの色を変更するための便利なプロパティです。

アクセス関数

QColor borderColor() const
void setBorderColor(const QColor &color)

通知シグナル:

void borderColorChanged(QColor color)

QAreaSeries::pen()も参照

color : QColor

このプロパティは、シリーズの塗りつぶし(ブラシ)の色を保持する。これはブラシの色を変更するための便利なプロパティである。

アクセス関数

QColor color() const
void setColor(const QColor &color)

通知シグナル:

void colorChanged(QColor color)

QAreaSeries::brush()も参照

[read-only] lowerSeries : QLineSeries* const

このプロパティは、領域系列の境界を定義するために使用される 2 つの線系列のうち、下位の 1 つを保持する。

注: QAreaSeries が lowerSeries なしで構築された場合、これは null となる。

アクセス関数:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

このプロパティは、データ・ポイント・ラベルのクリッピングを保持する。デフォルトではTrue。クリッピングが有効な場合、プロット領域の端のラベルはカットされます。

アクセス関数

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

通知シグナル:

void pointLabelsClippingChanged(bool clipping)

pointLabelsVisibleも参照してください

pointLabelsColor : QColor

このプロパティは、データポイントのラベルに使用される色を保持する。デフォルトでは、この色はテーマでラベル用に定義されたブラシの色である。

アクセス関数:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

通知シグナル:

void pointLabelsColorChanged(const QColor &color)

QAreaSeries::pointLabelsFormatも参照してください

pointLabelsFont : QFont

このプロパティは、データポイントのラベルに使用されるフォントを保持する。

アクセス関数:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

ノーティファイア・シグナル:

void pointLabelsFontChanged(const QFont &font)

QAreaSeries::pointLabelsFormatも参照

pointLabelsFormat : QString

このプロパティは、系列ポイントを持つラベルを表示するために使用されるフォーマットを保持する。

QAreaSeries は以下のフォーマットタグをサポートしている:

xPointデータポイントのx値
yPointデータ・ポイントのy値

例えば、次のような書式タグの使い方をすると、データ点 (x, y) がカンマで区切られた括弧の中に表示されるラベルが作成される:

series->setPointLabelsFormat("(@xPoint, @yPoint)");

デフォルトでは、ラベルの書式は@xPoint, @yPoint に設定されている。ラベルはプロット領域に表示されるが、プロット領域の端にあるラベルはカットされる。点同士が近い場合、ラベルが重なることがある。

アクセス機能

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

通知シグナル:

void pointLabelsFormatChanged(const QString &format)

QAreaSeries::pointLabelsVisible,QAreaSeries::pointLabelsFont,QAreaSeries::pointLabelsColorも参照のこと

pointLabelsVisible : bool

このプロパティは、データ・ポイント・ラベルの可視性を保持する。デフォルトでは False。

アクセス関数:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Notifier シグナル:

void pointLabelsVisibilityChanged(bool visible)

QAreaSeries::pointLabelsFormat およびQAreaSeries::pointLabelsClippingも参照

[read-only] upperSeries : QLineSeries* const

このプロパティは、領域系列の境界を定義するために使用される 2 つの線系列のうち、上位の 1 つを保持する。

アクセス関数

QLineSeries *upperSeries() const

メンバ関数ドキュメント

[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)

parent オブジェクトを用いて、上下の系列を持たない領域系列オブジェクトを構築する。

[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)

upperSeries 行とlowerSeries 行の間にまたがる領域系列オブジェクトを構築する。コンストラクタにlowerSeries が渡されない場合、代わりに x 軸が下界として使用されます。

QAreaSeriesは上下の系列を所有しませんが、所有権は呼び出し側にあります。系列オブジェクトがQChartView またはQChart に追加されると、インスタンスの所有権は移譲される。

[virtual noexcept] QAreaSeries::~QAreaSeries()

オブジェクトを破壊する。

[signal] void QAreaSeries::borderColorChanged(QColor color)

このシグナルは、線(ペン)の色がcolor に変わったときに発せられる。

注: プロパティborderColor に対するノーティファイア・シグナル。

QBrush QAreaSeries::brush() const

このシリーズの線を描画するために使用されるブラシを返します。

setBrush()も参照

[signal] void QAreaSeries::clicked(const QPointF &point)

このシグナルは、ユーザーがエリアチャートでpoint をクリックし、その押下をトリガーしたときに発せられる。

pressedreleaseddoubleClickedも参照

[signal] void QAreaSeries::colorChanged(QColor color)

このシグナルは、塗りつぶし(ブラシ)の色がcolor に変わったときに発せられる。

注: プロパティの通知シグナルcolor

[signal] void QAreaSeries::doubleClicked(const QPointF &point)

このシグナルは、point をダブルクリックすることで、ユーザーがエリアチャートで最初の押下をトリガーしたときに発せられる。

pressed,released,clickedも参照

[signal] void QAreaSeries::hovered(const QPointF &point, bool state)

このシグナルは、ユーザーがマウスカーソルをシリーズの上に置いたり、シリーズから遠ざけたりしたときに発せられる。point は、ホバーイベントの原点(座標)を示す。state は、カーソルがシリーズの上に置かれたときにtrue となり、シリーズから遠ざかったときにfalse となる。

QPen QAreaSeries::pen() const

このシリーズの線を引くために使用されたペンを返します。

setPen()も参照

[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)

このシグナルは、データポイントラベルのクリッピングがclipping に変更されたときに発せられる。

注: プロパティpointLabelsClipping に対するノーティファイア・シグナル。

[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)

このシグナルは、データポイントのラベルに使用される色がcolor に変更されたときに発行されます。

注: プロパティpointLabelsColor に対するノーティファイア・シグナル。

[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)

このシグナルは、データポイントのラベルに使用されているフォントがfont に変更されたときに発行されます。

注: プロパティpointLabelsFont に対するノーティファイア・シグナル。

[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)

このシグナルは、データポイント・ラベルのformat が変更されたときに発せられる。

注: プロパティpointLabelsFormat に対するノーティファイア・シグナル。

[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)

このシグナルは、データポイントラベルの可視性がvisible に変更されたときに発行される。

注: プロパティpointLabelsVisible に対するノーティファイア・シグナル。

bool QAreaSeries::pointsVisible() const

この系列に対してポイントが描画されているかどうかを返します。

setPointsVisible()も参照

[signal] void QAreaSeries::pressed(const QPointF &point)

このシグナルは、ユーザーがエリアチャートでpoint で指定されたポイントを押したときに発せられる。

clickedreleaseddoubleClickedも参照

[signal] void QAreaSeries::released(const QPointF &point)

このシグナルは、エリア・チャートのpoint でトリガーされた押しをユーザーが離すと発せられる。

pressedclickeddoubleClickedも参照

void QAreaSeries::setBrush(const QBrush &brush)

領域の塗りつぶしに使用するbrush を設定します。

brush()も参照

void QAreaSeries::setLowerSeries(QLineSeries *series)

エリアチャートの下位系列として使用するseries を設定する。

lowerSeries()も参照

void QAreaSeries::setPen(const QPen &pen)

領域の輪郭の描画に使用するpen を設定します。

pen()も参照してください

void QAreaSeries::setPointsVisible(bool visible = true)

データ点がvisible であり、線上に描画されるべきかどうかを決定する。

pointsVisible()も参照

void QAreaSeries::setUpperSeries(QLineSeries *series)

エリアチャート上部の系列として使用するseries を設定します。上位系列がNULLの場合、下位系列があってもエリアチャートは描画されません。

upperSeries()も参照

[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const

プロパティのアクセス関数を再インプリメント:QAbstractSeries::type.

QAbstractSeries::SeriesTypeArea を返します。

© 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.