[转] Qt属性setProperty & propert…

reprinted from：http://spaces.msn.com/members/nzt/Blog/cns!1pmB0kdXbVha3bZHlaGN-REA!273.entry

1.属性有什么用？
由于c++类具备封装特性，不推荐对类成员变量(classvariables)进行直接存取。现代编译器引用属性(property)的概念，对成员变量进行安全的存取。比如在win平台下vc7有类似于__property或[property]的支持。Qt由于要实现其跨平台(crossplatform)，引入一套独特的属性系统。其底层是由meta compiling进行支持。

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

* Q_PROPERTY: qt里定义的宏；
* type name: 即类型名＋属性名，属性名(name)在QObject的setProperty里被引用；
* READ:设置读取成员变量的函数名，一定要是const，可以返回void，Qvariant支持的对象，指针，或const的引用。READ是必须的，而write,reset等则是可选的；只有READ的属性为只读属性；
* WRITE:写成员变量的函数名，返回值必须是void，可以设置一个参数，这个参数可以是void，QVaraint支持的变量，指针，或const的引用。可选；具备READ和WRITe的属性是可读写属性。
* DESIGNABLE:　指示该属性是否被图形编辑器（比如designer）使用。默认是TRUE；
* SCRIPTABLE:指示是否在script里使用，Trolltech公司同时有基于Qt的QSA，用于在应用程序的脚本编程；默认是TRUE；
* STORED:指示是否可被持久化(persistence)。只有WRITE被设定的时候，STORED才有效。默认是TRUE。


3. 使用
比有一个类，

class MyClass : public QObject
{
Q_OBJECT

public:
MyClass (QString f) {this->f =f;}
~MyClass() {}

//property begin
QString getF() const {return f;}
void setF(QString ff) {f=ff;} 
//property end

private:
QString f;
};

这时在public之前定义property
Q_PROPERTY (QString F READ getF WRITE setF)

照惯例，读取函数往往省略get，即定义了
QString F() const {return f;}
这时，Q_PROPERTY (QString F READ F WRITE setF)
但实际上，读取、写、和重置(reset)函数可以是任何名字，比如前面用getF。

在使用时，属性跟一般的成员函数一样被使用，比如：
MyClass classA("initial");
QString out=classA.getF();
//out = "initial"
QString t="this is a test";
classA.setF(t);
//classA里的f现在是"this is a test"

此外，可以通过QObject::setProperty()和property()来使用属性，比如
MyClass classB("classB");
//这时的f是"classB"
classB.setProperty("F", "this is a test");
//这时调用setF("this is a test")，成员变量f现在是"this is a test"

使用setProperty可能效率比直接调用setF低，但注意到setProperty是基类的成员，所以通过QObject::property/setProperty可以遍历全部派生自QOjbect的类的属性。比如：
QObject* p = &classA;
p->setProperty("F", "test A");
p=&classB;
p->setProperty("F", "test B");
熟悉多态的朋友，马上就应该联想到这种机制的一些优越性。其中奥秘请看多类的相关描述，这里主要讲Qt的属性，不赘。

QObject::property/setProperty跟QMetaObject::propertyCount()，和QMetaObject::property()结合起来，可以实现动态的函数调用，类似于dotnet里的reflection机制。

4.如果property的参数是enum，那么在定义Q_PROPERTY时，必须先告诉metasystem使用的enum，使用宏Q_ENUMS，次序无关，如：

Q_PROPERTY(Priority priority READ priority WRITEsetPriority)
Q_ENUMS(Priority)

其中Priority是枚举类型。

5.一个较为复杂的例子，使用了一个引用输入属性的写函数。请注意，此引用必须为const。

////CaliforniaWhiteWine.h
#include <QObject>

class WhiteWine
{};

class CaliforniaWhiteWine :
public QObject
{
Q_OBJECT
Q_PROPERTY(WhiteWine& m_wine READ getWine WRITEsetWine)
public:
CaliforniaWhiteWine();
CaliforniaWhiteWine(WhiteWine& wine);
~CaliforniaWhiteWine();

WhiteWine& getWine() const;
void setWine(const WhiteWine& wine)
{
delete m_wine;
*m_wine = wine;
}
protected:
WhiteWine* m_wine;
};

////CaliforniaWhiteWine.cpp
#include ".\californiawhitewine.h"

CaliforniaWhiteWine::CaliforniaWhiteWine(void)
{
this->m_wine=new WhiteWine();
}

CaliforniaWhiteWine::~CaliforniaWhiteWine(void)
{
delete m_wine;
}

CaliforniaWhiteWine::CaliforniaWhiteWine(WhiteWine&wine)
{

}

WhiteWine& CaliforniaWhiteWine::getWine()const
{
return *m_wine;
}