表格樹控制項QtTreePropertyBrowser編譯成動態庫(設計師插件)

[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));
}