Qt编写自定义控件48-面板窗体控件

liudianwu

一、前言
很多时候需要有一个控件，能够替代容器控件，自动容纳多个widget，自适应宽高，然后提供滚动条功能，这就必然需要用到QScrollArea控件，可设置各个子面板的间距等，也在很多系统中用到，比如温湿度设备面板，有几百个温湿度设备，需要一个容器放置，自动产生滚动条，可以设置面板的固定宽高或者自适应拉伸，其实就是放了表格布局+弹簧来设置。
在后期的Qt内置控件的研究过程中，发现QListWidget也提供了类似的功能，所以后期有部分应用场景直接采用QListWidget来做。


二、实现的功能
* 1:可设置标题栏文字/高度/字体/对齐方式/颜色
* 2:可设置边框宽度/边框圆角角度/边框颜色
* 3:可设置报警颜色切换间隔/报警加深颜色/报警普通颜色
* 4:可设置启用状态和禁用状态时文字和边框颜色

三、效果图



四、头文件代码

1. #ifndef PANELFRAME_H
   
2. #define PANELFRAME_H
   
3. 
   
4. /**
   
5. * 面板区域控件 作者:feiyangqingyun(QQ:517216493) 2017-10-21
   
6. * 1:可设置标题栏文字/高度/字体/对齐方式/颜色
   
7. * 2:可设置边框宽度/边框圆角角度/边框颜色
   
8. * 3:可设置报警颜色切换间隔/报警加深颜色/报警普通颜色
   
9. * 4:可设置启用状态和禁用状态时文字和边框颜色
   
10. */
    
11. 
    
12. #include <QWidget>
    
13. 
    
14. class QTimer;
    
15. 
    
16. #ifdef quc
    
17. #if (QT_VERSION < QT_VERSION_CHECK(5,7,0))
    
18. #include <QtDesigner/QDesignerExportWidget>
    
19. #else
    
20. #include <QtUiPlugin/QDesignerExportWidget>
    
21. #endif
    
22. 
    
23. class QDESIGNER_WIDGET_EXPORT PanelItem : public QWidget
    
24. #else
    
25. class PanelItem : public QWidget
    
26. #endif
    
27. 
    
