Qt5官方demo解析集36——Wiggly Example

接上文Qt5官方demo解析集35——Music Player

今天同样带来一个有趣的小例子，如下图所示，我们输入的文字将在中央窗口显示并以正弦波形浮动。

这个例子中涉及到 Qt 定时器族中的 QBasicTimer 类以及十分实用的 QFontMetrics 类。

当我们将应用部署在移动设备上时，Qt 将为该应用添加 "-small-screen" 的命令行参数。因此，通过判断该参数是否存在，我们就可以为这个应用选择不同的显示模式，如同该 demo 中 main() 函数所示：

[cpp]  view plain copy

1. #include <QApplication>  
2.   
3. #include "dialog.h"  
4.   
5. int main(int argc, char *argv[])  
6. {  
7.     QApplication app(argc, argv);  
8.     bool smallScreen = QApplication::arguments().contains("-small-screen");  
9.   
10.   
11.     Dialog dialog(0, smallScreen);  
12.   
13.     if (!smallScreen)         // 如果不是smallScreen直接显示，否则全屏显示  
14.         dialog.show();  
15.     else  
16.         dialog.showFullScreen();  
17.     return app.exec();  
18. }  

Dialog 类继承自 QDialog，使用垂直布局添加了中心窗口以及输入框，并将输入框的 textChanged(QString) 信号连接到中心窗口的 setText(QString) 槽函数上。

接着看看我们的wigglywidget.h:

[cpp]  view plain copy

1. #include <QBasicTimer>  
2. #include <QWidget>  
3.   
4. //! [0]  
5. class WigglyWidget : public QWidget  
6. {  
7.     Q_OBJECT  
8.   
9. public:  
10.     WigglyWidget(QWidget *parent = 0);  
11.   
12. public slots:  
13.     void setText(const QString &newText) { text = newText; } // 当输入框中文字变换该槽函数被执行，由于窗口每60毫秒刷新一次，因此无需调用update()  
14.   
15. protected:  
16.     void paintEvent(QPaintEvent *event);  
17.     void timerEvent(QTimerEvent *event);  
18.   
19. private:  
20.     QBasicTimer timer;  
21.     QString text;  
22.     int step;  
23. };  

QBasicTimer 是一个快速、轻量级的定时器类，适合在嵌入式系统等对性能要求较高的环境下使用。

它不像 QTimer 一样继承自 QObject，因此不具有使用信号槽的能力，

但我们可以使用它为 QObject 及其派生类对象重复发送 QTimerEvent 事件，通过重载 timerEvent(QTimerEvent*) 以捕获该事件。

wigglywidget.cpp:

[cpp]  view plain copy

1. #include <QtWidgets>  
2.   
3. #include "wigglywidget.h"  
4.   
5. //! [0]  
6. WigglyWidget::WigglyWidget(QWidget *parent)  
7.     : QWidget(parent)  
8. {  
9.     setBackgroundRole(QPalette::Midlight);  // 设置背景色为亮白  
10.     setAutoFillBackground(true);   // 记得设置该属性为true  
11.   
12.     QFont newFont = font();        // 然后获取该窗口的字体对象  
13.     newFont.setPointSize(newFont.pointSize() + 20);    // 增大20号  
14.     setFont(newFont);  
15.   
16.     step = 0;  
17.     timer.start(60, this);        // 开启定时器，间隔60毫秒  
18. }  
19. //! [0]  
20.   
21. //! [1]  
22. void WigglyWidget::paintEvent(QPaintEvent * /* event */)  
23. //! [1] //! [2]  
24. {  
25.     static const int sineTable[16] = {       // 正弦波形的 y 值抽样数组  
26.         0, 38, 71, 92, 100, 92, 71, 38, 0, -38, -71, -92, -100, -92, -71, -38  
27.     };  
28.   
29.     QFontMetrics metrics(font());           // 使用当前窗体的字体初始化QFontMetrics  
30.     int x = (width() - metrics.width(text)) / 2;      // 通过metrics得到显示文本的信息，使文本居中显示  
31.     int y = (height() + metrics.ascent() - metrics.descent()) / 2;  // 关于ascent 与 descent，我们在下面解释  
32.     QColor color;  
33. //! [2]  
34.   
35. //! [3]  
36.     QPainter painter(this);  
37. //! [3] //! [4]  
38.     for (int i = 0; i < text.size(); ++i) {     // 获取text中字符个数并循环  
39.         int index = (step + i) % 16;  
40.         color.setHsv((15 - index) * 16, 255, 191); // 使用HSV设置每个字符的颜色值，三个参数分别代表色调，饱和度，亮度  
41.         painter.setPen(color);  
42.         painter.drawText(x, y - ((sineTable[index] * metrics.height()) / 400),  // 400用来控制正弦波形的幅度，数值越大波动越小  
43.                          QString(text[i]));  
44.         x += metrics.width(text[i]);         // 以当前字符宽度增加 x 的值  
45.     }  
46. }  
47. //! [4]  
48.   
49. //! [5]  
50. void WigglyWidget::timerEvent(QTimerEvent *event)  
51. //! [5] //! [6]  
52. {  
53.     if (event->timerId() == timer.timerId()) {   // 我们通过timerId来判断这个timerEvent是不是由我们定义的定时器触发  
54.         ++step;                                    
55.         update();                     // 刷新显示  
56.     } else {  
57.         QWidget::timerEvent(event);    // 如果不是则将该事件继续下发  
58.     }  
59. //! [6]  
60. }  

大家一定记得当我们使用Qt绘制图形时，类似drawRect()什么的，我们输入的位置坐标即是该图像左上角所在的位置，简直是指哪打哪~

但使用drawText()时呢，又好像不是这样了。似乎文本的原点变成了左下角，但是还是感觉差点意思？如果你对这点有些疑惑的话，可以看看下面这张图，没错，图中的Origin才是我们真正的文本原点。它是Baseline与文本左侧的交汇处。

有了这张图，Ascent与Descent也就很明显了，它们分别是文本最上方和最下方与Baseline之间的距离。

[cpp]  view plain copy

1. int y = (height() + metrics.ascent() - metrics.descent()) / 2;  

那么这行代码也就很明显了，它得到的正是我们纵向居中显示文本时的Baseline在窗口上的y轴坐标。

如果将这个算式转换成这样，可能就更一目了然了：

int y = metrics.ascent() + ( height() - metrics.ascent() - metrics.descent() ) / 2;

可能我们使用QFontMetrics时会更多的使用它的一些便利函数例如height()之类，

而实际上height()正是等于ascent()+descent()+1，最后的1即是Baseline的宽度。

好了，伴随着跳动的字符，就先到这里吧O(∩_∩)O~