QAreaSeries 类
QAreaSeries 类用于在面积图中显示数据。更多...
头文件 | #include <QAreaSeries> |
实例化 | AreaSeries |
继承自 | QAbstractSeries |
属性
|
|
公共函数
QAreaSeries(QObject *parent = nullptr) | |
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr) | |
virtual | ~QAreaSeries() |
QColor | borderColor() const |
QBrush | brush() const |
QColor | color() const |
QLineSeries * | lowerSeries() const |
QPen | pen() const |
bool | pointLabelsClipping() const |
QColor | pointLabelsColor() const |
QFont | pointLabelsFont() const |
QString | pointLabelsFormat() const |
bool | pointLabelsVisible() const |
bool | pointsVisible() const |
void | setBorderColor(const QColor &color) |
void | setBrush(const QBrush &brush) |
void | setColor(const QColor &color) |
void | setLowerSeries(QLineSeries *series) |
void | setPen(const QPen &pen) |
void | setPointLabelsClipping(bool enabled = true) |
void | setPointLabelsColor(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::SeriesType | type() const override |
信号
void | borderColorChanged(QColor color) |
void | clicked(const QPointF &point) |
void | colorChanged(QColor color) |
void | doubleClicked(const QPointF &point) |
void | hovered(const QPointF &point, bool state) |
void | pointLabelsClippingChanged(bool clipping) |
void | pointLabelsColorChanged(const QColor &color) |
void | pointLabelsFontChanged(const QFont &font) |
void | pointLabelsFormatChanged(const QString &format) |
void | pointLabelsVisibilityChanged(bool visible) |
void | pressed(const QPointF &point) |
void | released(const QPointF &point) |
详细描述
区域系列用于显示定量数据。它基于线系列,通过用颜色强调边界线之间的区域。由于区域系列基于线系列,QAreaSeries 构造函数需要一个 QLineSeries 实例,该实例定义了区域的 上层 边界。默认情况下,区域图表使用绘图区域的底部作为 下层 边界。下层边界可以使用另一条线指定。在这种情况下,应该使用两个 QLineSeries 实例初始化 QAreaSeries。
注意:当下层边界的值大于上层边界时,术语 上层 和 下层 边界可能会产生误导。主要观点是这两条边界线之间的区域将被填充。
访问图表与小部件画廊以了解如何创建简单的区域图表。
属性说明
borderColor : QColor
此属性保存系列的线条(笔)颜色。这是一个用于修改笔颜色的便利属性。
访问函数
QColor | borderColor() const |
void | setBorderColor(const QColor &color) |
通知信号
void | borderColorChanged(QColor color) |
另请参阅QAreaSeries::pen。
color : QColor
此属性保存系列的填充(刷子)颜色。这是一个用于修改刷子颜色的便利属性。
访问函数
QColor | color() const |
void | setColor(const QColor &color) |
通知信号
void | colorChanged(QColor color) |
参见:QAreaSeries::brush。(翻译忽略)。
[只读]
lowerSeries : QLineSeries* const
此属性保存用于定义面积系列边界的两个线条系列中的较低一个。
注意:如果没有为 QAreaSeries 指定 lowerSeries,则此值为 null。
访问函数
QLineSeries * | lowerSeries() const |
pointLabelsClipping : bool
此属性保存数据点标签的裁剪。默认为 True。启用裁剪时,图表区域边缘的标签将被裁剪。
访问函数
bool | pointLabelsClipping() const |
void | setPointLabelsClipping(bool enabled = true) |
通知信号
void | pointLabelsClippingChanged(bool clipping) |
pointLabelsColor : QColor
此属性保存用于数据点标签的颜色。默认情况下,颜色是为主题中的标签定义的画刷颜色。
访问函数
QColor | pointLabelsColor() const |
void | setPointLabelsColor(const QColor &color) |
通知信号
void | pointLabelsColorChanged(const QColor &color) |
参见:QAreaSeries::pointLabelsFormat。
pointLabelsFont : QFont
此属性保存用于数据点标签的字体。
访问函数
QFont | pointLabelsFont() const |
void | setPointLabelsFont(const QFont &font) |
通知信号
void | pointLabelsFontChanged(const QFont &font) |
参见:QAreaSeries::pointLabelsFormat。
pointLabelsFormat : QString
此属性保存用于显示系列点的标签的格式。
QAreaSeries 支持以下格式标签:
@xPoint | 数据点的 x 值 |
@yPoint | 数据点的 y 值 |
例如,以下使用格式标签的用法将产生带有括号内的数据点 (x, y) 的标签,括号之间用逗号分隔
series->setPointLabelsFormat("(@xPoint, @yPoint)");
默认情况下,标签格式设置为 @xPoint, @yPoint
。标签显示在图表区域上,而图表区域边缘的标签将被剪裁。如果点彼此太近,标签可能会重叠。
访问函数
QString | pointLabelsFormat() const |
void | setPointLabelsFormat(const QString &format) |
通知信号
void | pointLabelsFormatChanged(const QString &format) |
参见:QAreaSeries::pointLabelsVisible,QAreaSeries::pointLabelsFont 和 QAreaSeries::pointLabelsColor。
pointLabelsVisible : bool
此属性保存数据点标签的可见性。默认为 False。
访问函数
bool | pointLabelsVisible() const |
void | setPointLabelsVisible(bool visible = true) |
通知信号
void | pointLabelsVisibilityChanged(bool visible) |
另请参阅 QAreaSeries::pointLabelsFormat 和 QAreaSeries::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不拥有上或下线系列,所有权仍属于调用者。当系列对象被添加到QChartView或QChart时,实例所有权将转移。
[虚函数无异常]
QAreaSeries::~QAreaSeries()
销毁对象。
[信号]
void QAreaSeries::borderColorChanged(QColor color)
当线条(笔)颜色变更为color时,发出此信号。
注意:这是属性borderColor的通知信号。
QBrush QAreaSeries::brush() const
返回用于绘制此系列线条的画笔。
另请参阅 setBrush().
[信号]
void QAreaSeries::clicked(const QPointF &point)
当用户在区域图中点击point时,触发 presses,发出此信号。
另请参阅 pressed、released和doubleClicked。
[信号]
void QAreaSeries::colorChanged(QColor color)
当填充(画笔)颜色变更为color时,发出此信号。
注意:这是属性color的通知信号。
[signal]
void QAreaSeries::doubleClicked(const QPointF &point)
此信号在用户通过双击点 point 触发区域图的第一次按下时发出。
另请参阅pressed、released 和 clicked。
[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 时,会发出此信号。
另请参见 clicked、released 和 doubleClicked。
[signal]
void QAreaSeries::released(const QPointF &point)
当用户在区域图中按下并在点 point 释放时,会发出此信号。
另请参见 pressed、clicked 和 doubleClicked。
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。
© 2024 Qt 公司有限公司。此处包含的文档贡献作品的版权归其各自所有者所有。此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 的条款许可的。Qt 及相关标志是芬兰的 Qt 公司以及全球其他国家的注册商标。所有其他商标均为其各自所有者的财产。