28. {
    
29.     Q_OBJECT
    
30.     Q_ENUMS(Alignment)
    
31. 
    
32.     Q_PROPERTY(int titleHeight READ getTitleHeight WRITE setTitleHeight)
    
33.     Q_PROPERTY(QString titleText READ getTitleText WRITE setTitleText)
    
34.     Q_PROPERTY(QFont titleFont READ getTitleFont WRITE setTitleFont)
    
35.     Q_PROPERTY(Alignment titleAlignment READ getTitleAlignment WRITE setTitleAlignment)
    
36.     Q_PROPERTY(QColor titleColor READ getTitleColor WRITE setTitleColor)
    
37.     Q_PROPERTY(QColor titleDisableColor READ getTitleDisableColor WRITE setTitleDisableColor)
    
38. 
    
39.     Q_PROPERTY(int borderWidth READ getBorderWidth WRITE setBorderWidth)
    
40.     Q_PROPERTY(int borderRadius READ getBorderRadius WRITE setBorderRadius)
    
41.     Q_PROPERTY(QColor borderColor READ getBorderColor WRITE setBorderColor)
    
42.     Q_PROPERTY(QColor borderDisableColor READ getBorderDisableColor WRITE setBorderDisableColor)
    
43. 
    
44.     Q_PROPERTY(int alarmInterval READ getAlarmInterval WRITE setAlarmInterval)
    
45.     Q_PROPERTY(QColor alarmTextColor READ getAlarmTextColor WRITE setAlarmTextColor)
    
46.     Q_PROPERTY(QColor alarmDarkColor READ getAlarmDarkColor WRITE setAlarmDarkColor)
    
47.     Q_PROPERTY(QColor alarmNormalColor READ getAlarmNormalColor WRITE setAlarmNormalColor)
    
48. 
    
49.     Q_PROPERTY(bool isAlarm READ getIsAlarm WRITE setAlarm)
    
50.     Q_PROPERTY(bool isEnable READ getIsEnable WRITE setEnable)
    
51. 
    
52. public:
    
53.     enum Alignment {
    
54.         Alignment_Left = 0,     //左对齐
    
55.         Alignment_Center = 1,   //居中对齐
    
56.         Alignment_Right = 2     //右对齐
    
57.     };
    
58. 
    
59.     explicit PanelItem(QWidget *parent = 0);
    
60.     ~PanelItem();
    
61. 
    
62. protected:
    
63.     void paintEvent(QPaintEvent *);
    
64.     void drawBorder(QPainter *painter);
    
65.     void drawTitle(QPainter *painter);
    
66. 
    
67. private:
    
68.     int titleHeight;                //标题高度
    
69.     QString titleText;              //标题文字
    
70.     QFont titleFont;                //标题字体
    
71.     Alignment titleAlignment;       //标题对齐方式
    
72.     QColor titleColor;              //标题颜色
    
73.     QColor titleDisableColor;       //禁用状态下文字颜色
    
74. 
    
75.     int borderWidth;                //边框宽度
    
76.     int borderRadius;               //边框圆角角度
    
77.     QColor borderColor;             //边框颜色
    
78.     QColor borderDisableColor;      //禁用状态下边框颜色
    
79. 
    
80.     int alarmInterval;              //报警切换间隔
    
81.     QColor alarmTextColor;          //报警文字颜色
    
82.     QColor alarmDarkColor;          //报警加深颜色
    
83.     QColor alarmNormalColor;        //报警普通颜色
    
84. 
    
85.     bool isAlarm;                   //是否报警
    
86.     bool isEnable;                  //是否启用
    
87. 
    
88.     bool isDark;                    //是否加深
    
89.     QColor tempColor;               //临时颜色
    
90.     QTimer *timer;                  //报警切换定时器
    
91. 
    
92. public:
    
93.     int getTitleHeight()            const;
    
94.     QString getTitleText()          const;
    
95.     QFont getTitleFont()            const;
    
96.     Alignment getTitleAlignment()   const;
    
97.     QColor getTitleColor()          const;
    
98.     QColor getTitleDisableColor()   const;
    
99. 
    
100.     int getBorderWidth()            const;
     
101.     int getBorderRadius()           const;
     
102.     QColor getBorderColor()         const;
     
103.     QColor getBorderDisableColor()  const;
     
104. 
     
105.     int getAlarmInterval()          const;
     
106.     QColor getAlarmTextColor()      const;
     
107.     QColor getAlarmDarkColor()      const;
     
108.     QColor getAlarmNormalColor()    const;
     
109. 
     
110.     bool getIsAlarm()               const;
     
111.     bool getIsEnable()              const;
     
112. 
     
113.     QSize sizeHint()                const;
     
114.     QSize minimumSizeHint()         const;
     
115. 
     
116. private slots:
     
117.     void checkAlarm();
     
118. 
     
119. public Q_SLOTS:
     
120.     //设置报警状态
     
121.     void setAlarm(bool alarm);
     
122.     //设置启用状态
     
123.     void setEnable(bool enable);
     
124. 
     
125.     //设置标题栏高度
     
126.     void setTitleHeight(int titleHeight);
     
127.     //设置标题文字
     
128.     void setTitleText(const QString &titleText);
     
129.     //设置标题字体
     
130.     void setTitleFont(const QFont &titleFont);
     
131.     //设置标题文字对齐方式
     
132.     void setTitleAlignment(const Alignment &titleAlignment);
     
133.     //设置标题文字颜色
     
134.     void setTitleColor(const QColor &titleColor);
     
135.     //设置禁用状态下标题文字颜色
     
136.     void setTitleDisableColor(const QColor &titleDisableColor);
     
137. 
     
138.     //设置边框宽度
     
139.     void setBorderWidth(int borderWidth);
     
140.     //设置边框圆角角度
     
141.     void setBorderRadius(int borderRadius);
     
142.     //设置边框颜色
     
143.     void setBorderColor(const QColor &borderColor);
     
144.     //设置禁用状态下边框颜色
     
145.     void setBorderDisableColor(const QColor &borderDisableColor);
     
146. 
     
147.     //设置报警切换间隔
     
148.     void setAlarmInterval(int alarmInterval);
     
149.     //设置报警文字颜色
     
150.     void setAlarmTextColor(const QColor &alarmTextColor);
     
151.     //设置报警加深颜色
     
152.     void setAlarmDarkColor(const QColor &alarmDarkColor);
     
153.     //设置报警普通颜色
     
154.     void setAlarmNormalColor(const QColor &alarmNormalColor);
     
155. 
     
156. };
     
157. 
     
158. #endif // PANELFRAME_H
     

复制代码

五、核心代码

1. void PanelItem::paintEvent(QPaintEvent *)
   
2. {
   
3.     //绘制准备工作,启用反锯齿
   
4.     QPainter painter(this);
   
5.     painter.setRenderHints(QPainter::Antialiasing | QPainter::TextAntialiasing);
   
6. 
   
7.     //绘制边框
   
8.     drawBorder(&painter);
   
9.     //绘制标题
   
10.     drawTitle(&painter);
    
11. }
    
12. 
    
13. void PanelItem::drawBorder(QPainter *painter)
    
14. {
    
15.     if (borderWidth <= 0) {
    
16.         return;
    
17.     }
    
18. 
    
19.     painter->save();
    
20. 
    
21.     QPen pen;
    
22.     pen.setWidth(borderWidth);
    
23.     pen.setColor(tempColor);
    
24. 
    
25.     painter->setPen(pen);
    
26.     painter->setBrush(Qt::NoBrush);
    
27.     QRect rect(borderWidth / 2, borderWidth / 2, width() - borderWidth, height() - borderWidth);
    
28.     painter->drawRoundedRect(rect, borderRadius, borderRadius);
    
29. 
    
30.     painter->restore();
    
31. }
    
