Qt自定义控件创建和使用

Qt自定义控件创建和使用

Qt中很方便的是使用各种自定义控件来分模块实现各种子功能，用于实现代码的解耦；
之前在使用Qt 5.12创建自定义控件时，出现了各种问题，多次重装QtCreator和VS，屡次失败，乃至一度放弃。话说写代码很简单，环境的配置却很难，不知道有多少人在各种开发环境的配置时，被这种挫败感打击而放弃；
不死心，从同事的实例中看到了自定义控件的有效实现，亲自实验，确实能用，写个备忘录记录一下；

一、创建自定义控件

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

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

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

将会生成一个Qt项目目录

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

CONFIG      += plugin debug_and_release
TARGET      = $$qtLibraryTarget(onepluginplugin)
TEMPLATE    = lib

HEADERS     = onepluginplugin.h
SOURCES     = onepluginplugin.cpp
RESOURCES   = icons.qrc
LIBS        += -L. 

greaterThan(QT_MAJOR_VERSION, 4) {
    QT += designer
} else {
    CONFIG += designer
}

target.path = $$[QT_INSTALL_PLUGINS]/designer
INSTALLS    += target
#输出dll放置在QtCreator目录路径
message($$target.path)
include(oneplugin.pri)

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

如果编译后在C:/Qt/5.15.2/msvc2019_64/plugins/designer文件夹下没有生产对于的dll；
在项目设置中“构建”Release下的“添加Build步骤”增加“Custom Process Step”

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

清理项目，并重新构建；
可以在C:/Qt/5.15.2/msvc2019_64/plugins/designer文件夹下看到对应的dll出现；

自动生成的oneplugin.h

#ifndef ONEPLUGIN_H
#define ONEPLUGIN_H
#include <QWidget>
class OnePlugin : public QWidget
{
    Q_OBJECT
public:
    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_OBJECT
public:
    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 gui
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
CONFIG += c++11
CONFIG += release
SOURCES += \
    main.cpp \
    widget.cpp
HEADERS += \
    widget.h
FORMS += \
    widget.ui
HEADERS += lib/
LIBS += $$PWD/lib/onepluginplugin.lib
# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: 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_OBJECT
public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
private:
    Ui::Widget *ui;
    OnePlugin* pOnePlugin;
};

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

在这停顿了很久，翻了很多百度，发现一个有用的记录；
这里需要将使用到的oneplugin.h中的QDESIGNER_WIDGET_EXPORT删除；
还有一种情况也会出现这种问题，是lib下使用的lib编译类型与当前测试程序的编译类型不相同，重新编译oneplugin项目，将生成的lib拷贝到lib文件夹下；
编译

将dll拷贝到exe的文件夹下；
测试exe可以正常运行

总结

总体上是按照博客
链接: qt 自定义控件的使用以及遇到的问题一步步实现的；操作中也遇到不同的问题；总体上还是解决了。