主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

属性

Qt提供了一套和一些编译器提供商也提供的属性系统类似的完善的属性系统。然而,作为一个不依赖编译器和平台的库,Qt不能依赖像__property或者[property]那样的非标准编译器特征。我们的解决方案可以在我们支持的每一个平台上和任何标准的C++编译器一起工作。它基于元对象系统,元对象系统也通过信号和槽提供对象通讯。

在类声明中的Q_PROPERTY宏声明了一个属性。属性只能在继承于QObject的子类中声明。第二个宏,Q_OVERRIDE,可以用来覆盖一些子类中由继承得到的属性。

对于外面的世界,属性看起来和一个数据成员非常类似。然而,属性和普通的数据成员还是有一下一些不同点:

读、写和复位函数就像任何成员函数一样,继承或不继承,虚或不虚。只有一个例外就是,在多重继承的情况下,成员函数必须从第一个被继承类继承。

属性可以在不知道被使用的类的任何情况的时候通过QObject中的一般函数进行读写。下面两个函数调用是等效的:

    // QButton *b和QObject *o指向同一个按钮
    b->setDown( TRUE );
    o->setProperty( "down", TRUE );

等效的是指,除了第一个函数要快一些,在编译的时候提供了更好的诊断信息。在实际应用中,第一个函数更好些。然而,因为我们可以通过QMetaObject获得任何一个QObject的所有有用属性的一个列表,QObject::setProperty()可以让你控制类中那些在编译时不可用的属性。

QObject::setProperty()一样,还有一个相应的QObject::property()函数。QMetaObject::propertyNames()返回所有可用属性的名称。QMetaObject::property()返回一个指定属性的属性数据:一个QMetaProperty对象。

这里有一个简单的例子说明了可以应用的绝大多数重要属性函数:

    class MyClass : public QObject
    {
        Q_OBJECT
    public:
        MyClass( QObject * parent=0, const char * name=0 );
        ~MyClass();

        enum Priority { High, Low, VeryHigh, VeryLow };
        void setPriority( Priority );
        Priority priority() const;
    };

这个类有一个名为“priority”的还不被元对象系统所知的属性。为了让这个属性被元对象系统知道,你必须用Q_PROPERTY宏来声明它。声明语法如下:

Q_PROPERTY( type name READ getFunction [WRITE setFunction]
            [RESET resetFunction] [DESIGNABLE bool] 
            [SCRIPTABLE bool] [STORED bool] )

为了声明是有效的,读函数必须是常量函数并且返回值的类型是它本身或者是指向它的指针,或者是它的一个引用。可选的写函数必须返回void并且必须带有一个正确的参数,类型必须是它本身或者是指向它的指针,或者是它的一个常量引用。元对象编译器强迫这样的。

属性的类型可以是任何一个QVariant支持的类型或者是一个自己在类中已经定义的枚举类型。因为MyClass中的属性使用了枚举类型Priority,这个类型必须也向属性系统注册。这样的话,像如下方式通过名称来设置值是可行的:

    obj->setProperty( "priority", "VeryHigh" );

枚举类型必须使用Q_ENUMS宏来进行注册。这里是一个包含属性相关声明的最终的类声明:

    class MyClass : public QObject
    {
        Q_OBJECT
        Q_PROPERTY( Priority priority READ priority WRITE setPriority )
        Q_ENUMS( Priority )
    public:
        MyClass( QObject * parent=0, const char * name=0 );
        ~MyClass();

        enum Priority { High, Low, VeryHigh, VeryLow };
        void setPriority( Priority );
        Priority priority() const;
    };

另外一个类似的宏是Q_SETS。像Q_ENUMS一样,它注册了一个枚举类型,但是它额外的加了一个“set”的标记,也就是说,这个枚举数据可以被一起读或写。一个输入输出类也许有枚举数据“读”和“写”和接收“读|写”:这时最好用Q_SETS来声明一个枚举类型,而不是Q_ENUMS

Q_PROPERTY段剩余的关键字是RESETDESIGNABLESCRIPTABLE和STORED。

RESET指定一个函数可以设置属性到缺省状态(这个缺省状态可能和初始状态不同)。这个函数必须返回void并且不带有参数。

DESIGNABLE声明这个属性是否适合被一个图形用户界名设计工具修改。缺省的TRUE是说这个属性可写,否则就是FALSE说明不能。你可以定义一个布尔成员函数来替代TRUEFALSE

SCRIPTABLE声明这个属性是否适合被一个脚本引擎访问。缺省是TRUE,可以。你可以定义一个布尔成员函数来替代TRUEFALSE

STORED声明这个属性的值是否必须作为一个存储的对象状态而被记得。STORED只对可写的属性有意义。缺省是TRUE。技术上多余的属性(比如,如果QRect的geometry已经是一个属性了的QPoint的pos)定义为FALSE

连接到属性系统是一个附加宏,“Q_CLASSINFO”,它可以用来把名称/值这样一套的属性添加到一个类的元对象中,例如:

    Q_CLASSINFO( "Version", "3.0.0" )

和其它元数据一样,类信息在运行时是可以通过元对象访问的,具体请看QMetaObject::classInfo()。


Copyright © 2002 Trolltech Trademarks 译者:Cavendish
Qt 3.0.5版