学习Qt之属性系统详解

---

一、属性系统有什么用？

一般我们说一个类有什么属性，指的就是这个类有啥成员变量。比如People类中有个int age的私有成员变量，我们就可以说这个People类有个“年龄”属性可以更改读取。

Qt提供的属性系统，作用就是把类的信息暴露出来成为通用的、大家都认识的信息。比如用C++语言写的People类中中有个int age变量，但所如果用QML语言去读取就会出问题，因为QML有自己的规则，它不认识C++规则。用Qt的属性系统就可以解决这个问题，当一个类的成员变量或者成员函数用属性系统处理一下，它们就从C++内部中暴露出来，而且大家都认得。

属性系统是专门为元对象系统服务

---

二、属性详解

Qt提供一个Q_PROPERTY()宏可以定义属性，它也是基于元对象系统实现的。Qt的属性系统与C++编译器无关，可以用任何标准的C++编译器编译定义了属性的Qt C++程序。

在QObject的子类中，用宏Q_PROPERTY()定义属性，其使用格式如下：

Q_PROPERTY(type name (READ getFunction [WRITE setFunction] | MEMBER memberName  [(READ getFunction | WRITE setFunction)])
		[RESET resetFunction]
		[NOTIFY int]
		[REVISION int]
		[DESIGNABLE bool]
		[SCRIPTABLE bool]
		[STORED bool]
		[USER bool]
		[CONSTANT]
		[FINAL])

注意：

getFunction的返回值类型必须为type；
setFunction的返回值必须为空，而且必须带一个参数
例如：type getFunction();、void setFunction(type n);
指定了MEMBER之后就能再指定READ和WRITE

Q_PROPERTY()宏定义一个返回值类型为type，名称为name的属性，用READ、WRITE关键字定义属性的读取、写入函数，还有其他的一些关键字定义属性的一些操作特性。属性的类型可以是QVarient支持的任何类型，也可以用户自定义类型。

Q_PROPERTY()宏定义属性的一些关键字的意义如下：

• READ：指定一个读取属性值的函数，没有MEMBER关键字必须设置READ。
• WRITE：指定一个设定属性值的函数，只读属性没有WRITE设置。
• MEMBER：指定一个成员变量与属性关联，成为可读科协的属性，无需再设置READ和WRITE。
• RESET：可选，用于指定一个设置属性缺省值的函数。
• NOTIFY：可选，用于设置一个信号，当属性值变化时发射此信号。
• DESIGNABLE：表示属性是否在Qt Dseigner里可见，缺省为true。
• CONSTANT：表示属性值是一个常数，对于一个对象示例，READ指定的函数返回值是常数，但是每个实例的返回值可以不一样。具体CONSTANT关键字的属性不能有WRITE和NOTIFY关键字。
• FINAL：表示所定义的属性不能被子类重载。

---

三、属性定义

1. READ和WRITE

//头文件
Class Widget : public QObject
{
		Q_PROPERTY(int age READ readAge WRITE setAge)
		Q_OBJECT
public:
		explicit Widget(QWidget *parent = 0);
   		 ~Widget();
   		 
		int my_age;
		
		int readAge();
		void setAge(int n);
}

//源文件
int Widget::readAge()
{
		return my_age;
}
void Widget::setAge(int n)
{
		my_age = n;
}

2. MEMBER

//头文件
Class Widget : public QObject
{
		Q_PROPERTY(int age MEMBER my_age NOTIFY ageChanged)
		Q_OBJECT
public:
		explicit Widget(QWidget *parent = 0);
   		 ~Widget();

		int my_age;

		int readAge();
		void setAge(int n);
signal:
		void ageChanged();
}

//源文件
int Widget::readAge()
{
		return my_age;
}
void Widget::setAge(int n)
{
		my_age = n;
}

---

四、属性使用

如果是用READ、WRITE，直接调用指定的函数即可，例如：

Widget *w = new Widget;
w->setAge(true);

如果是用MEMBER，那么用QObject的property()和setProperty()两个函数，如：

Widget *w = new Widget;
w->property("age");
w->setProperty("age",18);

两种方法，使用WRITE效率更高、速度更快，而且在编译阶段就可以进行类型检查。缺点就是还没运行前你就得了解这个类使用readAge()这个函数。而采用MEMBER方式时，我们不需要知道这个类有啥函数、有啥变量，只需要知道这个类有一个叫“age”的属性值就可以。

---

五、类的附加信息

属性系统还有一个宏Q_CLASSINFO()，可以为类的元对象定义“名称–值”信息，如：

//头文件
Class Widget : public QObject
{
		Q_CLASSINFO("author","Wang")
		Q_CLASSINFO("version","3.0.1")
		Q_OBJECT
public:
		explicit Widget(QWidget *parent = 0);
   		 ~Widget();
}

//使用
Widget *w = new Widget;
w->metaObject()->classInfo(0).name();
w->metaObject()->classInfo(0).value();

w->metaObject()->classInfo(1).name();
w->metaObject()->classInfo(1).value();