Qt 创建自定义部件集成到Qt Designer中

移动开发
本文介绍的是Qt 创建自定义部件并集成在 Qt Designer中,Qt Designer为程序员提供了可视化的设计能力,可用于开发应用程序中的所有或者部分窗体。

Qt Designer为程序员提供了可视化的设计能力,可用于开发应用程序中的所有或者部分窗体。交叉编译呢,简单地说,就是在一个平台上生成另一个平台上的可执行代码。这里需要注意的是所谓平台,实际上包含两个概念:体系结构(Architecture)、操作系统(Operating System)。同一个体系结构可以运行不同的操作系统;同样,同一个操作系统也可以在不同的体系结构上运行。

把自定义控件集成到Qt Designer中

要想在Qt Designer中使用自定义控件,必须要使Qt Designer能够知道我们的自定义控件的存在。有两种方法可以把新自定义控件的信息通知给Qt Designer:“升级”法和插件法。

升级法最为简便快捷。顾名思义,升级法就是把Qt自有的控件进行升级改造一番。找一个Qt自有的控件,如果它和我们新加的自定义控件有着相似的API,那么只要在Qt Designer的对话框里面完成一些新控件的信息就一切大吉,新控件就可以在Qt Designer中使用了。但是在编辑的时候和预览时,还是和原来的Qt控件没有什么两样。

现在把HexSpinBox控件用升级方法集成到Qt Designer中:

1、用Qt Designer创建一个新的窗体,把控件箱里的QSpinBox添加到窗体中。

2、右击旋转盒,选择“Promote to Custom Widget”上下文菜单。

3、在弹出的对话框中,类名处填写“HexSpinBox”,头文件填写“hexspinbox.h”

好了。在uic生成的包含有QSpinBox的控件文件中,包含文件变为“hexspinbox.h”,并且初始化为一个HexSpinBox的实例,而不是QSpinBox。在Qt Designer中,QSpinBox表示的控件为HexSpinBox,并且可以设置所有的QSpinBox的属性。

Figure 5.6. Qt Designer's custom widget dialog 
  
升级法的缺点是不能在Qt Designer中设置自定义控件自己的特有属性,也不能够绘制自己。这些问题可以用插件法解决。

插件法需要创建一个动态库,使Qt Designer能够在实时加载,创建控件的实例。这样,Qt Designer就可以在编辑窗体或者预览的时候使用自定义控件。Qt Designer用Qt的meta-object系统动态获得自定义控件的全部属性。现在以IconEditor为例,用插件法把IconEditor集成到Qt Designer中。

首先,我们从QDesignerCustomWidgetInterface继承一个类,重写一些虚函数。我们假定这个类的源代码在iconeditorplugin目录中,IconEditor类的代码在与它平行的目录iconeditor中。
这里是插件类的定义:

  1. #include <QDesignerCustomWidgetInterface> 
  2.  
  3. class IconEditorPlugin : public QObject, public QDesignerCustomWidgetInterface  
  4. {  
  5.     Q_OBJECT  
  6.     Q_INTERFACES(QDesignerCustomWidgetInterface)  
  7. public:  
  8.     IconEditorPlugin(QObject *parent = 0);  
  9.     QString name() const;  
  10.     QString includeFile() const;  
  11.     QString group() const;  
  12.     QIcon icon() const;  
  13.     QString toolTip() const;  
  14.     QString whatsThis() const;  
  15.     bool isContainer() const;  
  16.     QWidget *createWidget(QWidget *parent);  
  17. }; 

IconEditorPlugin是一个包装IconEditor控件的类厂,使用了双继承,父类为QObject和QDesignerCustomWidgetInterface。宏Q_INTERFACES()告诉moc第二个基类为一个插件接口类。Qt Designer使用类中的函数创建IconEditor的实例并得到有关它的信息。

