QCandlestickSeries Class
QCandlestickSeries 类将数据显示为烛台。更多
| Header: | #include <QCandlestickSeries> |
| In QML: | CandlestickSeries |
| Inherits: | QAbstractSeries |
属性
|
|
公共函数
| QCandlestickSeries(QObject *parent = nullptr) | |
| virtual | ~QCandlestickSeries() |
| bool | append(QCandlestickSet *set) |
| bool | append(const QList<QCandlestickSet *> &sets) |
| bool | bodyOutlineVisible() const |
| qreal | bodyWidth() const |
| QBrush | brush() const |
| bool | capsVisible() const |
| qreal | capsWidth() const |
| void | clear() |
| int | count() const |
| QColor | decreasingColor() const |
| QColor | increasingColor() const |
| bool | insert(int index, QCandlestickSet *set) |
| qreal | maximumColumnWidth() const |
| qreal | minimumColumnWidth() const |
| QPen | pen() const |
| bool | remove(QCandlestickSet *set) |
| bool | remove(const QList<QCandlestickSet *> &sets) |
| void | setBodyOutlineVisible(bool bodyOutlineVisible) |
| void | setBodyWidth(qreal bodyWidth) |
| void | setBrush(const QBrush &brush) |
| void | setCapsVisible(bool capsVisible) |
| void | setCapsWidth(qreal capsWidth) |
| void | setDecreasingColor(const QColor &decreasingColor) |
| void | setIncreasingColor(const QColor &increasingColor) |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
| void | setPen(const QPen &pen) |
| QList<QCandlestickSet *> | sets() const |
| bool | take(QCandlestickSet *set) |
重新实现的公共函数
| virtual QAbstractSeries::SeriesType | type() const override |
信号
| void | bodyOutlineVisibilityChanged() |
| void | bodyWidthChanged() |
| void | brushChanged() |
| void | candlestickSetsAdded(const QList<QCandlestickSet *> &sets) |
| void | candlestickSetsRemoved(const QList<QCandlestickSet *> &sets) |
| void | capsVisibilityChanged() |
| void | capsWidthChanged() |
| void | clicked(QCandlestickSet *set) |
| void | countChanged() |
| void | decreasingColorChanged() |
| void | doubleClicked(QCandlestickSet *set) |
| void | hovered(bool status, QCandlestickSet *set) |
| void | increasingColorChanged() |
| void | maximumColumnWidthChanged() |
| void | minimumColumnWidthChanged() |
| void | penChanged() |
| void | pressed(QCandlestickSet *set) |
| void | released(QCandlestickSet *set) |
详细说明
该类是单个蜡烛图项目的容器。当使用QBarCategoryAxis 时，每个项目都绘制在自己的类别中。QDateTimeAxis 和QValueAxis 可替代QBarCategoryAxis 。在这种情况下，每个烛台项目都根据其时间戳值绘制。
注意： 在一个 QCandlestickSeries 中，时间戳必须是唯一的。使用QBarCategoryAxis 时，只绘制共享时间戳的第一个烛台项。如果图表包含多个 QCandlestickSeries 实例，则共享时间戳的不同系列的项目会被绘制到同一类别中。当使用QValueAxis 或QDateTimeAxis 时，共享时间戳的烛台项会相互重叠。
请参阅 "使用小工具的图表图库"，了解如何创建蜡烛图。
另请参阅 QCandlestickSet,QBarCategoryAxis,QDateTimeAxis 和QValueAxis 。
属性文档
bodyOutlineVisible : bool
该属性用于设置烛台主体轮廓的可见性。
访问功能：
| bool | bodyOutlineVisible() const |
| void | setBodyOutlineVisible(bool bodyOutlineVisible) |
通知信号：
| void | bodyOutlineVisibilityChanged() |
bodyWidth : qreal
该属性保存烛台项目在其槽内的相对宽度，范围为 0.0 至 1.0。
超出此范围的值将被箝位为 0.0 或 1.0。
访问功能：
| qreal | bodyWidth() const |
| void | setBodyWidth(qreal bodyWidth) |
通知信号：
| void | bodyWidthChanged() |
brush : QBrush
此属性保存用于填充烛台项目的笔刷。
访问功能：
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
通知信号：
| void | brushChanged() |
capsVisible : bool
此属性表示盖帽的可见性。
访问功能：
| bool | capsVisible() const |
| void | setCapsVisible(bool capsVisible) |
通知信号：
| void | capsVisibilityChanged() |
capsWidth : qreal
该属性用于保存烛台内盖帽的相对宽度，范围为 0.0 至 1.0。
超出此范围的值将被箝位为 0.0 或 1.0。
访问功能：
| qreal | capsWidth() const |
| void | setCapsWidth(qreal capsWidth) |
通知信号：
| void | capsWidthChanged() |
[read-only] count : const int
该属性用于保存系列中烛台项目的数量。
访问功能：
| int | count() const |
通知信号：
| void | countChanged() |
decreasingColor : QColor
该属性用于保存递减蜡烛图项目主体的颜色。
当烛台的开盘值高于收盘值时，烛台就是递减的。默认情况下，该属性设置为画笔颜色，alpha 通道设置为 128。当属性设置为无效颜色值时，也会使用默认颜色。
访问功能
| QColor | decreasingColor() const |
| void | setDecreasingColor(const QColor &decreasingColor) |
通知信号：
| void | decreasingColorChanged() |
increasingColor : QColor
该属性用于保存递增蜡烛图项目主体的颜色。
当烛台的收盘值高于开盘值时，该烛台就是递增的。默认情况下，该属性设置为笔刷颜色。当该属性设置为无效颜色值时，也会使用默认颜色。
访问功能：
| QColor | increasingColor() const |
| void | setIncreasingColor(const QColor &increasingColor) |
通知信号：
| void | increasingColorChanged() |
maximumColumnWidth : qreal
该属性以像素为单位保存烛台项目的最大宽度。设置负值表示没有最大宽度。所有负值均转换为-1.0。
访问功能：
| qreal | maximumColumnWidth() const |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
通知信号：
| void | maximumColumnWidthChanged() |
minimumColumnWidth : qreal
该属性以像素为单位保存烛台项目的最小宽度。设置负值表示没有最小宽度。所有负值均转换为-1.0。
访问功能：
| qreal | minimumColumnWidth() const |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
通知信号：
| void | minimumColumnWidthChanged() |
pen : QPen
该属性保存用于绘制烛台项目线条的笔。
访问功能：
| QPen | pen() const |
| void | setPen(const QPen &pen) |
通知信号：
| void | penChanged() |
成员函数 文档
[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)
构造一个空的 QCandlestickSeries。parent 是可选项。
[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()
销毁系列。从图表中删除系列。
bool QCandlestickSeries::append(QCandlestickSet *set)
将set 指定的单个蜡烛图项目添加到系列中，并获得其所有权。如果项目为空或已在系列中，则不会添加。如果追加成功，则返回true ，否则返回false 。
bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)
将sets 指定的蜡烛图项目列表添加到系列中，并获得其所有权。如果任何项目为空、已属于系列或在列表中出现多次，则不会添加任何项目。如果所有项目都成功添加，则返回true ，否则返回false 。
[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()
当烛台项目主体轮廓的可见性发生变化时，将发出该信号。
注： 属性bodyOutlineVisible 的通知信号。
另请参阅 bodyOutlineVisible 。
[signal] void QCandlestickSeries::bodyWidthChanged()
当烛台项目宽度发生变化时发出该信号。
注： 属性bodyWidth 的通知信号。
另请参阅 bodyWidth 。
[signal] void QCandlestickSeries::brushChanged()
当烛台项目刷子发生变化时发出该信号。
注： 用于属性brush 的通知信号。
另请参阅 brush 。
[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
当sets 指定的烛台项目被添加到系列时，会发出该信号。
[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
当sets 指定的烛台项目从系列中移除时，会发出该信号。
[signal] void QCandlestickSeries::capsVisibilityChanged()
当烛台项目盖帽的可见性发生变化时会发出该信号。
注： 属性capsVisible 的通知信号。
另请参阅 capsVisible 。
[signal] void QCandlestickSeries::capsWidthChanged()
当烛台项目上限宽度发生变化时会发出该信号。
注： 属性capsWidth 的通知信号。
另请参阅 capsWidth 。
void QCandlestickSeries::clear()
删除系列中的所有烛台项目，并将其永久删除。
[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)
在图表上点击set 指定的烛台项目时，会发出该信号。
int QCandlestickSeries::count() const
返回系列中烛台项目的数量。
注： 属性计数的获取函数。
[signal] void QCandlestickSeries::countChanged()
当系列中烛台项目的数量发生变化时，将发出该信号。
注： 属性count 的通知信号。
另请参阅 count 。
[signal] void QCandlestickSeries::decreasingColorChanged()
该信号在烛台项目递减颜色发生变化时发出。
注： 属性decreasingColor 的通知信号。
另请参阅 decreasingColor 。
[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)
在图表上双击set 指定的烛台项目时，会发出该信号。
[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)
当鼠标悬停在图表中set 指定的蜡烛图项目上时，就会发出该信号。
当鼠标移动到该项目上时，status 变成true ，当鼠标再次移开时，变成false 。
[signal] void QCandlestickSeries::increasingColorChanged()
当烛台项目增加的颜色发生变化时发出该信号。
注： 属性increasingColor 的通知信号。
另请参阅 increasingColor 。
bool QCandlestickSeries::insert(int index, QCandlestickSet *set)
将set 指定的烛台项目插入index 指定位置的系列中。获取项目的所有权。如果项目为空或已属于系列，则不会插入。如果插入成功，则返回true ，否则返回false 。
[signal] void QCandlestickSeries::maximumColumnWidthChanged()
当烛台项目的最大列宽发生变化时，将发出该信号。
注： 属性maximumColumnWidth 的通知信号。
另请参阅 maximumColumnWidth 。
[signal] void QCandlestickSeries::minimumColumnWidthChanged()
当烛台项目的最小列宽发生变化时，将发出该信号。
注： 属性minimumColumnWidth 的通知信号。
另请参阅 minimumColumnWidth 。
[signal] void QCandlestickSeries::penChanged()
当烛台项目笔发生变化时发出该信号。
注： 属性pen 的通知信号。
另请参阅 pen 。
[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)
当用户点击set 指定的烛台项目并按住鼠标键时，会发出该信号。
[signal] void QCandlestickSeries::released(QCandlestickSet *set)
当用户在set 指定的烛台项目上松开鼠标时，会发出该信号。
bool QCandlestickSeries::remove(QCandlestickSet *set)
从系列中删除set 指定的单个蜡烛图项目。如果项目删除成功，则返回true ，否则返回false 。
bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)
从系列中删除sets 指定的烛台项目列表。如果任何项目为空、已从系列中移除或在列表中出现多次，则不会移除任何项目。如果所有项目都成功移除，则返回true ，否则返回false 。
QList<QCandlestickSet *> QCandlestickSeries::sets() const
返回系列中的蜡烛图项目列表。项目的所有权不会改变。
bool QCandlestickSeries::take(QCandlestickSet *set)
从系列中提取set 指定的单个蜡烛图项目。不会删除该项目。如果取值操作成功，则返回true ，否则返回false 。
注意： 系列仍是项目的父对象。您必须设置父对象以获得完全所有权。
[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const
重构属性访问函数：QAbstractSeries::type 。
返回系列的类型 (QAbstractSeries::SeriesTypeCandlestick)。
© 2025 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.
