一、前言这个控件一开始打算用样式表来实现,经过初步的探索,后面发现还是不够智能以及不能完全满足需求,比如要在此控件设置多个角标,这个用QSS就很难实现,后面才慢慢研究用QPainter来绘制,我记得当时接到这个定制控件任务的时候是2016年,那时候对QPainter的使用还不是很熟悉,也就是从此控件开始,逐步研究QPainter的绘制,把所有的内置函数都使用一遍,最终用的越来越熟悉,使得后来到了心中有坐标,万物皆painter的境界,可能就像武林中所说的打通了任督二脉吧。
本控件除了可以设置常规的圆角角度,边框宽度,边框颜色,正常颜色,按下颜色以外,还可以设置各个角标和正文文字内容/字体/对齐方式/颜色,同时还要提供三种颜色展示模式,松开按下两种颜色,按下松开颜色上下交替,按下松开颜色渐变交替。QLinearGradient是个好东西,各种颜色交替效果全靠它来实现。
二、实现的功能 * 1:可设置圆角角度,边框宽度
* 2:可设置角标和正文文字内容/字体/对齐方式/颜色
* 3:可设置边框颜色,正常颜色,按下颜色
* 4:可设置背景
图片 * 5:可设置
按钮颜色模式
三、效果图四、头文件代码- #ifndef COLORBUTTON_H
- #define COLORBUTTON_H
- /**
- * 多样式超级按钮控件 作者:feiyangqingyun(QQ:517216493) 2017-9-24
- * 1:可设置圆角角度,边框宽度
- * 2:可设置角标和正文文字内容/字体/对齐方式/颜色
- * 3:可设置边框颜色,正常颜色,按下颜色
- * 4:可设置背景图片
- * 5:可设置按钮颜色模式
- */
- #include <QWidget>
- #ifdef quc
- #if (QT_VERSION < QT_VERSION_CHECK(5,7,0))
- #include <QtDesigner/QDesignerExportWidget>
- #else
- #include <QtUiPlugin/QDesignerExportWidget>
- #endif
- class QDESIGNER_WIDGET_EXPORT ColorButton : public QWidget
- #else
- class ColorButton : public QWidget
- #endif
- {
- Q_OBJECT
- Q_ENUMS(ColorMode)
- Q_ENUMS(TextAlign)
- Q_PROPERTY(int borderRadius READ getBorderRadius WRITE setBorderRadius)
- Q_PROPERTY(int borderWidth READ getBorderWidth WRITE setBorderWidth)
- Q_PROPERTY(QColor borderColor READ getBorderColor WRITE setBorderColor)
- Q_PROPERTY(bool showSuperText READ getShowSuperText WRITE setShowSuperText)
- Q_PROPERTY(QString superText READ getSuperText WRITE setSuperText)
- Q_PROPERTY(QFont superTextFont READ getSuperTextFont WRITE setSuperTextFont)
- Q_PROPERTY(TextAlign superTextAlign READ getSuperTextAlign WRITE setSuperTextAlign)
- Q_PROPERTY(QColor superTextColor READ getSuperTextColor WRITE setSuperTextColor)
- Q_PROPERTY(QString text READ getText WRITE setText)
- Q_PROPERTY(QFont textFont READ getTextFont WRITE setTextFont)
- Q_PROPERTY(TextAlign textAlign READ getTextAlign WRITE setTextAlign)
- Q_PROPERTY(QColor textColor READ getTextColor WRITE setTextColor)
- Q_PROPERTY(QColor normalColor READ getNormalColor WRITE setNormalColor)
- Q_PROPERTY(QColor pressedColor READ getPressedColor WRITE setPressedColor)
- Q_PROPERTY(bool canMove READ getCanMove WRITE setCanMove)
- Q_PROPERTY(QPixmap bgImage READ getBgImage WRITE setBgImage)
- Q_PROPERTY(ColorMode colorMode READ getColorMode WRITE setColorMode)
- public:
- enum ColorMode {
- ColorMode_Normal = 0, //松开按下两种颜色
- ColorMode_Replace = 1, //按下松开颜色上下交替
- ColorMode_Shade = 2 //按下松开颜色渐变交替
- };
- enum TextAlign {
- TextAlign_Top_Left = 0,
- TextAlign_Top_Center = 1,
- TextAlign_Top_Right = 2,
- TextAlign_Center_Left = 3,
- TextAlign_Center_Center = 4,
- TextAlign_Center_Right = 5,
- TextAlign_Bottom_Left = 6,
- TextAlign_Bottom_Center = 7,
- TextAlign_Bottom_Right = 8
- };
- explicit ColorButton(QWidget *parent = 0);
- protected:
- void mousePressEvent(QMouseEvent *);
- protected:
- bool eventFilter(QObject *watched, QEvent *event);
- void paintEvent(QPaintEvent *);
- void drawBg(QPainter *painter);
- void drawText(QPainter *painter);
- private:
- int borderRadius; //圆角半径
- int borderWidth; //边框宽度
- QColor borderColor; //边框颜色
- bool showSuperText; //显示角标
- QString superText; //角标文字
- QFont superTextFont; //角标文字字体
- TextAlign superTextAlign; //角标文字对齐方式
- QColor superTextColor; //角标文字颜色
- QString text; //文字
- QFont textFont; //文字字体
- TextAlign textAlign; //文字对齐方式
- QColor textColor; //文字颜色
- QColor normalColor; //正常颜色
- QColor pressedColor; //按下颜色
- bool canMove; //是否能移动
- QPixmap bgImage; //背景图片
- ColorMode colorMode; //背景色模式
- bool isPressed; //是否按下
- public:
- int getBorderRadius() const;
- int getBorderWidth() const;
- QColor getBorderColor() const;
- bool getShowSuperText() const;
- QString getSuperText() const;
- QFont getSuperTextFont() const;
- TextAlign getSuperTextAlign()const;
- QColor getSuperTextColor() const;
- QString getText() const;
- QFont getTextFont() const;
- TextAlign getTextAlign() const;
- QColor getTextColor() const;
- QColor getNormalColor() const;
- QColor getPressedColor() const;
- bool getCanMove() const;
- QPixmap getBgImage() const;
- ColorMode getColorMode() const;
- QSize sizeHint() const;
- QSize minimumSizeHint() const;
- public Q_SLOTS:
- //设置边框圆角角度
- void setBorderRadius(int borderRadius);
- //设置边框宽度
- void setBorderWidth(int borderWidth);
- //设置边框颜色
- void setBorderColor(const QColor &borderColor);
- //设置是否显示角标
- void setShowSuperText(bool showSuperText);
- //设置角标文字
- void setSuperText(const QString &superText);
- //设置角标文字字体
- void setSuperTextFont(const QFont &superTextFont);
- //设置角标文字对齐方式
- void setSuperTextAlign(const TextAlign &superTextAlign);
- //设置角标文字颜色
- void setSuperTextColor(const QColor &superTextColor);
- //设置文字
- void setText(const QString &text);
- //设置文字字体
- void setTextFont(const QFont &textFont);
- //设置文字对齐方式
- void setTextAlign(const TextAlign &textAlign);
- //设置文字颜色
- void setTextColor(const QColor &textColor);
- //设置正常颜色
- void setNormalColor(const QColor &normalColor);
- //设置按下颜色
- void setPressedColor(const QColor &pressedColor);
- //设置是否可以移动
- void setCanMove(bool canMove);
- //设置背景图片
- void setBgImage(const QPixmap &bgImage);
- //设置颜色模式
- void setColorMode(const ColorMode &colorMode);
- Q_SIGNALS:
- void clicked();
- };
- #endif // WKBUTTON_H
五、核心代码- bool ColorButton::eventFilter(QObject *watched, QEvent *event)
- {
- if (!isEnabled()) {
- return QWidget::eventFilter(watched, event);
- }
- static QPoint lastPoint;
- if (event->type() == QEvent::MouseButtonPress) {
- QMouseEvent *e = static_cast<QMouseEvent *>(event);
- if (this->rect().contains(e->pos()) && (e->button() == Qt::LeftButton)) {
- lastPoint = e->pos();
- isPressed = true;
- update();
- }
- } else if (event->type() == QEvent::MouseMove && isPressed && canMove) {
- QMouseEvent *e = static_cast<QMouseEvent *>(event);
- int dx = e->pos().x() - lastPoint.x();
- int dy = e->pos().y() - lastPoint.y();
- this->move(this->x() + dx, this->y() + dy);
- return true;
- } else if (event->type() == QEvent::MouseButtonRelease && isPressed) {
- isPressed = false;
- update();
- }
- return QWidget::eventFilter(watched, event);
- }
- void ColorButton::paintEvent(QPaintEvent *)
- {
- //绘制准备工作,启用反锯齿
- QPainter painter(this);
- painter.setRenderHints(QPainter::Antialiasing | QPainter::TextAntialiasing);
- //绘制背景
- drawBg(&painter);
- //绘制文字
- drawText(&painter);
- }
- void ColorButton::drawBg(QPainter *painter)
- {
- painter->save();
- //设置边框颜色及宽度
- QPen pen;
- pen.setColor(borderColor);
- pen.setWidthF(borderWidth);
- painter->setPen(pen);
- //绘制区域要减去边框宽度
- QRect rect;
- rect.setX(borderWidth);
- rect.setY(borderWidth);
- rect.setWidth(width() - borderWidth * 2);
- rect.setHeight(height() - borderWidth * 2);
- //如果背景图片存在则显示背景图片,否则显示背景色
- if (!bgImage.isNull()) {
- //等比例缩放绘制
- QPixmap img = bgImage.scaled(rect.width(), rect.height(), Qt::KeepAspectRatio, Qt::SmoothTransformation);
- painter->drawPixmap((this->rect().width() - img.width()) / 2, (this->rect().height() - img.height()) / 2, img);
- } else {
- if (colorMode == ColorMode_Normal) {
- if (isPressed) {
- painter->setBrush(QBrush(pressedColor));
- } else {
- painter->setBrush(QBrush(normalColor));
- }
- } else if (colorMode == ColorMode_Replace) {
- QLinearGradient gradient(QPoint(0, 0), QPoint(0, height()));
- if (isPressed) {
- gradient.setColorAt(0.0, pressedColor);
- gradient.setColorAt(0.49, pressedColor);
- gradient.setColorAt(0.50, normalColor);
- gradient.setColorAt(1.0, normalColor);
- } else {
- gradient.setColorAt(0.0, normalColor);
- gradient.setColorAt(0.49, normalColor);
- gradient.setColorAt(0.50, pressedColor);
- gradient.setColorAt(1.0, pressedColor);
- }
- painter->setBrush(gradient);
- } else if (colorMode == ColorMode_Shade) {
- QLinearGradient gradient(QPoint(0, 0), QPoint(0, height()));
- if (isPressed) {
- gradient.setColorAt(0.0, pressedColor);
- gradient.setColorAt(1.0, normalColor);
- } else {
- gradient.setColorAt(0.0, normalColor);
- gradient.setColorAt(1.0, pressedColor);
- }
- painter->setBrush(gradient);
- }
- painter->drawRoundedRect(rect, borderRadius, borderRadius);
- }
- painter->restore();
- }
- void ColorButton::drawText(QPainter *painter)
- {
- if (!bgImage.isNull()) {
- return;
- }
- painter->save();
- //如果要显示角标,则重新计算显示文字的区域
- if (showSuperText) {
- int offset = 3;
- QRect rect;
- rect.setX(borderWidth * offset);
- rect.setY(borderWidth);
- rect.setWidth(width() - borderWidth * offset * 2);
- rect.setHeight(height() - borderWidth * 2);
- Qt::Alignment alignment = Qt::AlignCenter;
- if (superTextAlign == TextAlign_Top_Left) {
- alignment = Qt::AlignTop | Qt::AlignLeft;
- } else if (superTextAlign == TextAlign_Top_Center) {
- alignment = Qt::AlignTop | Qt::AlignHCenter;
- } else if (superTextAlign == TextAlign_Top_Right) {
- alignment = Qt::AlignTop | Qt::AlignRight;
- } else if (superTextAlign == TextAlign_Center_Left) {
- alignment = Qt::AlignLeft | Qt::AlignVCenter;
- } else if (superTextAlign == TextAlign_Center_Center) {
- alignment = Qt::AlignHCenter | Qt::AlignVCenter;
- } else if (superTextAlign == TextAlign_Center_Right) {
- alignment = Qt::AlignRight | Qt::AlignVCenter;
- } else if (superTextAlign == TextAlign_Bottom_Left) {
- alignment = Qt::AlignBottom | Qt::AlignLeft;
- } else if (superTextAlign == TextAlign_Bottom_Center) {
- alignment = Qt::AlignBottom | Qt::AlignHCenter;
- } else if (superTextAlign == TextAlign_Bottom_Right) {
- alignment = Qt::AlignBottom | Qt::AlignRight;
- }
- //绘制角标
- painter->setPen(superTextColor);
- painter->setFont(superTextFont);
- painter->drawText(rect, alignment, superText);
- }
- int offset = 5;
- QRect rect;
- rect.setX(borderWidth * offset);
- rect.setY(borderWidth);
- rect.setWidth(width() - borderWidth * offset * 2);
- rect.setHeight(height() - borderWidth * 2);
- Qt::Alignment alignment = Qt::AlignCenter;
- if (textAlign == TextAlign_Top_Left) {
- alignment = Qt::AlignTop | Qt::AlignLeft;
- } else if (textAlign == TextAlign_Top_Center) {
- alignment = Qt::AlignTop | Qt::AlignHCenter;
- } else if (textAlign == TextAlign_Top_Right) {
- alignment = Qt::AlignTop | Qt::AlignRight;
- } else if (textAlign == TextAlign_Center_Left) {
- alignment = Qt::AlignLeft | Qt::AlignVCenter;
- } else if (textAlign == TextAlign_Center_Center) {
- alignment = Qt::AlignHCenter | Qt::AlignVCenter;
- } else if (textAlign == TextAlign_Center_Right) {
- alignment = Qt::AlignRight | Qt::AlignVCenter;
- } else if (textAlign == TextAlign_Bottom_Left) {
- alignment = Qt::AlignBottom | Qt::AlignLeft;
- } else if (textAlign == TextAlign_Bottom_Center) {
- alignment = Qt::AlignBottom | Qt::AlignHCenter;
- } else if (textAlign == TextAlign_Bottom_Right) {
- alignment = Qt::AlignBottom | Qt::AlignRight;
- }
- painter->setPen(textColor);
- painter->setFont(textFont);
- painter->drawText(rect, alignment, text);
- painter->restore();
- }
六、控件介绍 1. 超过149个精美控件,涵盖了各种仪表盘、进度条、进度球、指南针、曲线图、标尺、温度计、导航条、导航栏,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动态库文件,可以直接集成到qtcreator中拖曳设计使用。
14. 目前已经有
qml版本,后期会考虑出pyqt版本,如果用户需求量很大的话。
七、SDK下载 - SDK下载链接:
https://pan.baidu.com/s/1A5Gd77kExm8Co5ckT51vvQ 提取码:877p
- 下载链接中包含了各个版本的动态库文件,所有控件的头文件,使用demo,自定义控件+属性设计器。
- 自定义控件插件开放动态库dll使用(永久免费),无任何后门和限制,请放心使用。
- 目前已提供26个版本的dll,其中包括了qt5.12.3 msvc2017 32+64 mingw 32+64 的。
- 不定期增加控件和完善控件,不定期更新SDK,欢迎各位提出建议,谢谢!
-
widget版本(QQ:517216493)qml版本(QQ:373955953)三峰驼(QQ:278969898)。
- 涛哥的知乎专栏 Qt进阶之路
https://zhuanlan.zhihu.com/TaoQt - 欢迎关注微信公众号【高效程序员】,C++/Python、学习方法、写作技巧、热门技术、职场发展等内容,干货多多,福利多多!