源文件如下:

  1. IconEditorPlugin::IconEditorPlugin(QObject *parent)  
  2.     : QObject(parent)  
  3. {  
  4. }  
  5. QString IconEditorPlugin::name() const  
  6. {  
  7.     return "IconEditor";  
  8. }  
  9. QString IconEditorPlugin::includeFile() const  
  10. {  
  11.     return "iconeditor.h";  
  12. }  
  13. QString IconEditorPlugin::group() const  
  14. {  
  15.     return tr("Image Manipulation Widgets");  
  16. }  
  17. QIcon IconEditorPlugin::icon() const  
  18. {  
  19.     return QIcon(":/images/iconeditor.png");  
  20. }  
  21. QString IconEditorPlugin::toolTip() const  
  22. {  
  23.     return tr("An icon editor widget");  
  24. }  
  25. QString IconEditorPlugin::whatsThis() const  
  26. {  
  27.     return tr("This widget is presented in Chapter 5 of <i>C++ GUI "  
  28.               "Programming with Qt 4</i> as an example of a custom Qt "  
  29.               "widget.");  
  30. }  
  31. bool IconEditorPlugin::isContainer() const  
  32. {  
  33.     return false;  
  34. }  
  35. QWidget *IconEditorPlugin::createWidget(QWidget *parent)  
  36. {  
  37.     return new IconEditor(parent);  
  38. }   
  39. Q_EXPORT_PLUGIN2(iconeditorplugin, IconEditorPlugin) 

构造函数是一个空函数

函数name()返回控件的名称。

函数includeFile()得到控件的头文件,这个头文件包含在moc产生的代码中

函数group()返回的是控件所属的工具箱的名字。如果Qt Designer中没有这个名字,就会为这个控件创建一个新的组别。

函数icon()返回控件在Qt Designer中用的图标。这里我们假设IconEditorPlugin有关联的资源文件,里面有一个图标编辑器的图像。

在Qt Designer的控件箱中,当鼠标移动到自定义控件时,显示toolTip()返回的字符串做为提示。

函数whatsThis()返回Qt Designer显示的“What’s This”提问。

函数isContainer()返回true说明这个控件可以包含其他控件。例如,QFrame可以包含其他控件,则它是一个容器控件。很多Qt控件都可以包含其他控件,但是如果isContainer()返回false,Qt Designer就不允许这个控件包含其他控件了。

Qt Designer调运函数createWidget()创建控件实例,指定父控件

宏Q_EXPORT_PLUGIN2()必须在源文件的最后声明,这个宏使Qt Designer能够得到这个插件。第一个参数是这个插件的名字,第二个参数是实现这个插件类的名字。

.pro文件如下:

  1. TEMPLATE        = lib   
  2. CONFIG         += designer plugin release   
  3. HEADERS         = ../iconeditor/iconeditor.h \   
  4.                   iconeditorplugin.h   
  5. SOURCES         = ../iconeditor/iconeditor.cpp \   
  6.                   iconeditorplugin.cpp   
  7. RESOURCES       = iconeditorplugin.qrc   
  8. DESTDIR         = $(QTDIR)/plugins/designer  

.pro文件假定QTDIR位于Qt的安装目录。在运行make或者nmake后,程序自动它安装到Qt Designer的插件目录中。安装成功后,我们就能象其他控件一样在Qt Designer中使用它了 。如果想在Qt Designer集成多个控件,你可以为每个控件创建一个上面装佯的插件库,也可以使用QDesignerCustomWidgetCollectionInterface一次性创建。

责任编辑:zhaolei 来源: 互联网
相关推荐

2011-06-23 10:49:13

Qt 自定义信号

2011-06-13 14:29:40

Qt Designer

2011-07-05 18:51:51

QT 控件 鼠标

2011-06-20 16:03:03

Qt 控件 鼠标

2011-07-04 11:29:40

QT Designer

2011-06-10 11:24:08

Qt Quick Designer

2011-07-04 11:21:59

QT Designer

2011-06-27 16:07:49

Qt Designer

2015-02-12 15:33:43

微信SDK

2011-07-04 16:31:24

QT 部件

2011-06-27 16:37:08

Qt Designer

2011-06-08 15:14:46

Qt 教程

2011-07-04 13:17:18

Qt Designer 布局

2011-06-28 17:13:46

Qt Designer UI

2011-06-27 16:18:24

Qt Designer

2011-07-04 13:26:30

Qt Designer

2011-06-13 15:09:36

插件 Qt Designer

2011-07-04 13:08:26

Qt Designer

2011-06-23 15:10:39

Qt 窗体

2011-07-04 16:20:54

QT 窗口 QWidget
点赞
收藏

51CTO技术栈公众号