class QAreaSeries#

该 QAreaSeries 类以区域图的形式表示数据。更多...

Inheritance diagram of PySide6.QtCharts.QAreaSeries

概要#

属性#

  • borderColor - 序列的线条（画笔）颜色。这是一个方便的属性，用于修改画笔的颜色

  • color - 序列的填充（刷子）颜色。这是一个方便的属性，用于修改刷子的颜色

  • pointLabelsClipping - 数据点标签的裁剪。默认为真。当启用裁剪时，绘图区域的边缘标签将被切断

  • pointLabelsColor - 用于数据点标签的颜色。默认情况下，颜色是主题中定义的用于标签的画刷的颜色

  • pointLabelsFont - 用于数据点标签的字体

  • pointLabelsFormat - 用于显示系列点的标签的格式

  • pointLabelsVisible - 数据点标签的可见性。默认为假

方法#

信号#

注意

本文档可能包含从 C++ 自动翻译到 Python 的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译存在问题，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE

详细描述#

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

注意

在某些情况下，例如下限值的边界值大于上限值的边界值时，'上边界' 和 '下边界' 这样的术语可能会有误导性。主要观点是这两条边界线之间的区域将被填充。

请参阅 带有小部件的图表画廊，了解如何创建简单的面积图。

../../_images/examples_areachart.png

注意

当使用 from __feature__ import true_property 时，可以直接使用属性；否则通过访问器函数。

属性borderColor: QColor#

该属性包含系列线条的颜色。这是一个方便的属性，用于修改画笔的颜色。

另请参阅

pen()

访问函数
属性color: QColor#

该属性包含系列的填充（画笔）颜色。这是一个用于修改画笔颜色的便利属性。

另请参阅

brush()

访问函数
属性pointLabelsClipping: bool#

该属性包含数据点标签的剪切。默认为 True。当启用了剪切时，图表区域边缘的标签将被剪切。

另请参阅

pointLabelsVisible

访问函数
属性 pointLabelsColor: QColor#

该属性用于保存数据点标签所使用的颜色。默认情况下，颜色与主题中定义的标签笔刷颜色相同。

另请参阅

pointLabelsFormat

访问函数
属性 pointLabelsFont: QFont#

该属性用于保存数据点标签所使用的字体。

另请参阅

pointLabelsFormat

访问函数
属性 pointLabelsFormat: str#

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

QAreaSeries 支持以下格式标签

@xPoint

数据点的x值

@yPoint

数据点的y值

例如，以下使用格式标签的示例将显示括号内由逗号分隔的(x, y)数据点

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

默认情况下，标签格式设置为 @xPoint, @yPoint。标签显示在图表区域中，而图表边缘的标签则被裁剪。如果点排得很近，标签可能会重叠。

访问函数
属性 pointLabelsVisible: bool#

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

访问函数
__init__([parent=None])#
参数:

parent – QObject

使用指定的父对象构造一个不包含上或下系列的区域系列对象。

borderColor()#
返回类型:

QColor

另请参阅

setBorderColor()

属性 borderColor 的获取器。

borderColorChanged(color)#
参数:

color – QColor

当线条（画笔）颜色更改到 color 时，此信号被发出。

属性 borderColor 的通知信号。

brush()#
返回类型:

QBrush

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

另请参阅

setBrush()

clicked(point)#
参数:

point – QPointF

当用户在区域图表中点击 point 以触发对该点的按下操作时，此信号被发出。

color()#
返回类型:

QColor

另请参阅

setColor()

属性 color 的获取器。

colorChanged(color)#
参数:

color – QColor

当填充（画刷）颜色更改到 color 时，此信号被发出。

属性 color 的通知信号。

doubleClicked(point)#
参数:

point – QPointF

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

另请参阅

pressed released clicked

hovered(point, state)#
参数:

  • point – QPointF

  • 状态 – bool

当用户将鼠标光标悬停在序列上或将其从序列上移开时，会发出此信号。 point 显示悬停事件的原始位置（坐标）。state 当光标悬停在序列上时为 true，当光标从序列上移开时变为 false。

pen()#
返回类型:

QPen

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

另请参阅

setPen()

pointLabelsClipping()#
返回类型:

bool

另请参阅

setPointLabelsClipping()

属性《pointLabelsClipping《》的获取器。

pointLabelsClippingChanged(clipping)#
参数:

clipping – bool

当数据点标签的裁剪变为 clipping 时，会发出此信号。

属性《pointLabelsClipping《》的通知信号。

pointLabelsColor()#
返回类型:

QColor

另请参阅

setPointLabelsColor()

属性《pointLabelsColor《》的获取器。

pointLabelsColorChanged(color)#
参数:

color – QColor

当用于数据点标签的颜色变为 color 时，会发出此信号。

属性《pointLabelsColor《》的通知信号。

pointLabelsFont()#
返回类型:

QFont

另请参阅

setPointLabelsFont()

属性 pointLabelsFont 的获取器。

pointLabelsFontChanged(font)#
参数:

font – QFont

当用于数据点标签的字体更改为 font 时发射此信号。

属性 pointLabelsFont 的通知信号。

pointLabelsFormat()#
返回类型:

str

另请参阅

setPointLabelsFormat()

属性 pointLabelsFormat 的获取器。

pointLabelsFormatChanged(format)#
参数:

format – str

当数据点标签的格式更改时，发射此信号。

属性 pointLabelsFormat 的通知信号。

pointLabelsVisibilityChanged(visible)#
参数:

visible – bool

当数据点标签的可见性更改为 visible 时发射此信号。

属性 pointLabelsVisible 的通知信号。

pointLabelsVisible()#
返回类型:

bool

另请参阅

setPointLabelsVisible()

属性 pointLabelsVisible 的获取器。

pointsVisible()#
返回类型:

bool

返回此系列是否绘制点。

另请参阅

setPointsVisible()

pressed(point)#
参数:

point – QPointF

当用户在一个区域图中按下指定的 point 点时发射此信号。

发布(点)#
参数:

point – QPointF

当用户在任何区域图的 点 上触发并释放一个按压时，将发出此信号。

selected()#
setBorderColor(颜色)#
参数:

color – QColor

另请参阅

borderColor()

属性 borderColorᅟ 的设置器。

setBrush(brush)#
参数:

brush – QBrush

设置用于填充区域的 brush。

另请参阅

brush()

setColor(颜色)#
参数:

color – QColor

另请参阅

color()

属性 colorᅟ 的设置器。

setPen(pen)#
参数:

pen – QPen

设置用于绘制区域轮廓的 pen。

另请参阅

pen()

setPointLabelsClipping([enabled=true])#
参数:

enabled – bool

另请参阅

pointLabelsClipping()

属性 pointLabelsClippingᅟ 的设置器。

setPointLabelsColor(颜色)#
参数:

color – QColor

另请参阅

pointLabelsColor()

属性 pointLabelsColorᅟ 的设置器。

setPointLabelsFont(字体)#
参数:

font – QFont

另请参阅

pointLabelsFont()

属性 pointLabelsFont属性 的设置器。

setPointLabelsFormat(format)#
参数:

format – str

另请参阅

pointLabelsFormat()

属性 pointLabelsFormat属性 的设置器。

setPointLabelsVisible([visible=true])#
参数:

visible – bool

另请参阅

pointLabelsVisible()

属性 pointLabelsVisible属性 的设置器。

setPointsVisible([visible=true])#
参数:

visible – bool

确定数据点是可见的并且应该绘制在直线上。

另请参阅

pointsVisible()