Qt属性系统

得益于Qt反射机制，我们可以获取类对象的成员信息，这其中就包含了属性信息，属性其实就是类中的一种数据成员，不同在于属性需要通过宏定义Q_PROPERTY进行注册，它的使用也必须满足反射机制的条件——类须直接或间接继承QObject且包含Q_OBJECT宏，这样就可以通过元对象的属性类（QMetaProperty）来获取属性相关信息，下面是QMetaProperty的一些常用接口说明：

bool hasNotifySignal() const   //属性是否有关联信号

bool isConstant() const   //属性是否是常量不能更改

bool isDesignable(const QObject *object = nullptr) const //该属性在QDesigner的属性编辑器中是否可见

bool isEnumType() const    //属性是否为枚举类型

bool isFinal() const  //属性FINAL声明是否为true，为true表示该属性不可被重写

bool isFlagType() const    //属性是否为标志枚举类型

bool isReadable() const    //属性是否可读

bool isResettable() const    //属性是否可被重置

bool isScriptable(const QObject *object = nullptr) const   //属性是否可被脚本引擎访问

bool isStored(const QObject *object = nullptr) const   //对象状态保存时是否保存属性值

bool isUser(const QObject *object = nullptr) const    //属性是否可编辑，对应属性的USER声明

bool isValid() const     //属性是否有效

bool isWritable() const    //属性是否可写

const char *name() const     //返回属性的名称

QMetaMethod notifySignal() const    //返回关联了信号的属性的QMetaMethod实例

int notifySignalIndex() const     //返回属性关联通知信号的索引

int propertyIndex() const      //返回属性的索引

QVariant read(const QObject *object) const    //从给定对象object读取属性值

bool reset(QObject *object) const     //重置给定对象object的属性值

int revision() const     //返回属性指定的REVISION

QVariant::Type type() const    //返回属性的类型，具体类型参考QVariant::Type

const char *typeName() const     //返回属性的类型名称

int userType() const   //返回属性的用户类型，返回值是 QMetaType 已注册的值之一

bool write(QObject *object, const QVariant &value) const    //将value作为属性值写入对象object

这些属性信息接口都与注册属性有关，下面是关于属性注册宏Q_PROPERTY的介绍，Q_PROPERTY宏的使用语法如下：

Q_PROPERTY ( type name

             ( READ getFunction [WRITE setFunction] | MEMBER memberName 

[(READ getFunction | WRITE setFunction)] )

            [RESET resetFunction]

            [NOTIFY notifySignal]

            [REVISION int]

            [DESIGNABLE bool]

            [SCRIPTABLE bool]

            [STORED bool]

            [USER bool]

            [CONSTANT]

            [FINAL] )

在上述Q_PROPERTY宏定义的语法中，[ ]里的表示可选项，大写字母的选项名（READ）是不能更改的，小写字母除类型(int、bool等直接给定对应类型的值)外部分（type）是自行命名定义的，各选项之间用空格隔开，如：

下面是各选项的含义说明：

type：表示属性类型，需是QVariant支持的类型（具体参考之前QVariant 类的介绍）

name：表示指定属性名称

READ getFunction：其中READ表示可读， getFunction表示读取属性值的函数名，可自行设定

注：若没有指定 MEMBER 变量，则必须指定 READ 函数，而且getFunction通常为const函数，返回值为属性的类型或属性类型的引用

WRITE setFunction ：WRITE表示写入， setFunction表示设置属性值函数的名称

注：若属性为只读的则不能指定WRITE属性，setFunction的返回值必须为void且参数只能有一个

MEMBER memberName ：MEMBER表示指定成员， memberName表示被指定的类成员变量名称，类成员变量的命名上与属性应该有区分（通常命名规范中类成员变量前应添加m_以表示成员变量而属性无需添加如：成员变量m_value与属性value ），该属性用于设置成员变量memberName具备可读可写性质；注：若没指定READ则必须指定MEMBER

RESET resetFunction ：表示重置属性为默认值， resetFunction不能有参数和返回值

NOTIFY notifySignal ：表示指定与属性关联的信号notifySignal，即当属性值变化时就会触发信号notifySignal

REVISION int ：设置版本号，默认为0

DESIGNABLE bool：表示设置属性在Qt设计师的属性编辑器中是否可见，默认为true（可见）

SCRIPTABLE bool：表示设置属性是否可被脚本引擎访问，默认为true

STORED bool：设置保存对象状态时是否必须保存属性值，多数情况默认为true

USER bool：设置属性是否为可编辑属性，每一个类只能有一个USER属性指定，默认为false

CONSTANT：表示属性值是常量，常量属性不能指定WRITE与NOTIFY选项

FINAL：表示属性不能被子类重写

以上方式设置的是静态属性，在Qt中的类还可以设定动态属性，所谓动态属性就是未使用Q_PROPERTY宏注册而通过调用QObject::setProperty()方法添加的属性。动态属性可通过设置无效的QVariant对象进行删除该动态属性，另外动态属性属于类对象的实例，不满足元对象属性机制，不能使用元对象获取动态属性信息，但可使用QObject::property()进行属性值的获取。

QVariant property(const char *name) const

作用：获取指定名称属性的值，若指定名称的属性不存在则返回无效的QVariant

bool setProperty(const char *name, const QVariant &value)

作用：设置指定名称属性的值，若设置的属性已用Q_PROPERTY在类中注册，且值类型与属性类型兼容（Qt中可自动转换的类型）则设定属性值为value并返回true，若给定值类型不兼容则值设定无效并返回false；若设置的属性未使用宏定义Q_PROPERTY在类中注册，则动态添加指定名称的属性并设置给定值，此时也返回false

使用setProperty和property方法也可以设置和获取静态属性信息，若属性有相关联的读取和写入函数（getFunction与setFunction，通常Qt中属性获取函数的名称定义时前面不添加get），则可使用对应的读写函数进行读取和写入。