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 をクリックし、その押下をトリガーしたときに発せられる。
pressed 、released 、doubleClickedも参照 。
[signal]
void QAreaSeries::colorChanged(QColor color)
このシグナルは、塗りつぶし(ブラシ)の色がcolor に変わったときに発せられる。
注: プロパティの通知シグナルcolor 。
[signal]
void QAreaSeries::doubleClicked(const QPointF &point)
このシグナルは、point をダブルクリックすることで、ユーザーがエリアチャートで最初の押下をトリガーしたときに発せられる。
[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 で指定されたポイントを押したときに発せられる。
clicked 、released 、doubleClickedも参照 。
[signal]
void QAreaSeries::released(const QPointF &point)
このシグナルは、エリア・チャートのpoint でトリガーされた押しをユーザーが離すと発せられる。
pressed 、clicked 、doubleClickedも参照 。
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.
© 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.