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) |
Notifier シグナル：
| 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) |
Notifier シグナル：
| 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つの線系列のうち、上側の線系列を保持する。
アクセス関数：
| 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 をダブルクリックして、エリア・チャートで最初の押下をトリガーしたときに発せられます。
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 で指定されたポイントを押したときに発せられる。
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 に対するアクセス関数を再インプリメントします。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