32. 
    
33. void PanelItem::drawTitle(QPainter *painter)
    
34. {
    
35.     painter->save();
    
36. 
    
37.     painter->setPen(Qt::NoPen);
    
38.     painter->setBrush(tempColor);
    
39. 
    
40.     int offset = borderWidth - borderWidth / 3;
    
41.     QRect rect(offset, offset, width() - offset * 2, titleHeight);
    
42.     painter->drawRect(rect);
    
43. 
    
44.     //绘制标题文字
    
45.     if (isEnable) {
    
46.         painter->setPen(isAlarm ? alarmTextColor : titleColor);
    
47.     } else {
    
48.         painter->setPen(titleDisableColor);
    
49.     }
    
50. 
    
51.     painter->setFont(titleFont);
    
52. 
    
53.     //文字区域要重新计算
    
54.     offset = borderWidth * 3;
    
55.     QRect textRect(offset, 0, width() - offset * 2, titleHeight);
    
56. 
    
57.     Qt::Alignment align;
    
58.     if (titleAlignment == Alignment_Left) {
    
59.         align = Qt::AlignLeft | Qt::AlignVCenter;
    
60.     } else if (titleAlignment == Alignment_Center) {
    
61.         align = Qt::AlignHCenter | Qt::AlignVCenter;
    
62.     } else if (titleAlignment == Alignment_Right) {
    
63.         align = Qt::AlignRight | Qt::AlignVCenter;
    
64.     }
    
65. 
    
66.     painter->drawText(textRect, align, titleText);
    
67. 
    
68.     painter->restore();
    
69. }

复制代码

六、控件介绍
1. 超过150个精美控件，涵盖了各种仪表盘、进度条、进度球、指南针、曲线图、标尺、温度计、导航条、导航栏，flatui、高亮按钮、滑动选择器、农历等。远超qwt集成的控件数量。
2. 每个类都可以独立成一个单独的控件，零耦合，每个控件一个头文件和一个实现文件，不依赖其他文件，方便单个控件以源码形式集成到项目中，较少代码量。qwt的控件类环环相扣，高度耦合，想要使用其中一个控件，必须包含所有的代码。
3. 全部纯Qt编写，QWidget+QPainter绘制，支持Qt4.6到Qt5.12的任何Qt版本，支持mingw、msvc、gcc等编译器，支持任意操作系统比如windows+linux+mac+嵌入式linux等，不乱码，可直接集成到Qt  Creator中，和自带的控件一样使用，大部分效果只要设置几个属性即可，极为方便。
4. 每个控件都有一个对应的单独的包含该控件源码的DEMO，方便参考使用。同时还提供一个所有控件使用的集成的DEMO。
5. 每个控件的源代码都有详细中文注释，都按照统一设计规范编写，方便学习自定义控件的编写。
6. 每个控件默认配色和demo对应的配色都非常精美。
7. 超过130个可见控件，6个不可见控件。
8. 部分控件提供多种样式风格选择，多种指示器样式选择。
9. 所有控件自适应窗体拉伸变化。
10. 集成自定义控件属性设计器，支持拖曳设计，所见即所得，支持导入导出xml格式。
11. 自带activex控件demo，所有控件可以直接运行在ie浏览器中。
12. 集成fontawesome图形字体+阿里巴巴iconfont收藏的几百个图形字体，享受图形字体带来的乐趣。
13. 所有控件最后生成一个动态库文件(dll或者so等)，可以直接集成到qtcreator中拖曳设计使用。
14. 目前已经有qml版本，后期会考虑出pyqt版本，如果用户需求量很大的话。
15. 自定义控件插件开放动态库使用（永久免费），无任何后门和限制，请放心使用。
16. 目前已提供26个版本的dll，其中包括了qt5.12.3 msvc2017 32+64 mingw 32+64 的。
17. 不定期增加控件和完善控件，不定期更新SDK，欢迎各位提出建议，谢谢！
18. Qt入门书籍推荐霍亚飞的《Qt Creator快速入门》《Qt5编程入门》，Qt进阶书籍推荐官方的《C++ GUI Qt4编程》。
19. 强烈推荐程序员自我修养和规划系列书《大话程序员》《程序员的成长课》《解忧程序员》，受益匪浅，受益终生！  
20. SDK下载链接：https://pan.baidu.com/s/1A5Gd77kExm8Co5ckT51vvQ 提取码：877p
21. 下载链接中包含了各个版本的动态库文件，所有控件的头文件，使用demo，自定义控件+属性设计器。
22. widget版本（QQ：517216493）qml版本（QQ：373955953）三峰驼（QQ：278969898）。
23. 涛哥的知乎专栏 Qt进阶之路 https://zhuanlan.zhihu.com/TaoQt
24. 欢迎关注微信公众号【高效程序员】，C++/Python、学习方法、写作技巧、热门技术、职场发展等内容，干货多多，福利多多！