AreaSeries QML Type
以面积图形式展示数据。更多...
| Import Statement: | import QtGraphs |
| In C++: | QAreaSeries |
| Inherits: |
- 所有成员的列表，包括继承的成员
- AreaSeries 是Qt Graphs 二维QML类型的一部分。
属性
- borderColor : color
- borderWidth : real
- color : color
- gradient : ShapeGradient
(since 6.11) - lowerSeries : XYSeries
- selected : bool
- selectedBorderColor : color
- selectedColor : color
- selectedGradient : ShapeGradient
(since 6.11) - upperSeries : XYSeries
信号
- borderColorChanged(color newBorderColor)
- borderWidthChanged()
- clicked(point point)
- colorChanged(color newColor)
- doubleClicked(point point)
- gradientChanged()
(since 6.11) - lowerSeriesChanged()
- pressed(point point)
- released(point point)
- selectedBorderColorChanged(color newSelectedBorderColor)
- selectedChanged()
- selectedColorChanged(color newSelectedColor)
- selectedGradientChanged()
(since 6.11) - upperSeriesChanged()
详细说明
面积图用于绘制由数据点构成的区域。这些数据点由两条曲线定义：upperSeries 和lowerSeries 。两条曲线之间的区域将作为图形绘制出来。如果仅定义了upperSeries ，则该区域位于图形底部与上层曲线之间。
属性文档
borderColor : color
该区域的边框颜色。默认值为transparent ，表示边框颜色由主题决定。
borderWidth : real
包围该区域的线条宽度。默认值为-1 ，这意味着边框宽度由主题决定。
color : color
该区域的填充颜色。默认值为transparent ，表示颜色由主题决定。
注意：如果将 gradient 设置为null 以外的值，则这些设置将优先于color 。在此情况下，color 将被忽略。
gradient : ShapeGradient [since 6.11]
此属性用于定义填充渐变。默认情况下未启用渐变，且值为null 。在此情况下，填充将基于color 属性。
注意： 此处不能使用“Gradient”类型 。建议改用高级子类型之一，例如LinearGradient 。
注意：如果 设置为null 以外的值，则gradient 将优先于color 。
该属性在 Qt 6.11 中引入。
lowerSeries : XYSeries
设置区域的下界。如果此参数为空，则将图的底部视为下界。
selected : bool
将该区域设为选中状态。默认值为false 。
selectedBorderColor : color
选中时该区域的边框颜色。默认值为transparent ，表示选中时的边框颜色由主题决定。
selectedColor : color
选中时该区域的填充颜色。默认值为transparent ，表示选中颜色由主题决定。
注意：如果将 selectedGradient 设置为null 以外的值，则这些设置将优先于selectedColor 。在此情况下，selectedColor 将被忽略。
selectedGradient : ShapeGradient [since 6.11]
此属性定义选中时该区域的填充渐变效果。默认情况下未启用渐变，且值为null 。在此情况下，填充效果将基于selectedColor 属性。
注意： 此处不能使用“Gradient”类型 。建议改用其中一种高级子类型，例如LinearGradient 。
注意：如果 设置为null 以外的值，则selectedGradient 将优先于selectedColor 。
该属性在 Qt 6.11 中引入。
upperSeries : XYSeries
设置区域的上边界。如果此参数为空，则不绘制该区域。
信号文档
borderColorChanged(color newBorderColor)
当区域边框颜色变为newBorderColor 时，会发出此信号。
注意： 相应的处理程序 为onBorderColorChanged 。
borderWidthChanged()
当区域边框宽度发生变化时，会发出此信号。
注意： 相应的处理程序 为onBorderWidthChanged 。
clicked(point point)
当用户点击或轻触面积图时，会触发此信号。point 指定了触发事件的位置。
注意： 相应的处理程序 为onClicked 。
colorChanged(color newColor)
当区域color 变为newColor 时，会发出此信号。
注意： 对应的处理程序 是onColorChanged 。
doubleClicked(point point)
当用户双击或双击轻触面积图时，会触发此信号。point 指定了触发事件的位置。此信号总是在clicked 之后发生。
注意： 相应的处理程序 是onDoubleClicked 。
[since 6.11] gradientChanged()
当梯度发生变化时，会发出此信号。
注意： 相应的处理程序 为onGradientChanged 。
该信号于 Qt 6.11 版本中引入。
lowerSeriesChanged()
当下一个序列发生变化时，会发出此信号。
注意： 相应的处理程序 为onLowerSeriesChanged 。
pressed(point point)
当用户点击或轻触面积图并按住鼠标按钮或手势时，会发出此信号。point 指定了触发事件的位置。
注意： 相应的处理程序 为onPressed 。
released(point point)
当用户松开按下的鼠标按钮或触摸点时，会触发此信号。point 指定了事件的触发位置。
注意： 相应的处理程序 为onReleased 。
selectedBorderColorChanged(color newSelectedBorderColor)
当选中区域的边框颜色变为newSelectedBorderColor 时，会发出此信号。
注意： 相应的处理程序 为onSelectedBorderColorChanged 。
selectedChanged()
当选中当前区域时，会触发此信号。
注意： 相应的处理程序 为onSelectedChanged 。
selectedColorChanged(color newSelectedColor)
当选中区域的颜色变为newSelectedColor 时，会发出此信号。
注意： 相应的处理程序 为onSelectedColorChanged 。
[since 6.11] selectedGradientChanged()
当选定区域的梯度发生变化时，会触发此信号。
注意： 相应的处理函数 为onSelectedGradientChanged 。
该信号在 Qt 6.11 中引入。
upperSeriesChanged()
当上层序列发生变化时，会发出此信号。
注意： 相应的处理程序 为onUpperSeriesChanged 。
© 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.
