Qt 創(chuàng)建自定義部件集成到Qt Designer中
Qt Designer為程序員提供了可視化的設(shè)計能力,可用于開發(fā)應(yīng)用程序中的所有或者部分窗體。交叉編譯呢,簡單地說,就是在一個平臺上生成另一個平臺上的可執(zhí)行代碼。這里需要注意的是所謂平臺,實(shí)際上包含兩個概念:體系結(jié)構(gòu)(Architecture)、操作系統(tǒng)(Operating System)。同一個體系結(jié)構(gòu)可以運(yùn)行不同的操作系統(tǒng);同樣,同一個操作系統(tǒng)也可以在不同的體系結(jié)構(gòu)上運(yùn)行。
把自定義控件集成到Qt Designer中
要想在Qt Designer中使用自定義控件,必須要使Qt Designer能夠知道我們的自定義控件的存在。有兩種方法可以把新自定義控件的信息通知給Qt Designer:“升級”法和插件法。
升級法最為簡便快捷。顧名思義,升級法就是把Qt自有的控件進(jìn)行升級改造一番。找一個Qt自有的控件,如果它和我們新加的自定義控件有著相似的API,那么只要在Qt Designer的對話框里面完成一些新控件的信息就一切大吉,新控件就可以在Qt Designer中使用了。但是在編輯的時候和預(yù)覽時,還是和原來的Qt控件沒有什么兩樣。
現(xiàn)在把HexSpinBox控件用升級方法集成到Qt Designer中:
1、用Qt Designer創(chuàng)建一個新的窗體,把控件箱里的QSpinBox添加到窗體中。
2、右擊旋轉(zhuǎn)盒,選擇“Promote to Custom Widget”上下文菜單。
3、在彈出的對話框中,類名處填寫“HexSpinBox”,頭文件填寫“hexspinbox.h”
好了。在uic生成的包含有QSpinBox的控件文件中,包含文件變?yōu)?ldquo;hexspinbox.h”,并且初始化為一個HexSpinBox的實(shí)例,而不是QSpinBox。在Qt Designer中,QSpinBox表示的控件為HexSpinBox,并且可以設(shè)置所有的QSpinBox的屬性。
Figure 5.6. Qt Designer's custom widget dialog
升級法的缺點(diǎn)是不能在Qt Designer中設(shè)置自定義控件自己的特有屬性,也不能夠繪制自己。這些問題可以用插件法解決。
插件法需要創(chuàng)建一個動態(tài)庫,使Qt Designer能夠在實(shí)時加載,創(chuàng)建控件的實(shí)例。這樣,Qt Designer就可以在編輯窗體或者預(yù)覽的時候使用自定義控件。Qt Designer用Qt的meta-object系統(tǒng)動態(tài)獲得自定義控件的全部屬性?,F(xiàn)在以IconEditor為例,用插件法把IconEditor集成到Qt Designer中。
首先,我們從QDesignerCustomWidgetInterface繼承一個類,重寫一些虛函數(shù)。我們假定這個類的源代碼在iconeditorplugin目錄中,IconEditor類的代碼在與它平行的目錄iconeditor中。
這里是插件類的定義:
- #include <QDesignerCustomWidgetInterface>
- class IconEditorPlugin : public QObject, public QDesignerCustomWidgetInterface
- {
- Q_OBJECT
- Q_INTERFACES(QDesignerCustomWidgetInterface)
- public:
- IconEditorPlugin(QObject *parent = 0);
- QString name() const;
- QString includeFile() const;
- QString group() const;
- QIcon icon() const;
- QString toolTip() const;
- QString whatsThis() const;
- bool isContainer() const;
- QWidget *createWidget(QWidget *parent);
- };
IconEditorPlugin是一個包裝IconEditor控件的類廠,使用了雙繼承,父類為QObject和QDesignerCustomWidgetInterface。宏Q_INTERFACES()告訴moc第二個基類為一個插件接口類。Qt Designer使用類中的函數(shù)創(chuàng)建IconEditor的實(shí)例并得到有關(guān)它的信息。
源文件如下:
- IconEditorPlugin::IconEditorPlugin(QObject *parent)
- : QObject(parent)
- {
- }
- QString IconEditorPlugin::name() const
- {
- return "IconEditor";
- }
- QString IconEditorPlugin::includeFile() const
- {
- return "iconeditor.h";
- }
- QString IconEditorPlugin::group() const
- {
- return tr("Image Manipulation Widgets");
- }
- QIcon IconEditorPlugin::icon() const
- {
- return QIcon(":/images/iconeditor.png");
- }
- QString IconEditorPlugin::toolTip() const
- {
- return tr("An icon editor widget");
- }
- QString IconEditorPlugin::whatsThis() const
- {
- return tr("This widget is presented in Chapter 5 of <i>C++ GUI "
- "Programming with Qt 4</i> as an example of a custom Qt "
- "widget.");
- }
- bool IconEditorPlugin::isContainer() const
- {
- return false;
- }
- QWidget *IconEditorPlugin::createWidget(QWidget *parent)
- {
- return new IconEditor(parent);
- }
- Q_EXPORT_PLUGIN2(iconeditorplugin, IconEditorPlugin)
構(gòu)造函數(shù)是一個空函數(shù)
函數(shù)name()返回控件的名稱。
函數(shù)includeFile()得到控件的頭文件,這個頭文件包含在moc產(chǎn)生的代碼中
函數(shù)group()返回的是控件所屬的工具箱的名字。如果Qt Designer中沒有這個名字,就會為這個控件創(chuàng)建一個新的組別。
函數(shù)icon()返回控件在Qt Designer中用的圖標(biāo)。這里我們假設(shè)IconEditorPlugin有關(guān)聯(lián)的資源文件,里面有一個圖標(biāo)編輯器的圖像。
在Qt Designer的控件箱中,當(dāng)鼠標(biāo)移動到自定義控件時,顯示toolTip()返回的字符串做為提示。
函數(shù)whatsThis()返回Qt Designer顯示的“What’s This”提問。
函數(shù)isContainer()返回true說明這個控件可以包含其他控件。例如,QFrame可以包含其他控件,則它是一個容器控件。很多Qt控件都可以包含其他控件,但是如果isContainer()返回false,Qt Designer就不允許這個控件包含其他控件了。
Qt Designer調(diào)運(yùn)函數(shù)createWidget()創(chuàng)建控件實(shí)例,指定父控件。
宏Q_EXPORT_PLUGIN2()必須在源文件的最后聲明,這個宏使Qt Designer能夠得到這個插件。第一個參數(shù)是這個插件的名字,第二個參數(shù)是實(shí)現(xiàn)這個插件類的名字。
.pro文件如下:
- TEMPLATE = lib
- CONFIG += designer plugin release
- HEADERS = ../iconeditor/iconeditor.h \
- iconeditorplugin.h
- SOURCES = ../iconeditor/iconeditor.cpp \
- iconeditorplugin.cpp
- RESOURCES = iconeditorplugin.qrc
- DESTDIR = $(QTDIR)/plugins/designer
.pro文件假定QTDIR位于Qt的安裝目錄。在運(yùn)行make或者nmake后,程序自動它安裝到Qt Designer的插件目錄中。安裝成功后,我們就能象其他控件一樣在Qt Designer中使用它了 。如果想在Qt Designer集成多個控件,你可以為每個控件創(chuàng)建一個上面裝佯的插件庫,也可以使用QDesignerCustomWidgetCollectionInterface一次性創(chuàng)建。