找回密码
 立即注册
收起左侧

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

0
回复
120
查看
[复制链接]
累计签到:7 天
连续签到:1 天
来源: 2019-8-11 11:27:38 显示全部楼层 |阅读模式

马上注册,查看详细内容!注册请先查看:注册须知

您需要 登录 才可以下载或查看,没有帐号?立即注册

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


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

三、效果图



四、头文件代码
  1. #ifndef PANELFRAME_H
  2. #define PANELFRAME_H

  3. /**
  4. * 面板区域控件 作者:feiyangqingyun(QQ:517216493) 2017-10-21
  5. * 1:可设置标题栏文字/高度/字体/对齐方式/颜色
  6. * 2:可设置边框宽度/边框圆角角度/边框颜色
  7. * 3:可设置报警颜色切换间隔/报警加深颜色/报警普通颜色
  8. * 4:可设置启用状态和禁用状态时文字和边框颜色
  9. */

  10. #include <QWidget>

  11. class QTimer;

  12. #ifdef quc
  13. #if (QT_VERSION < QT_VERSION_CHECK(5,7,0))
  14. #include <QtDesigner/QDesignerExportWidget>
  15. #else
  16. #include <QtUiPlugin/QDesignerExportWidget>
  17. #endif

  18. class QDESIGNER_WIDGET_EXPORT PanelItem : public QWidget
  19. #else
  20. class PanelItem : public QWidget
  21. #endif

  22. {
  23.     Q_OBJECT
  24.     Q_ENUMS(Alignment)

  25.     Q_PROPERTY(int titleHeight READ getTitleHeight WRITE setTitleHeight)
  26.     Q_PROPERTY(QString titleText READ getTitleText WRITE setTitleText)
  27.     Q_PROPERTY(QFont titleFont READ getTitleFont WRITE setTitleFont)
  28.     Q_PROPERTY(Alignment titleAlignment READ getTitleAlignment WRITE setTitleAlignment)
  29.     Q_PROPERTY(QColor titleColor READ getTitleColor WRITE setTitleColor)
  30.     Q_PROPERTY(QColor titleDisableColor READ getTitleDisableColor WRITE setTitleDisableColor)

  31.     Q_PROPERTY(int borderWidth READ getBorderWidth WRITE setBorderWidth)
  32.     Q_PROPERTY(int borderRadius READ getBorderRadius WRITE setBorderRadius)
  33.     Q_PROPERTY(QColor borderColor READ getBorderColor WRITE setBorderColor)
  34.     Q_PROPERTY(QColor borderDisableColor READ getBorderDisableColor WRITE setBorderDisableColor)

  35.     Q_PROPERTY(int alarmInterval READ getAlarmInterval WRITE setAlarmInterval)
  36.     Q_PROPERTY(QColor alarmTextColor READ getAlarmTextColor WRITE setAlarmTextColor)
  37.     Q_PROPERTY(QColor alarmDarkColor READ getAlarmDarkColor WRITE setAlarmDarkColor)
  38.     Q_PROPERTY(QColor alarmNormalColor READ getAlarmNormalColor WRITE setAlarmNormalColor)

  39.     Q_PROPERTY(bool isAlarm READ getIsAlarm WRITE setAlarm)
  40.     Q_PROPERTY(bool isEnable READ getIsEnable WRITE setEnable)

  41. public:
  42.     enum Alignment {
  43.         Alignment_Left = 0,     //左对齐
  44.         Alignment_Center = 1,   //居中对齐
  45.         Alignment_Right = 2     //右对齐
  46.     };

  47.     explicit PanelItem(QWidget *parent = 0);
  48.     ~PanelItem();

  49. protected:
  50.     void paintEvent(QPaintEvent *);
  51.     void drawBorder(QPainter *painter);
  52.     void drawTitle(QPainter *painter);

  53. private:
  54.     int titleHeight;                //标题高度
  55.     QString titleText;              //标题文字
  56.     QFont titleFont;                //标题字体
  57.     Alignment titleAlignment;       //标题对齐方式
  58.     QColor titleColor;              //标题颜色
  59.     QColor titleDisableColor;       //禁用状态下文字颜色

  60.     int borderWidth;                //边框宽度
  61.     int borderRadius;               //边框圆角角度
  62.     QColor borderColor;             //边框颜色
  63.     QColor borderDisableColor;      //禁用状态下边框颜色

  64.     int alarmInterval;              //报警切换间隔
  65.     QColor alarmTextColor;          //报警文字颜色
  66.     QColor alarmDarkColor;          //报警加深颜色
  67.     QColor alarmNormalColor;        //报警普通颜色

  68.     bool isAlarm;                   //是否报警
  69.     bool isEnable;                  //是否启用

  70.     bool isDark;                    //是否加深
  71.     QColor tempColor;               //临时颜色
  72.     QTimer *timer;                  //报警切换定时器

  73. public:
  74.     int getTitleHeight()            const;
  75.     QString getTitleText()          const;
  76.     QFont getTitleFont()            const;
  77.     Alignment getTitleAlignment()   const;
  78.     QColor getTitleColor()          const;
  79.     QColor getTitleDisableColor()   const;

  80.     int getBorderWidth()            const;
  81.     int getBorderRadius()           const;
  82.     QColor getBorderColor()         const;
  83.     QColor getBorderDisableColor()  const;

  84.     int getAlarmInterval()          const;
  85.     QColor getAlarmTextColor()      const;
  86.     QColor getAlarmDarkColor()      const;
  87.     QColor getAlarmNormalColor()    const;

  88.     bool getIsAlarm()               const;
  89.     bool getIsEnable()              const;

  90.     QSize sizeHint()                const;
  91.     QSize minimumSizeHint()         const;

  92. private slots:
  93.     void checkAlarm();

  94. public Q_SLOTS:
  95.     //设置报警状态
  96.     void setAlarm(bool alarm);
  97.     //设置启用状态
  98.     void setEnable(bool enable);

  99.     //设置标题栏高度
  100.     void setTitleHeight(int titleHeight);
  101.     //设置标题文字
  102.     void setTitleText(const QString &titleText);
  103.     //设置标题字体
  104.     void setTitleFont(const QFont &titleFont);
  105.     //设置标题文字对齐方式
  106.     void setTitleAlignment(const Alignment &titleAlignment);
  107.     //设置标题文字颜色
  108.     void setTitleColor(const QColor &titleColor);
  109.     //设置禁用状态下标题文字颜色
  110.     void setTitleDisableColor(const QColor &titleDisableColor);

  111.     //设置边框宽度
  112.     void setBorderWidth(int borderWidth);
  113.     //设置边框圆角角度
  114.     void setBorderRadius(int borderRadius);
  115.     //设置边框颜色
  116.     void setBorderColor(const QColor &borderColor);
  117.     //设置禁用状态下边框颜色
  118.     void setBorderDisableColor(const QColor &borderDisableColor);

  119.     //设置报警切换间隔
  120.     void setAlarmInterval(int alarmInterval);
  121.     //设置报警文字颜色
  122.     void setAlarmTextColor(const QColor &alarmTextColor);
  123.     //设置报警加深颜色
  124.     void setAlarmDarkColor(const QColor &alarmDarkColor);
  125.     //设置报警普通颜色
  126.     void setAlarmNormalColor(const QColor &alarmNormalColor);

  127. };

  128. #endif // PANELFRAME_H
