qt 自定义插件
在使用qt编写界面程序时,可以方便的拖动控件到窗口上,系统提供了一些常用的控件,那如何把自己定义的控件添加到里面可以直接拖动使用呢?网上一搜搜出来一堆教程,按照网上的教程我踩了不少坑,本文记录下如何开发自定义控件并添加到QT里,支持直接拖动使用。
一、我的开发环境
win10 64位、qt5.14.2 64位、vs2017
二、开发过程
1、qt creator -> 新建 -> 其他项目->qt4设计师自定义控件->项目名(以Test为例),下一步->选择 desktop qt 5.14.2 msvc2017 32bit和64bit->控件类,添加控件类(以TestWidget为例),右侧对话框根据需要自行调整(在说明里有一个组,这个地方可控制我们的自定义控件显示在哪个组,已MyTest为例),然后下一步到结束。
2、在TestWidget类里引入头文件#include <QtUiPlugin/QDesignerExportWidget>,并在类名前添加QDESIGNER_WIDGET_EXPORT
3、编写类
testwidget.h
1 #pragma once 2 3 #include <QWidget> 4 #include <QtUiPlugin/QDesignerExportWidget> 5 6 class QDESIGNER_WIDGET_EXPORT TestWidget : public QWidget 7 { 8 Q_OBJECT 9 Q_PROPERTY(QColor crBg WRITE setColor) //加上这句,可以在designer里面直接设置控件属性, 10 public: 11 void setColor(QColor cr); 12 TestWidget(QWidget *parent = 0); 13 void paintEvent(QPaintEvent* event); 14 QColor crBg; 15 };
testwidget.cpp
1 #include "testwidget.h" 2 #include <QPainter> 3 void TestWidget::setColor(QColor cr) 4 { 5 crBg=cr; 6 update(); 7 } 8 9 TestWidget::TestWidget(QWidget *parent) : 10 QWidget(parent) 11 { 12 crBg=QColor(255,0,0); 13 } 14 15 void TestWidget::paintEvent(QPaintEvent *event) 16 { 17 Q_UNUSED(event); 18 QPainter paint(this); 19 paint.fillRect(rect(),crBg); 20 }
很简单的画一个背景
三、过程
1.选择32位debug编译,然后把生成的testwidgetplugind.dll拷贝到D:\Qt\5.14.2\msvc2017\plugins\designer下面,启动D:\Qt\5.14.2\msvc2017\bin\designer.exe,在控件列表里没有出现。问题在哪?点击帮助->关于插件,如下图所示:
从图中可以看到,原因是使用了debug版本。
2.改为32位release编译,然后把生成的testwidgetplugin.dll拷贝到D:\Qt\5.14.2\msvc2017\plugins\designer下面,启动D:\Qt\5.14.2\msvc2017\bin\designer.exe,出来了。新建一个窗体,拖动过去,调整属性
什么?颜色可以根据设置显示,但是右侧设置的属性值却显示是0,0,0,255。想想是不是因为上面属性设置的只有WRITE?如果再加上READ是不是就可以了(当然是)。
图标是个qt,不能见图知意,换一个,只需要在batteryplugin.cpp里的QIcon BatteryPlugin::icon() const返回想要的就行。
QIcon BatteryPlugin::icon() const { return QIcon(QString("://battery.png")); }
3.上面两部操作可以在32位的designer.exe下面使用,那D:\Qt\5.14.2\msvc2017_64\bin\designer.exe能用吗?不行,即便把上面的release下生成的testwidgetplugin.dll拷贝到D:\Qt\5.14.2\msvc2017_64\plugins\designer下同样不行,机制的人类是不是想到用64位编译就可以了,答案是的。
4.经过上面的操作已经可以在designer.exe里面正常使用了,但是在qt creator里面却不行,怎么办?我们还需要把dll文件拷贝到D:\Qt\Tools\QtCreator\bin\plugins\designer下面,问题来了,是拷贝32位的还是64位的?64位,因为我的环境的qtcreator是64位的,文中上图有显示。至此已经可以使用了。
四、坑
1.有文章说如果qtcreator是用msvc 2019编译的那插件也应该用msvc2019编译,害的我差点把VS重装。只要记住用velease,并用对应的32或64编译,然后拷贝到对应位置即可。
2.拷贝时要拷贝dll和lib,想想就能知道这肯定不对,dll就是个动态链接库,lib是在编译链接时才用。