QCandlestickSet、QCandlestickSeries

QCandlestickSet

一、描述

QCandlestickSet 类表示烛台图表中的单个烛台项目。

创建烛台项目的图形表示需要五个值：开盘价、最高价、最低价、收盘价和时间戳。

二、属性成员

1、brush : QBrush

用于填充烛台项目的画刷。

2、pen : QPen

用于绘制烛台项目线条的画笔。

3、high : qreal、low : qreal、open : qreal、close : qreal、timestamp : qreal

最高价、最低价、开盘价、收盘价、时间戳。

三、成员函数

1、【信号】void clicked()

单击烛台项目时会发出此信号。

2、【信号】void doubleClicked()

双击烛台项目时发出此信号。

3、【信号】void hovered(bool status)

当鼠标悬停在烛台项目上时，会发出此信号。

当鼠标移到项目上时，status 为 true，当鼠标再次移开时，status 为 false。

4、【信号】void pressed() 

单击烛台项目并按住鼠标按钮时，会发出此信号。

5、【信号】void released()

在烛台项目上释放鼠标按下时，会发出此信号。

---

QCandlestickSeries

一、描述

烛台图，继承自 QAbstractSeries。

当使用 QBarCategoryAxis 作为轴时，每个项目都被绘制到自己的类别中。

当使用 QDateTimeAxis 和 QValueAxis 作为轴时。每个烛台项目都是根据其时间戳值绘制的。

注意：时间戳在 QCandlestickSeries 中必须是唯一的。使用 QBarCategoryAxis 时，仅绘制共享时间戳的第一个烛台项目。如果图表包含多个烛台图，则来自不同曲线的共享时间戳的项目将被绘制到同一类别。使用 QValueAxis 或 QDateTimeAxis 时，共享时间戳的烛台项目将相互重叠。

二、属性成员

1、bodyOutlineVisible : bool

烛台主体轮廓的可见性。

2、bodyWidth : qreal

烛台项目在其自己的槽内的相对宽度，范围从 0.0 到 1.0。

3、brush : QBrush

用于填充烛台项目的画刷。

4、capsVisible : bool

顶部的可见性。下图是 false 和 true 的对比。

5、capsWidth : qreal

顶部相对宽度，范围为 0.0 到 1.0。下图是1.0 和 0.2 的对比。

6、【只读】count : const int

曲线中烛台项目的数量。

7、decreasingColor : QColor

下降烛台项目主体的颜色。当烛台的开盘价高于收盘价时，烛台为下降。

默认情况下，此属性设置为 Alpha 通道设置为 128 的画刷颜色。当属性设置为无效颜色值时，也会使用默认颜色。

8、increasingColor : QColor

上升烛台项目主体的颜色。当烛台的收盘价高于开盘价时，烛台为上升。

默认情况下，此属性设置为画笔颜色。 当属性设置为无效颜色值时，也会使用默认颜色。

此图的上升颜色为红色，下降颜色为绿色。

9、maximumColumnWidth : qreal、minimumColumnWidth : qreal

烛台项目的最大宽度、最小宽度（像素）。设置负值意味着没有最大宽度。所有负值都转换为 -1.0。

10、pen : QPen

用于绘制烛台项目线条的画笔。

三、成员函数

1、【信号】void candlestickSetsAdded(const QList<QCandlestickSet *> &sets)

当烛台项目添加到曲线时，会发出此信号。

2、【信号】void candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)

当从曲线中移除指定的烛台项目时，将发出此信号。

3、【信号】void clicked(QCandlestickSet *set)

当在图表上单击 set 指定的烛台项目时发出此信号。

4、【信号】void doubleClicked(QCandlestickSet *set)

当在图表上双击 set 指定的烛台项目时发出此信号。

5、【信号】void hovered(bool status, QCandlestickSet *set)

当鼠标悬停在图表中由 set 指定的烛台项目上时，会发出此信号。

当鼠标移到项目上时，status 为 true，当鼠标再次移开时，status 为 false。

6、【信号】void pressed(QCandlestickSet *set)

当用户单击 set 指定的烛台项目并按住鼠标按钮时，会发出此信号。

7、【信号】void released(QCandlestickSet *set)

当用户在 set 指定的烛台项目上释放鼠标按下时，会发出此信号。

8、bool append(QCandlestickSet *set)

      bool append(const QList<QCandlestickSet *> &sets)

将烛台项目添加到曲线并获得其所有权。

9、void clear()

从曲线中移除所有烛台项目并永久删除它们。

10、bool insert(int index, QCandlestickSet *set)

将 set 指定的烛台项目插入到 index 指定位置的曲线中。取得项目的所有权。

11、bool remove(QCandlestickSet *set)

       bool remove(const QList<QCandlestickSet *> &sets)

从曲线中移除烛台项目。

12、QList<QCandlestickSet *> sets()

返回曲线中烛台项目的列表。

13、bool take(QCandlestickSet *set)

从曲线中获取单个烛台项目。该曲线仍然是项目的父对象。