QAreaSeries 类

QAreaSeries 类用于在面积图中显示数据。更多...

头文件 #include <QAreaSeries>
实例化 AreaSeries
继承自 QAbstractSeries

属性

公共函数

QAreaSeries(QObject *parent = nullptr)
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
virtual~QAreaSeries()
QColorborderColor() const
QBrushbrush() const
QColorcolor() const
QLineSeries *lowerSeries() const
QPenpen() const
boolpointLabelsClipping() const
QColorpointLabelsColor() const
QFontpointLabelsFont() const
QStringpointLabelsFormat() const
boolpointLabelsVisible() const
boolpointsVisible() const
voidsetBorderColor(const QColor &color)
voidsetBrush(const QBrush &brush)
voidsetColor(const QColor &color)
voidsetLowerSeries(QLineSeries *series)
voidsetPen(const QPen &pen)
voidsetPointLabelsClipping(bool enabled = true)
voidsetPointLabelsColor(const QColor &color)
void设置点标签字体(const QFont &font)
void设置点标签格式(const QString &format)
void设置点标签可见(bool visible = true)
void设置点可见(bool visible = true)
void设置上层系列(QLineSeries *series)
QLineSeries *upperSeries() const

重写的公共函数

virtual QAbstractSeries::SeriesTypetype() const override

信号

voidborderColorChanged(QColor color)
voidclicked(const QPointF &point)
voidcolorChanged(QColor color)
voiddoubleClicked(const QPointF &point)
voidhovered(const QPointF &point, bool state)
voidpointLabelsClippingChanged(bool clipping)
voidpointLabelsColorChanged(const QColor &color)
voidpointLabelsFontChanged(const QFont &font)
voidpointLabelsFormatChanged(const QString &format)
voidpointLabelsVisibilityChanged(bool visible)
voidpressed(const QPointF &point)
voidreleased(const QPointF &point)

详细描述

区域系列用于显示定量数据。它基于线系列,通过用颜色强调边界线之间的区域。由于区域系列基于线系列,QAreaSeries 构造函数需要一个 QLineSeries 实例,该实例定义了区域的 上层 边界。默认情况下,区域图表使用绘图区域的底部作为 下层 边界。下层边界可以使用另一条线指定。在这种情况下,应该使用两个 QLineSeries 实例初始化 QAreaSeries。

注意:当下层边界的值大于上层边界时,术语 上层下层 边界可能会产生误导。主要观点是这两条边界线之间的区域将被填充。

访问图表与小部件画廊以了解如何创建简单的区域图表。

属性说明

borderColor : QColor

此属性保存系列的线条(笔)颜色。这是一个用于修改笔颜色的便利属性。

访问函数

QColorborderColor() const
voidsetBorderColor(const QColor &color)

通知信号

voidborderColorChanged(QColor color)

另请参阅QAreaSeries::pen

color : QColor

此属性保存系列的填充(刷子)颜色。这是一个用于修改刷子颜色的便利属性。

访问函数

QColorcolor() const
voidsetColor(const QColor &color)

通知信号

voidcolorChanged(QColor color)

参见:QAreaSeries::brush。(翻译忽略)。

[只读] lowerSeries : QLineSeries* const

此属性保存用于定义面积系列边界的两个线条系列中的较低一个。

注意:如果没有为 QAreaSeries 指定 lowerSeries,则此值为 null。

访问函数

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

此属性保存数据点标签的裁剪。默认为 True。启用裁剪时,图表区域边缘的标签将被裁剪。

访问函数

boolpointLabelsClipping() const
voidsetPointLabelsClipping(bool enabled = true)

通知信号

voidpointLabelsClippingChanged(bool clipping)

参见:pointLabelsVisible

pointLabelsColor : QColor

此属性保存用于数据点标签的颜色。默认情况下,颜色是为主题中的标签定义的画刷颜色。

访问函数

QColorpointLabelsColor() const
voidsetPointLabelsColor(const QColor &color)

通知信号

voidpointLabelsColorChanged(const QColor &color)

参见:QAreaSeries::pointLabelsFormat

pointLabelsFont : QFont

此属性保存用于数据点标签的字体。

访问函数

QFontpointLabelsFont() const
voidsetPointLabelsFont(const QFont &font)

通知信号

voidpointLabelsFontChanged(const QFont &font)

参见:QAreaSeries::pointLabelsFormat

pointLabelsFormat : QString

此属性保存用于显示系列点的标签的格式。

QAreaSeries 支持以下格式标签:

@xPoint数据点的 x 值
@yPoint数据点的 y 值

例如,以下使用格式标签的用法将产生带有括号内的数据点 (x, y) 的标签,括号之间用逗号分隔

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

默认情况下,标签格式设置为 @xPoint, @yPoint。标签显示在图表区域上,而图表区域边缘的标签将被剪裁。如果点彼此太近,标签可能会重叠。

访问函数

QStringpointLabelsFormat() const
voidsetPointLabelsFormat(const QString &format)

通知信号

voidpointLabelsFormatChanged(const QString &format)

参见:QAreaSeries::pointLabelsVisibleQAreaSeries::pointLabelsFontQAreaSeries::pointLabelsColor

pointLabelsVisible : bool

此属性保存数据点标签的可见性。默认为 False。

访问函数

boolpointLabelsVisible() const
voidsetPointLabelsVisible(bool visible = true)

通知信号

voidpointLabelsVisibilityChanged(bool visible)

另请参阅 QAreaSeries::pointLabelsFormatQAreaSeries::pointLabelsClipping.

[只读] upperSeries : QLineSeries* const

此属性保存用于定义区域系列边界的两个线系列中的上一个是。

访问函数

QLineSeries *upperSeries() const

成员函数文档

[显式] QAreaSeries::QAreaSeries(QObject *parent = nullptr)

使用父对象parent构造一个没有上或下线系列的区域系列对象。

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

构造一个区域系列对象,该对象将位于一个upperSeries线和一个lowerSeries线之间。如果构造函数中未传递lowerSeries,则使用x轴作为下界。

QAreaSeries不拥有上或下线系列,所有权仍属于调用者。当系列对象被添加到QChartViewQChart时,实例所有权将转移。

[虚函数无异常] QAreaSeries::~QAreaSeries()

销毁对象。

[信号] void QAreaSeries::borderColorChanged(QColor color)

当线条(笔)颜色变更为color时,发出此信号。

注意:这是属性borderColor的通知信号。

QBrush QAreaSeries::brush() const

返回用于绘制此系列线条的画笔。

另请参阅 setBrush().

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

当用户在区域图中点击point时,触发 presses,发出此信号。

另请参阅 pressedreleaseddoubleClicked

[信号] void QAreaSeries::colorChanged(QColor color)

当填充(画笔)颜色变更为color时,发出此信号。

注意:这是属性color的通知信号。

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

此信号在用户通过双击点 point 触发区域图的第一次按下时发出。

另请参阅pressedreleasedclicked

[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)

确定数据点是否 可见 并应在线上绘制。

另请参见 pointsVisible

void QAreaSeries::setUpperSeries(QLineSeries *series)

设置用作区域图上系列的 series。如果上系列为空,即使有下系列,区域图也不会绘制。

另请参见 upperSeries

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

重新实现了属性访问函数: QAbstractSeries::type

返回 QAbstractSeries::SeriesTypeArea

© 2024 Qt 公司有限公司。此处包含的文档贡献作品的版权归其各自所有者所有。此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 的条款许可的。Qt 及相关标志是芬兰的 Qt 公司以及全球其他国家的注册商标。所有其他商标均为其各自所有者的财产。