本页内容

QAreaSeries Class

QAreaSeries 类用于以面积图的形式展示数据。更多内容...

头文件: #include <QAreaSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML 中: AreaSeries
继承自: QAbstractSeries

属性

公共函数

QColor borderColor() const
qreal borderWidth() const
QColor color() const
bool isSelected() const
QXYSeries *lowerSeries() const
QColor selectedBorderColor() const
QColor selectedColor() const
void setBorderColor(QColor newBorderColor)
void setBorderWidth(qreal newBorderWidth)
void setColor(QColor newColor)
void setLowerSeries(QXYSeries *newLowerSeries)
void setSelected(bool newSelected)
void setSelectedBorderColor(QColor newSelectedBorderColor)
void setSelectedColor(QColor newColor)
void setUpperSeries(QXYSeries *newUpperSeries)
QXYSeries *upperSeries() const

信号

void borderColorChanged(QColor newBorderColor)
void borderWidthChanged()
void colorChanged(QColor newColor)
void lowerSeriesChanged()
void selectedBorderColorChanged(QColor newSelectedBorderColor)
void selectedChanged()
void selectedColorChanged(QColor newSelectedColor)
void upperSeriesChanged()

详细说明

面积图用于绘制由点组成的区域。这些点由两条曲线定义:upperSeries 和lowerSeries 。两条曲线之间的区域将作为图形绘制出来。如果仅定义了upperSeries ,则该区域位于图形底部与上方的曲线之间。

属性文档

borderColor : QColor

该属性用于指定该区域的边框颜色。默认值为Qt::transparent ,表示边框颜色由主题决定。

访问函数:

QColor borderColor() const
void setBorderColor(QColor newBorderColor)

通知器信号:

void borderColorChanged(QColor newBorderColor)

borderWidth : qreal

该属性存储包围该区域的线条宽度。默认值为-1 ,表示边框宽度由主题定义。

访问函数:

qreal borderWidth() const
void setBorderWidth(qreal newBorderWidth)

通知器信号:

void borderWidthChanged()

color : QColor

此属性用于指定区域的填充颜色。默认值为Qt::transparent ,表示颜色由主题决定。

注意:如果将 AreaSeries::gradient 设置为null 以外的其他值,这些设置将优先于color 。在此情况下,color 将被忽略。

访问函数:

QColor color() const
void setColor(QColor newColor)

通知器信号:

void colorChanged(QColor newColor)

lowerSeries : QXYSeries*

设置区域的下界。如果此参数为 null,则将图形底部视为下界。

访问函数:

QXYSeries *lowerSeries() const
void setLowerSeries(QXYSeries *newLowerSeries)

通知器信号:

void lowerSeriesChanged()

selected : bool

将该区域设为选中状态。默认值为false 。

访问函数:

bool isSelected() const
void setSelected(bool newSelected)

通知信号:

void selectedChanged()

selectedBorderColor : QColor

该属性用于指定选中时该区域的边框颜色。默认值为Qt::transparent ,这意味着选中时的边框颜色由主题决定。

访问函数:

QColor selectedBorderColor() const
void setSelectedBorderColor(QColor newSelectedBorderColor)

通知器信号:

void selectedBorderColorChanged(QColor newSelectedBorderColor)

selectedColor : QColor

此属性用于指定选中时该区域的填充颜色。默认值为Qt::transparent ,这意味着选中颜色由主题决定。

注意:如果将 AreaSeries::selectedGradient 设置为null 以外的值,则这些设置将优先于selectedColor 。在此情况下,selectedColor 将被忽略。

访问函数:

QColor selectedColor() const
void setSelectedColor(QColor newColor)

通知器信号:

void selectedColorChanged(QColor newSelectedColor)

upperSeries : QXYSeries*

设置区域的上边界。如果该参数为空,则不绘制任何区域。

访问函数:

QXYSeries *upperSeries() const
void setUpperSeries(QXYSeries *newUpperSeries)

通知器信号:

void upperSeriesChanged()

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