复制代码


五、核心代码
  1. void PanelItem::paintEvent(QPaintEvent *)
  2. {
  3.     //绘制准备工作,启用反锯齿
  4.     QPainter painter(this);
  5.     painter.setRenderHints(QPainter::Antialiasing | QPainter::TextAntialiasing);

  6.     //绘制边框
  7.     drawBorder(&painter);
  8.     //绘制标题
  9.     drawTitle(&painter);
  10. }

  11. void PanelItem::drawBorder(QPainter *painter)
  12. {
  13.     if (borderWidth <= 0) {
  14.         return;
  15.     }

  16.     painter->save();

  17.     QPen pen;
  18.     pen.setWidth(borderWidth);
  19.     pen.setColor(tempColor);

  20.     painter->setPen(pen);
  21.     painter->setBrush(Qt::NoBrush);
  22.     QRect rect(borderWidth / 2, borderWidth / 2, width() - borderWidth, height() - borderWidth);
  23.     painter->drawRoundedRect(rect, borderRadius, borderRadius);

  24.     painter->restore();
  25. }

  26. void PanelItem::drawTitle(QPainter *painter)
  27. {
  28.     painter->save();

  29.     painter->setPen(Qt::NoPen);
  30.     painter->setBrush(tempColor);

  31.     int offset = borderWidth - borderWidth / 3;
  32.     QRect rect(offset, offset, width() - offset * 2, titleHeight);
  33.     painter->drawRect(rect);

  34.     //绘制标题文字
  35.     if (isEnable) {
  36.         painter->setPen(isAlarm ? alarmTextColor : titleColor);
  37.     } else {
  38.         painter->setPen(titleDisableColor);
  39.     }

  40.     painter->setFont(titleFont);

  41.     //文字区域要重新计算
  42.     offset = borderWidth * 3;
  43.     QRect textRect(offset, 0, width() - offset * 2, titleHeight);

  44.     Qt::Alignment align;
  45.     if (titleAlignment == Alignment_Left) {
  46.         align = Qt::AlignLeft | Qt::AlignVCenter;
  47.     } else if (titleAlignment == Alignment_Center) {
  48.         align = Qt::AlignHCenter | Qt::AlignVCenter;
  49.     } else if (titleAlignment == Alignment_Right) {
  50.         align = Qt::AlignRight | Qt::AlignVCenter;
  51.     }

  52.     painter->drawText(textRect, align, titleText);

  53.     painter->restore();
  54. }
复制代码


六、控件介绍
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、学习方法、写作技巧、热门技术、职场发展等内容,干货多多,福利多多!



回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册