一、前言
无论是哪一门开发框架,如果涉及到UI这块,肯定需要用到自定义控件,越复杂功能越多的项目,自定义控件的数量就越多,最开始的时候可能每个自定义控件都针对特定的应用场景,甚至里面带了特定的场景的一些设置和处理,随着项目数量的增多,有些控件又专门提取出来共性,做成了通用的自定义控件,意味着控件主要做外观处理,用户根据不同的场景需要,设置不同的外观和规则,就这样搞来搞去搞到现在,已经超过了202个控件,慢慢的积累迭代和更新,历经超过9年的时间不断的完善,尤其是对不同Qt版本、不同编译器、不同操作系统的支持,其中Qt6改动比较大,很多方法或者类改名或者废弃了,需要用类似的方法处理,在改完整个自定义控件大全后,特意整理了升级到Qt6经验大全,放在开源主页上,合并在Qt开发经验中,目前该经验可能是国内Qt开发界最受欢迎的开发经验总结。
二、效果图
三、体验地址
国际站点:github.com/feiyangqing...
四、功能特点
- 超过202个精美控件并持续不断迭代更新升级,种类超多,控件类型极其丰富。
- 涵盖了各种仪表盘、进度条、进度球、指南针、曲线图、标尺、温度计、导航条、导航栏,flatui、高亮按钮、滑动选择器、农历、广告轮播、饼状图、环形图、时间轴、拓展控件、增强控件等。
- 每个类都是独立的一个.h头文件和.cpp实现文件组成,零耦合,不依赖其他文件,方便单个控件独立出来以源码形式集成到项目中,方便直观。
- 控件数量远超其他第三方控件库比如qwt集成的控件数量,使用方式也比其简单友好零耦合。
- 支持任意Qt版本,亲测Qt4/5/6的所有版本,全部纯Qt编写,QWidget+QPainter绘制。
- 支持任意编译器,包括但不限于mingw、msvc、gcc、clang等编译器。
- 支持任意操作系统,包括但不限于windows、linux、mac、android、uos、银河麒麟、各种国产linux、嵌入式linux、树莓派、香橙派、全志H3等。
- 支持编译生成设计师插件,可直接集成到QtCreator的控件栏中,和自带的控件一样使用,大部分效果只要设置几个属性即可,极为方便。
- 支持编译生成独立的非插件形式的动态库文件,体积小,比如嵌入式linux不支持designer只需要动态库的形式。
- 每个控件都有一个单独的完整的使用demo,方便参考学习单个控件使用,非常适合初学者。
- 提供一个所有控件使用的集成的example,方便快速查看所有控件的效果。
- 支持直接源码集成到example的方式,方便编译到安卓,for web套件等。
- 支持编译成wasm文件,直接网页运行,可以在谷歌、火狐、edge等浏览器运行,原生性能。
- 每个控件的源代码都有详细中文注释,都按照统一设计规范编写,方便学习自定义控件的编写。
- 每个控件都内置默认配色,demo对应的配色都非常精美。
- 部分控件提供多种样式风格选择,多种指示器样式选择。
- 所有控件自适应布局和窗体拉伸变化,自动缩放。
- 配套额外的自定义控件属性设计器,类似组态设计器,纯中文属性名称,支持拖曳设计,所见即所得,支持导入导出xml格式。
- 集成fontawesome图形字体+阿里巴巴iconfont收藏的几百个图形字体,享受图形字体带来的乐趣。
- 所有控件最后生成一个dll动态库文件,可以直接集成到qtcreator中拖曳设计使用。
- 控件源码全部分门别类存放,pri模块形式集成,提供控件对照表快速查找对应控件和说明。
五、相关代码
rust
#pragma execution_character_set("utf-8")
#include "frmexamplessimple.h"
#include "ui_frmexamplessimple.h"
#include "head.h"
#include "../../demo/gauge/gaugecar/frmgaugecar.h"
#include "../../demo/gauge/gaugecloud/frmgaugecloud.h"
#include "../../demo/gauge/gaugecolor/frmgaugecolor.h"
#include "../../demo/gauge/gaugecompass/frmgaugecompass.h"
#include "../../demo/gauge/gaugecompasspan/frmgaugecompasspan.h"
#include "../../demo/gauge/gaugedial/frmgaugedial.h"
#include "../../demo/gauge/gaugemini/frmgaugemini.h"
#include "../../demo/gauge/gaugepanel/frmgaugepanel.h"
#include "../../demo/gauge/gaugeprogress/frmgaugeprogress.h"
#include "../../demo/gauge/gaugespeed/frmgaugespeed.h"
#include "../../demo/progress/progressbutton/frmprogressbutton.h"
#include "../../demo/progress/progresspercent/frmprogresspercent.h"
#include "../../demo/progress/progressring/frmprogressring.h"
#include "../../demo/progress/progressshadow/frmprogressshadow.h"
#include "../../demo/progress/progresstip/frmprogresstip.h"
#include "../../demo/painter/battery/frmbattery.h"
#include "../../demo/painter/lightbutton/frmlightbutton.h"
#include "../../demo/painter/lunarcalendarwidget/frmlunarcalendarwidget.h"
#include "../../demo/painter/magicpoolfish/frmmagicpoolfish.h"
#include "../../demo/painter/telwidget/frmtelwidget.h"
#include "../../demo/custom/customring/frmcustomring.h"
#include "../../demo/custom/customgraphics/frmcustomgraphics.h"
#include "../../demo/custom/shadowcalendar/frmshadowcalendar.h"
#include "../../demo/custom/spiderchart/frmspiderchart.h"
#include "../../demo/custom/timeaxis/frmtimeaxis.h"
#include "../../demo/custom/customdart/frmcustomdart.h"
#include "../../demo/custom/tasktableview/frmtasktableview.h"
#include "../../demo/ruler/rulerprogress/frmrulerprogress.h"
#include "../../demo/color/colorpanel/frmcolorpanel.h"
#include "../../demo/image/adswidgetx/frmadswidgetx.h"
#include "../../demo/image/imageclock/frmimageclock.h"
#include "../../demo/other/selectwidget/frmselectwidget.h"
#include "../../demo/wave/wavewater/frmwavewater.h"
#include "../../demo/slider/sliderselect/frmsliderselect.h"
#include "../../demo/flight/frmflightall.h"
frmExamplesSimple::frmExamplesSimple(QWidget *parent) : QWidget(parent), ui(new Ui::frmExamplesSimple)
{
ui->setupUi(this);
this->initForm();
this->addItem();
}
frmExamplesSimple::~frmExamplesSimple()
{
delete ui;
}
void frmExamplesSimple::paintEvent(QPaintEvent *)
{
QPainter painter(this);
painter.drawTiledPixmap(rect(), bgPix);
}
void frmExamplesSimple::initForm()
{
bgPix = QPixmap(":/image/bg.png");
connect(ui->navListView, SIGNAL(pressed(QString, QString)), this, SLOT(pressed(QString, QString)));
//设置文本边距
ui->navListView->setChildMargin(28);
ui->navListView->setFixedWidth(190);
ui->navListView->setExpendMode(NavListView::ExpendMode_SingleClick);
ui->navListView->setSeparateColor(QColor(40, 43, 51));
//设置子节点颜色
ui->navListView->setChildBgNormalColor(QColor(40, 43, 51));
ui->navListView->setChildBgSelectedColor(QColor(20, 20, 20));
ui->navListView->setChildBgHoverColor(QColor(20, 20, 20));
ui->navListView->setChildTextNormalColor(QColor(180, 180, 180));
ui->navListView->setChildTextSelectedColor(QColor(250, 250, 250));
ui->navListView->setChildTextHoverColor(QColor(255, 255, 255));
//设置父节点颜色
ui->navListView->setParentBgNormalColor(QColor(57, 61, 73));
ui->navListView->setParentBgSelectedColor(QColor(78, 83, 102));
ui->navListView->setParentBgHoverColor(QColor(78, 83, 102));
ui->navListView->setParentTextNormalColor(QColor(250, 250, 250));
ui->navListView->setParentTextSelectedColor(QColor(250, 250, 250));
ui->navListView->setParentTextHoverColor(QColor(250, 250, 250));
}
void frmExamplesSimple::addItem()
{
ui->stackedWidget->addWidget(new frmGaugeCar);
ui->stackedWidget->addWidget(new frmGaugeCloud);
ui->stackedWidget->addWidget(new frmGaugeColor);
ui->stackedWidget->addWidget(new frmGaugeCompass);
ui->stackedWidget->addWidget(new frmGaugeCompassPan);
ui->stackedWidget->addWidget(new frmGaugeDial);
ui->stackedWidget->addWidget(new frmGaugeMini);
ui->stackedWidget->addWidget(new frmGaugePanel);
ui->stackedWidget->addWidget(new frmGaugeProgress);
ui->stackedWidget->addWidget(new frmGaugeSpeed);
ui->stackedWidget->addWidget(new frmProgressButton);
ui->stackedWidget->addWidget(new frmProgressPercent);
ui->stackedWidget->addWidget(new frmProgressRing);
ui->stackedWidget->addWidget(new frmProgressShadow);
ui->stackedWidget->addWidget(new frmProgressTip);
ui->stackedWidget->addWidget(new frmBattery);
ui->stackedWidget->addWidget(new frmLightButton);
ui->stackedWidget->addWidget(new frmLunarCalendarWidget);
ui->stackedWidget->addWidget(new frmMagicPoolFish);
ui->stackedWidget->addWidget(new frmTelWidget);
ui->stackedWidget->addWidget(new frmCustomRing);
ui->stackedWidget->addWidget(new frmCustomGraphics);
ui->stackedWidget->addWidget(new frmShadowCalendar);
ui->stackedWidget->addWidget(new frmSpiderChart);
ui->stackedWidget->addWidget(new frmTimeAxis);
ui->stackedWidget->addWidget(new frmCustomDart);
ui->stackedWidget->addWidget(new frmTaskTableView);
ui->stackedWidget->addWidget(new frmRulerProgress);
ui->stackedWidget->addWidget(new frmColorPanel);
ui->stackedWidget->addWidget(new frmAdsWidgetx);
ui->stackedWidget->addWidget(new frmImageClock);
ui->stackedWidget->addWidget(new frmSelectWidget);
ui->stackedWidget->addWidget(new frmWaveWater);
ui->stackedWidget->addWidget(new frmSliderSelect);
ui->stackedWidget->addWidget(new frmFlightAll);
listName << "汽车仪表盘" << "云台仪表盘" << "多彩仪表盘" << "指南针表盘" << "指南针面板"
<< "旋转仪表盘" << "迷你仪表盘" << "面板仪表盘" << "进度仪表盘" << "速度仪表盘";
listName << "按钮进度条" << "百分比进度" << "环形进度条" << "光晕进度条" << "提示进度条";
listName << "电池电量" << "高亮按钮" << "农历控件" << "游动的鱼" << "手机通讯录";
listName << "环形图表" << "多边形状" << "光晕日历" << "蜘蛛网图" << "垂直时间轴"
<< "自定义飞镖盘" << "任务策略表格";
listName << "进度标尺" << "颜色面板" << "图片轮播" << "图片时钟" << "描点跟随"
<< "水波效果" << "范围选择条" << "飞控套件";
addItem("精美控件", listName);
QString item = listItem.join(",");
ui->navListView->setItems(item);
this->setWindowTitle("Qt自定义控件大全 V2023 (QQ: 517216493 WX: feiyangqingyun)");
ui->navListView->setCurrentRow(0);
}
void frmExamplesSimple::addItem(const QString &parentName, const QStringList &childNames)
{
//设置节点数据格式: 标题|父节点标题(父节点为空)|是否展开(0展开)|提示信息|左侧图标
int count = childNames.count();
listItem << QString("%1||0|%2|").arg(parentName).arg(count);
for (int i = 0; i < count; ++i) {
listItem << QString("%1. %2|%3|1||0xf0da").arg(i + 1, 2, 10, QChar('0')).arg(childNames.at(i)).arg(parentName);
}
}
void frmExamplesSimple::pressed(const QString &childText, const QString &parentText)
{
//如果带了 . 表示序号,要删除再比较
QString text = childText;
if (text.contains(".")) {
text = text.mid(text.indexOf(".") + 2, text.length());
}
int index = listName.indexOf(text);
if (index >= 0) {
ui->stackedWidget->setCurrentIndex(index);
}
}