QCandlestickSeries Class
QCandlestickSeries 类以蜡烛图的形式呈现数据。更多...
| Header: | #include <QCandlestickSeries> |
| In QML: | CandlestickSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
|
|
公共函数
| 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) |
详细说明
该类用作单个K线项的容器。使用QBarCategoryAxis 时，每个项都会被绘制到其所属的类别中。QDateTimeAxis 和QValueAxis 可作为QBarCategoryAxis 的替代方案。在这种情况下，每个K线项将根据其时间戳值进行绘制。
注意： 在同一个 QCandlestickSeries 中，时间戳必须是唯一的。 使用QBarCategoryAxis 时，仅绘制具有相同时间戳的 K 线项中的第一个。如果图表包含多个 QCandlestickSeries 实例，来自不同系列但具有相同时间戳的项将被绘制到同一类别中。使用QValueAxis 或QDateTimeAxis 时，具有相同时间戳的 K 线项将相互重叠。
请参阅“带小部件的图表”图库，了解如何创建K线图。
另请参阅 QCandlestickSet 、QBarCategoryAxis 、QDateTimeAxis 以及QValueAxis 。
属性文档
bodyOutlineVisible : bool
该属性控制K线实体的轮廓可见性。
访问函数：
| 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 : int
该属性存储系列中K线项的数量。
访问函数：
| int | count() const |
通知信号：
| void | countChanged() |
decreasingColor : QColor
该属性用于设置下跌K线实体部分的颜色。
当K线的开盘价高于收盘价时，该K线即为下跌K线。默认情况下，该属性设置为笔刷颜色，且透明度通道设为128。当该属性设置为无效颜色值时，也会使用默认颜色。
访问函数：
| QColor | decreasingColor() const |
| void | setDecreasingColor(const QColor &decreasingColor) |
通知信号：
| void | decreasingColorChanged() |
increasingColor : QColor
该属性用于指定上涨K线实体部分的颜色。
当K线收盘价高于开盘价时，该K线即为上涨K线。默认情况下，该属性设置为画笔颜色。当该属性被设置为无效颜色值时，也会使用默认颜色。
访问函数：
| 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
该属性存储K线项的最小宽度（以像素为单位）。设置负值表示没有最小宽度。所有负值都会转换为-1.0。
访问函数：
| qreal | minimumColumnWidth() const |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
通知信号：
| void | minimumColumnWidthChanged() |
pen : QPen
该属性存储用于绘制K线图元素线条的画笔。
访问函数：
| 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 指定的单个K线项添加到序列中，并获取其所有权。如果该项为null或已存在于序列中，则不会将其追加。若追加成功，则返回true ；否则返回false 。
bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)
将由sets 指定的K线项目列表添加到该系列中，并接管该列表的所有权。如果列表中的任何项目为null、已属于该系列，或出现在列表中超过一次，则不会进行追加。如果所有项目均成功追加，则返回true ；否则返回false 。
[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()
当K线项主体轮廓的可见性发生变化时，会触发此信号。
注意： 这是属性bodyOutlineVisible 的Notifier 信号。
另请参阅 bodyOutlineVisible 。
[signal] void QCandlestickSeries::bodyWidthChanged()
当K线项的宽度发生变化时，会触发此信号。
注意： 这是属性bodyWidth的通知器 信号。
另请参阅 bodyWidth 。
[signal] void QCandlestickSeries::brushChanged()
当K线项画笔发生变化时，会触发此信号。
注意： 这是属性 `brush`的通知器 信号。
另请参阅 brush 。
[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
当将由sets 指定的K线项添加到序列中时，会发出此信号。
[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
当由sets 指定的K线项目从序列中移除时，会发出此信号。
[signal] void QCandlestickSeries::capsVisibilityChanged()
当K线项“caps”的可见性发生变化时，会触发此信号。
注意： 这是属性 `capsVisible`的通知器 信号。
另请参阅 capsVisible 。
[signal] void QCandlestickSeries::capsWidthChanged()
当K线控件的宽度发生变化时，会触发此信号。
注意： 这是属性capsWidth的通知器 信号。
另请参阅 capsWidth 。
void QCandlestickSeries::clear()
从该系列中移除所有K线图项，并将其永久删除。
[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)
当在图表上单击由set 指定的K线对象时，将触发此信号。
int QCandlestickSeries::count() const
返回该序列中K线项的数量。
注意： 这是属性 count 的获取 函数。
[signal] void QCandlestickSeries::countChanged()
当该序列中的K线项数量发生变化时，将发出此信号。
注意： 这是属性count的通知器 信号。
另请参阅 count 。
[signal] void QCandlestickSeries::decreasingColorChanged()
当K线元素的颜色变浅时，会触发此信号。
注意： 这是属性 `decreasingColor`的通知器 信号。
另请参阅 decreasingColor 。
[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)
当在图表上双击由set 指定的K线对象时，会触发此信号。
[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)
当鼠标悬停在图表中由 `set ` 指定的K线项目上时，会触发此信号。
当鼠标移至该元素上方时，status 变为true 状态；当鼠标移开时，它又变为false 状态。
[signal] void QCandlestickSeries::increasingColorChanged()
当K线对象的颜色发生变化时，将触发此信号。
注意： 这是属性increasingColor的通知器 信号。
另请参阅 increasingColor 。
bool QCandlestickSeries::insert(int index, QCandlestickSet *set)
将由set 指定的K线图项插入到由index 指定的位置处的系列中。获取该图项的所有权。如果该图项为null或已属于该系列，则不进行插入。若插入成功，返回true ；否则返回false 。
[signal] void QCandlestickSeries::maximumColumnWidthChanged()
当K线项的最大列宽发生变化时，将发出此信号。
注意： 这是属性maximumColumnWidth的通知器 信号。
另请参阅 maximumColumnWidth 。
[signal] void QCandlestickSeries::minimumColumnWidthChanged()
当K线项的最小列宽发生变化时，会发出此信号。
注意： 这是属性minimumColumnWidth 的Notifier 信号。
另请参阅 minimumColumnWidth 。
[signal] void QCandlestickSeries::penChanged()
当K线控件的笔触发生变化时，会触发此信号。
注意： 此为属性pen的通知 信号。
另请参阅 pen 。
[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)
当用户点击由set 指定的K线项并按住鼠标按钮时，会发出此信号。
[signal] void QCandlestickSeries::released(QCandlestickSet *set)
当用户松开鼠标按钮，且该按钮所点击的K线对象由set 指定时，将触发此信号。
bool QCandlestickSeries::remove(QCandlestickSet *set)
从序列中删除一个由set 指定的K线项。如果项已成功删除，则返回true ；否则返回false 。
bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)
从序列中移除由sets 指定的K线项目列表。如果列表中的任何项目为null、已被从序列中移除，或出现在列表中超过一次，则不会移除任何项目。如果所有项目均已成功移除，则返回true ；否则返回false 。
QList<QCandlestickSet *> QCandlestickSeries::sets() const
返回该序列中的K线项列表。这些项的所有权不会发生变化。
bool QCandlestickSeries::take(QCandlestickSet *set)
从系列中获取一个由set 指定的K线项。不会删除该项。如果获取操作成功，则返回true ；否则返回false 。
注意：该 系列仍为该烛线项的父对象。若要完全拥有该烛线项，必须将父对象设置为该烛线项。
[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const
重新实现了属性QAbstractSeries::type 的访问函数。
返回序列的类型（QAbstractSeries::SeriesTypeCandlestick ）。
© 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.
