• 17106阅读
  • 8回复

【原创】Qt里的属性(property) [复制链接]

上一主题 下一主题
离线giscn
 
只看楼主 倒序阅读 楼主  发表于: 2005-08-23
Qt里的属性(property)

giscn[at]msn[dot]com

1.属性有什么用?
由于c++类具备封装特性,不推荐对类成员变量(class variables)进行直接存取。现代编译器引用属性(property)的概念,对成员变量进行安全的存取。比如在win平台下 vc7有类似于__property或[property]的支持。Qt由于要实现其跨平台(cross platform),引入一套独特的属性系统。其底层是由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时,必须先告诉meta system使用的enum,使用宏Q_ENUMS,次序无关,如:

Q_PROPERTY(Priority priority READ priority WRITE setPriority)
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 WRITE setWine)
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;
}

原帖地址:http://spaces.msn.com/members/nzt/Blog/cns!1pmB0kdXbVha3bZHlaGN-REA!273.entry
[ 此贴被XChinux在2005-08-23 18:26重新编辑 ]
http://nzt.spaces.live.com
离线yfy002

只看该作者 1楼 发表于: 2005-08-24
不错不错,顶,支持原创
我渴望平静,风却给了我涟漪
我的blog:
http://sungaoyong.cublog.cn
离线yanboo

只看该作者 2楼 发表于: 2005-08-24
学习中
离线giscn
只看该作者 3楼 发表于: 2005-08-24
4.0.1里property如果以 引用 作输入参数,不能编译,好象它的MOC系统有些问题。已经提交到Qt development team
但4.0.0没有问题
http://nzt.spaces.live.com
离线XChinux

只看该作者 4楼 发表于: 2005-08-24
4.0.1里去除了老错误,但引进了些新错误。
希望早点能修复。
二笔 openSUSE Vim N9 BB10 XChinux@163.com 网易博客 腾讯微博
承接C++/Qt、Qt UI界面、PHP及预算报销系统开发业务
离线zwcxxl

只看该作者 5楼 发表于: 2005-09-16
还没有搞懂是什么意思:)能否麻烦大虾给我们详细系统的讲解一下,多谢;)
离线XChinux

只看该作者 6楼 发表于: 2005-09-16
就是在不增加关键字支持的情况下实现的属性机制,这种机制可使在Designer中的属性框中进行设置。
在使用的时候要使用特殊的方法来使用。
二笔 openSUSE Vim N9 BB10 XChinux@163.com 网易博客 腾讯微博
承接C++/Qt、Qt UI界面、PHP及预算报销系统开发业务
离线hehui

只看该作者 7楼 发表于: 2005-11-24
学习!!!
离线avacool
只看该作者 8楼 发表于: 2005-12-03
感谢!

不过5里面那个例子没看懂 -_-##
快速回复
限100 字节
 
上一个 下一个