表格树控件QtTreePropertyBrowser编译成动态库(设计师插件)

程序员文章站 2022-07-09 21:02:39

[TOC] 原文链接： "表格树控件QtTreePropertyBrowser编译成动态库(设计师插件)" 一、回顾上一篇文章 "超级实用的表格树控件 QtTreePropertyBrowser" 讲了怎么去编译QtTreePropertyBrowser库，并且可以简单使用。由于我下载的库是基于Q ......

原文链接：表格树控件qttreepropertybrowser编译成动态库(设计师插件)

一、回顾

上一篇文章超级实用的表格树控件--qttreepropertybrowser讲了怎么去编译qttreepropertybrowser库，并且可以简单使用。由于我下载的库是基于qt4的版本，所以编译起来也费劲巴拉的，改了好久的源码才编译通过。

本篇文章我们核心讲解的是怎么把这个库编译成动态库，让别的模块去动态调用。

这里引入qt官方维护的模块qtsolutions，里边就包含了qttreepropertybrowser这个项目，最关键是qt5可以直接编译通过。

qtsolutions里边不仅仅有qttreepropertybrowser这个项目，而且包含了多个有用模块，文章最后会简单做以介绍。

下面我们主要还是围绕qttreepropertybrowser这个库来进行讲解。。

二、动态库编译

编译成动态库的方式有2种，一种是命令行，另一种是vs工具，其实本质上都是一样的，都是使用了msvc编译器。

如果想要使用其他编译器编译，本篇文章可以作为参考，可能有些地方不太实用。

编译这种长期维护的项目，我们首先就是去看代码中的文档说明，一般都会有编译步骤。

这个库也不例外，看上图中红色款圈出来的部分，就是我们编译的步骤，简单吧。

configure.bat，如果需要生成动态库则需要添加-library参数

1、命令行编译动态库和测试程序

命令行cd到源码根目录，执行以下步骤即可

confiture.bat -library
qmake
nmake

没有什么悬念，代码应该可以正常编译通过，这里就不做过多解释。

重点看下怎么使用vs工具进行编译

2、vs工具编译动态库和测试程序

首先在网上随便搜索下pro转sln工程的文章，总结一下就是下面两句话

qmake xxx.pro
qmake -tp vc -r

对于我们的qtpropertybrowser代码可能就像下面这样

qmake qtpropertybrowser.pro
qmake -tp vc -r

如果不使用这种方式，也可以使用vs-addin插件直接打开pro文件

执行完上述两句话之后，会发现我们的根目录下多了一个qtpropertybrowser.sln工程文件。每一个项目文件夹下也多了一个simple.vcxproj项目文件。

接下来就是用vs打开qtpropertybrowser.sln工程文件，然后进行编译了。

通过命令行生成的qtsolutions_propertybrowser-head.vcxproj这个工程文件有一些小问题，需要修改下工程配置，否则编译会失败。

打开工程属性 -> c/c++ -> 预处理器 -> 预处理器定义项。

修改qt_qtpropertybrowser_import宏为qt_qtpropertybrowser_export

然后编译，动态库的编译结果如下图，其他测试程序这里没有放出来。

3、安装文档

根据install.txt说明文件，尝试如下两种操作均失败

添加qch文件，发现没有这个文件
使用添加命令assustant -addcontentfile xxx.dcf添加，报错。

后来无意中看到了一片文章创建文档和自定义的qt assistant，讲怎么生成qt帮助文档的，发现其中有根据qhp文件生成qch文件的方式，尝试了下，居然可以。

操作步骤如下：

qhelpgenerator xxx.qhp -o xxx.qch
assistant -register xxx.qch

对于我们的qtpropertybrowser代码，可能会像下面这样。首先进入doc\html目录下，然后执行如下操作

qhelpgenerator qtpropertybrowser.qhp -o qtpropertybrowser.qch
assistant -register qtpropertybrowser.qch

第二步也可以通过工具来添加，如上图所示。编辑菜单 -> 首选项，选中文档页签，添加自己的qch文件即可。

4、测试文档

搜索页签下输入"qtpro"，搜索到结果qtproperty，如下图所示，表示我们的文档集成成功。

三、设计师插件编译

动态库都有了，设计师插件还会远吗？

自己写一个qt插件，把需要导入到desinger中的控件都注册进来即可。

大致流程如下

1、重写qdesignercustomwidgetinterface

widgetinterface类继承自qdesignercustomwidgetinterface，widgetinterface类包含了一些默认行为，这里就不贴出来了。

class treebrowserinterface : public widgetinterface
{
    q_object
    q_interfaces( qdesignercustomwidgetinterface )

public:
    treebrowserinterface(qobject * parent);
    virtual qwidget * createwidget( qwidget * parent ) override;
};

2、添加到插件列表

widgetcollectioninterface::widgetcollectioninterface( qobject * parent /*= nullptr */ )
    : qobject(parent)
{
    d_plugins.append(new qpb::treebrowserinterface(this));
    d_plugins.append(new qpb::buttonbrowserinterface(this));
    d_plugins.append(new qpb::groupboxbrowserinterface(this));
}