700字范文 > Qt自定义控件创建和使用

Qt自定义控件创建和使用

时间：2021-10-27 15:19:58

相关推荐

Qt自定义控件创建和使用

Qt中很方便的是使用各种自定义控件来分模块实现各种子功能，用于实现代码的解耦；

之前在使用Qt 5.12创建自定义控件时，出现了各种问题，多次重装QtCreator和VS，屡次失败，乃至一度放弃。话说写代码很简单，环境的配置却很难，不知道有多少人在各种开发环境的配置时，被这种挫败感打击而放弃；

不死心，从同事的实例中看到了自定义控件的有效实现，亲自实验，确实能用，写个备忘录记录一下；

一、创建自定义控件

1.首先新建项目，选择“其他项目”下的“Qt4设计师自定义控件”

2.新建一个控件类“One Plugin”

3.写入自定义控件的名称以及使用资源文件名称

将会生成一个Qt项目目录

如果想要在UI设计师界面显示自定义控件，需要将OnePlugin项目设置为Release；

OnePlugin.pro内容：

CONFIG+= plugin debug_and_releaseTARGET= $$qtLibraryTarget(onepluginplugin)TEMPLATE = libHEADERS= onepluginplugin.hSOURCES= onepluginplugin.cppRESOURCES = icons.qrcLIBS += -L. greaterThan(QT_MAJOR_VERSION, 4) {QT += designer} else {CONFIG += designer}target.path = $$[QT_INSTALL_PLUGINS]/designerINSTALLS += target#输出dll放置在QtCreator目录路径message($$target.path)include(oneplugin.pri)

编译qmake

概要信息中会输出dll拷贝到QtCreator的plugins/designer目录下；

如果编译后在C:/Qt/5.15.2/msvc_64/plugins/designer文件夹下没有生产对于的dll；

在项目设置中“构建”Release下的“添加Build步骤”增加“Custom Process Step”

Command设置为“nmake”；Arguments设置为“install”；

清理项目，并重新构建；

可以在C:/Qt/5.15.2/msvc_64/plugins/designer文件夹下看到对应的dll出现；

自动生成的oneplugin.h

#ifndef ONEPLUGIN_H#define ONEPLUGIN_H#include <QWidget>class OnePlugin : public QWidget{Q_OBJECTpublic:OnePlugin(QWidget *parent = 0);};#endif // ONEPLUGIN_H

需要修改为

#ifndef ONEPLUGIN_H#define ONEPLUGIN_H#include <QWidget>#include <QtUiPlugin/QDesignerExportWidget>class QDESIGNER_WIDGET_EXPORT OnePlugin : public QWidget{Q_OBJECTpublic:OnePlugin(QWidget *parent = 0);};#endif // ONEPLUGIN_H

增加了#include <QtUiPlugin/QDesignerExportWidget>和QDESIGNER_WIDGET_EXPORT

QDESIGNER_WIDGET_EXPORT的F1解释为：

This macro is used when defining custom widgets to ensure that they are correctly exported from plugins for use with Qt Designer.

至此，自定义控件算是创建完成；

将onepluginplugin.dll拷贝到Qt Creator的目录下C:\Qt\Tools\QtCreator\bin\plugins\designer，重启QtCreator；

打开ui文件后可以看到自定义控件，不要在意这里面的名字，onePluge是我瞎起的名字；

下面是使用Everything搜索的结果：

二、使用自定义控件

2.1创建测试对话框程序

在测试程序源码文件夹增加lib文件夹，将OnePlugin对应的oneplugin.h和onepluginplugin.lib拷贝到lib文件夹下；

在pro文件内增加

CONFIG += release

HEADERS += lib/

LIBS += $$PWD/lib/onepluginplugin.lib

QT += core guigreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11CONFIG += releaseSOURCES += \main.cpp \widget.cppHEADERS += \widget.hFORMS += \widget.uiHEADERS += lib/LIBS += $$PWD/lib/onepluginplugin.lib# Default rules for deployment.qnx: target.path = /tmp/$${TARGET}/binelse: unix:!android: target.path = /opt/$${TARGET}/bin!isEmpty(target.path): INSTALLS += target

在对话框的头文件中增加

#include “lib/oneplugin.h”

Widget类中增加成员变量pOnePlugin；

在构造函数中pOnePlugin = new OnePlugin(this);

#include "lib/oneplugin.h"class Widget : public QWidget{Q_OBJECTpublic:Widget(QWidget *parent = nullptr);~Widget();private:Ui::Widget *ui;OnePlugin* pOnePlugin;};

编译程序，出现LNK：无法解析的外部符号的错误：

在这停顿了很久，翻了很多百度，发现一个有用的记录；

这里需要将使用到的oneplugin.h中的QDESIGNER_WIDGET_EXPORT删除；

还有一种情况也会出现这种问题，是lib下使用的lib编译类型与当前测试程序的编译类型不相同，重新编译oneplugin项目，将生成的lib拷贝到lib文件夹下；

编译

将dll拷贝到exe的文件夹下；

测试exe可以正常运行