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中。
这里是插件类的定义:

#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);  
}; 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.

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

源文件如下:

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) 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.

构造函数是一个空函数

函数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文件如下:

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  
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.

.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-06-20 16:03:03

Qt 控件 鼠标

2011-07-05 18:51:51

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

2011-07-04 16:31:24

QT 部件

2011-06-27 16:37:08

Qt Designer

2011-06-08 15:14:46

Qt 教程

2015-02-12 15:33:43

微信SDK

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-07-04 16:20:54

QT 窗口 QWidget

2011-06-23 15:10:39

Qt 窗体
点赞
收藏

51CTO技术栈公众号