QAreaSeries Class
QAreaSeries 类以区域图的形式显示数据。更多
| Header： | #include <QAreaSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake： | QT += graphs |
| 在 QML 中： | AreaSeries |
| 继承： | QAbstractSeries |
- 所有成员的列表，包括继承成员
- QAreaSeries 是Qt Graphs C++ Classes for 2D 的一部分。
属性
|
|
公共功能
| QColor | borderColor() const |
| qreal | borderWidth() const |
| QColor | color() const |
| QQuickShapeGradient * | gradient() const |
| bool | isSelected() const |
| QXYSeries * | lowerSeries() const |
| QColor | selectedBorderColor() const |
| QColor | selectedColor() const |
| QQuickShapeGradient * | selectedGradient() const |
| void | setBorderColor(QColor newBorderColor) |
| void | setBorderWidth(qreal newBorderWidth) |
| void | setColor(QColor newColor) |
| void | setGradient(QQuickShapeGradient *newGradient) |
| void | setLowerSeries(QXYSeries *newLowerSeries) |
| void | setSelected(bool newSelected) |
| void | setSelectedBorderColor(QColor newSelectedBorderColor) |
| void | setSelectedColor(QColor newColor) |
| void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient) |
| void | setUpperSeries(QXYSeries *newUpperSeries) |
| QXYSeries * | upperSeries() const |
信号
| void | borderColorChanged(QColor newBorderColor) |
| void | borderWidthChanged() |
| void | colorChanged(QColor newColor) |
| void | gradientChanged(QQuickShapeGradient *newGradient) |
| void | lowerSeriesChanged() |
| void | selectedBorderColorChanged(QColor newSelectedBorderColor) |
| void | selectedChanged() |
| void | selectedColorChanged(QColor newSelectedColor) |
| void | selectedGradientChanged(QQuickShapeGradient *newGradient) |
| 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 ，即颜色由主题定义。
注意： 如果gradient 设置为null 以外的值，这些值将优先于color 。在这种情况下，color 将被忽略。
访问功能：
| QColor | color() const |
| void | setColor(QColor newColor) |
通知信号：
| void | colorChanged(QColor newColor) |
[since 6.11] gradient : QQuickShapeGradient*
该属性定义了填充梯度。默认情况下不启用渐变，值为null 。在这种情况下，填充将基于color 属性。
注意： 此处不能使用渐变类型。建议使用高级子类型，如LinearGradient 。
注意： 如果设置为null 以外的内容，gradient 将优先于color 。
此属性在 Qt 6.11 中引入。
访问功能：
| QQuickShapeGradient * | gradient() const |
| void | setGradient(QQuickShapeGradient *newGradient) |
Notifier 信号：
| void | gradientChanged(QQuickShapeGradient *newGradient) |
lowerSeries : QXYSeries*
设置区域的下边界。如果为空，则图形底部被视为下边界。
访问功能
| 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 ，这意味着选定的颜色由主题定义。
注意： 如果selectedGradient 被设置为null 以外的值，这些值将优先于selectedColor 。在这种情况下，selectedColor 将被忽略。
访问功能：
| QColor | selectedColor() const |
| void | setSelectedColor(QColor newColor) |
通知信号：
| void | selectedColorChanged(QColor newSelectedColor) |
[since 6.11] selectedGradient : QQuickShapeGradient*
该属性定义了选中时区域的填充梯度。默认情况下不启用渐变，值为null 。在这种情况下，填充将基于selectedColor 属性。
注意： 此处不能使用渐变类型。请使用高级子类型，如LinearGradient 。
注意： 如果设置为null 以外的内容，selectedGradient 将优先于selectedColor 。
此属性在 Qt 6.11 中引入。
访问功能：
| QQuickShapeGradient * | selectedGradient() const |
| void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient) |
Notifier 信号：
| void | selectedGradientChanged(QQuickShapeGradient *newGradient) |
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.
