屬性瀏覽器控件QtTreePropertyBrowser編譯成動態庫(設計師插件)

時間 2019-11-06

標籤屬性瀏覽器控件 qttreepropertybrowser 編譯動態設計師插件欄目瀏覽器简体版

原文原文鏈接

目錄html

原文連接：屬性瀏覽器控件QtTreePropertyBrowser編譯成動態庫(設計師插件)瀏覽器

1、回顧

上一篇文章超級實用的屬性瀏覽器控件--QtTreePropertyBrowser講了怎麼去編譯QtTreePropertyBrowser庫，而且能夠簡單實用。因爲我下載的庫是基於Qt4的版本，因此編譯起來也費勁巴拉的，改了很久的源碼才編譯經過。app

本篇文章咱們核心講解的是怎麼把這個庫編譯成動態庫，讓別的模塊去動態調用。編輯器

這裏引入Qt官方維護的模塊QtSolutions，裏邊就包含了QtTreePropertyBrowser這個項目，最關鍵是Qt5能夠直接編譯經過。ide

QtSolutions裏邊不只僅有QtTreePropertyBrowser這個項目，並且包含了多個有用模塊，文章最後會簡單作以介紹。工具

下面咱們主要仍是圍繞QtTreePropertyBrowser這個庫來進行講解。。學習

2、動態庫編譯

編譯成動態庫的方式有2種，一種是命令行，另外一種是vs工具，其實本質上都是同樣的，都是使用了msvc編譯器。測試

若是想要使用其餘編譯器編譯，本篇文章能夠做爲參考，可能有些地方不太實用。this

編譯這種長期維護的項目，咱們首先就是去看代碼中的文檔說明，通常都會有編譯步驟。lua

這個庫也不例外，看上圖中紅色款圈出來的部分，就是咱們編譯的步驟，簡單吧。

configure.bat，若是須要生成動態庫則須要添加-library參數

一、命令行編譯動態庫和測試程序

命令行cd到源碼根目錄，執行如下步驟便可

confiture.bat -library
qmake
nmake

沒有什麼懸念，代碼應該能夠正常編譯經過，這裏就不作過多解釋。

重點看下怎麼使用vs工具進行編譯

二、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

而後編譯，動態庫的編譯結果以下圖，其餘測試程序這裏沒有放出來。

三、安裝文檔

根據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文件便可。

四、測試文檔

搜索頁簽下輸入"QtPro"，搜索到結果QtProperty，以下圖所示，表示咱們的文檔集成成功。

3、設計師插件編譯

動態庫都有了，設計師插件還會遠嗎？

本身寫一個Qt插件，把須要導入到desinger中的控件都註冊進來便可。

大體流程以下

一、重寫QDesignerCustomWidgetInterface

WidgetInterface類繼承自QDesignerCustomWidgetInterface，WidgetInterface類包含了一些默認行爲，這裏就不貼出來了。

class TreeBrowserInterface : public WidgetInterface
{
    Q_OBJECT
    Q_INTERFACES( QDesignerCustomWidgetInterface )

public:
    TreeBrowserInterface(QObject * parent);
    virtual QWidget * createWidget( QWidget * parent ) override;
};

二、添加到插件列表

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