[Qt入门篇]7 Qt的属性系统——NOTIFY和RESET

接上一篇，READ、WRITE和MEMBER能够实现属性读写，就Qt本身来讲，我觉得Qt更推荐使用READ和WRITE，而不是MEMBER，这从QWidget的声明中能够看出来——所有属性的读写都是READ和WRITE定义的，没有使用MEMBER。这也可以理解，MEMBER将属性关联了成员变量，用户修改属性时相当于直接对成员变量操作，这样的操作破坏了类的封闭性；而READ和WRITE则是使用类成员函数来修改成员变量，这是OOP（面向对象编程）提倡的方式，所以大家还是尽量使用WRITE和READ来定义属性。

READ、WRITE和MEMBER修改属性一般来说就足够了，但是考虑到有时要触发信号（这是Qt的特色，不能忽略）所以还需要一个NOTIFY关键字；要恢复属性默认值，还需要一个RESET关键字。
还是QWidget例子：
Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle NOTIFY windowTitleChanged DESIGNABLE isWindow)
这个声明包含了“NOTIFY windowTitleChanged”，表明当windowTitle属性发生变化时，会触发windowTitleChanged信号，相应的信号声明在QWidget中
Q_SIGNALS:
void windowTitleChanged(const QString &title);
Q_PROPERTY(QLocale locale READ locale WRITE setLocale RESET unsetLocale)
这个声明包含了“RESET unsetLocale”，表明QWidget有一个unsetLocale方法用于重置locale属性，QWidget声明中有：
public:
void unsetLocale();
NOTIFY signalfun：表明属性变化时会触发signalfun信号，signalfun的声明有两种形式，一种是带一个参数，参数类型与属性值相同，该参数存储了最新的值，加不加const都可以；另一种不带参数。
RESET fun：表明重置属性的函数，该接口将属性设置为默认值，它的形式只有一种：没有参数和返回值。
那如何来使用NOTIFY和RESET呢？我们定义如下代码：
声明：

#ifndef COBJ2_H
#define COBJ2_H

#include <QObject>

class CObj2 : public QObject
{
Q_OBJECT
Q_PROPERTY(qint32 test READ test WRITE setTest NOTIFY testChanged RESET unset)
Q_PROPERTY(qint32 test1 READ test WRITE setTest NOTIFY testChanged1)
public:
explicit CObj2(QObject *parent = 0);
qint32 test(void);
void setTest(qint32 t);
signals:
void testChanged(qint32 t);
void testChanged1(void);
public slots:
void OnTestChanged(qint32 t);
void OnTestChanged1(void);
void unset(void);
private:
qint32 m_test;
};

#endif // COBJ2_H
实现：
#include "cobj2.h"
#include <QDebug>

CObj2::CObj2(QObject *parent) : QObject(parent)
{
m_test = 0;
connect(this, SIGNAL(testChanged(qint32)), this, SLOT(OnTestChanged(qint32)));
connect(this, SIGNAL(testChanged1()), this, SLOT(OnTestChanged1()));
}

qint32 CObj2::test(void)
{
return (m_test);
}

void CObj2::setTest(qint32 t)
{
m_test = t;
}

void CObj2::OnTestChanged(qint32 t)
{
qDebug() << "OnTestChanged : " << t;
}

void CObj2::OnTestChanged1(void)
{
qDebug() << "OnTestChanged1";
}

void CObj2::unset(void)
{
m_test = 0;
}

COjb2中我们定义了两个属性：test和test1，test改变时触发testChanged信号，test1改变时触发testChanged1信号，其中test还有RESET方法unset。

在客户端调用如下代码：

CObj2 s;

s.setProperty("test", QVariant(2));

s.setProperty("test1", QVariant(3));

如果一切正常，那么应该有字符串输出，希望如此，点击运行……什么都没有出现，这是为什么呢？原因是这样的，以test属性为例，

Q_PROPERTY(qint32 test READ test WRITE setTest NOTIFY testChanged RESET unset)

这里仅是告诉元对象系统test属性改变时会发出testChanged信号，但是它不是实现，具体的实现需要我们自己来完成，这就需要修改setTest函数：

void CObj2::setTest(qint32 t)
{
m_test = t;
emit testChanged(t);
emit testChanged1();
}

在代码中主动添加信号触发语句，修改之后再运行，可以得到预期输出：

OnTestChanged : 2

OnTestChanged1

OnTestChanged : 3

OnTestChanged1

这个例子可以说明两点：

1 NOTIFY信号触发需要在WRITE关联的函数中加入触发代码；

2 NOTIFY信号关联的成员函数可以支持带一个参数，也可以不带参数。

那么如果NOTIFY信号声明之后，不需要添加emit代码就能触发呢？这也是可以的，这种情况需要将NOTIFY和MEMBER搭配使用，在CObj2中增加一个新的属性：

#ifndef COBJ2_H
#define COBJ2_H

#include <QObject>

class CObj2 : public QObject
{
Q_OBJECT
Q_PROPERTY(qint32 test READ test WRITE setTest NOTIFY testChanged RESET unset)
Q_PROPERTY(qint32 test1 READ test WRITE setTest NOTIFY testChanged1)
Q_PROPERTY(qint32 test2 MEMBER m_test NOTIFY testChanged3)
public:
explicit CObj2(QObject *parent = 0);
qint32 test(void);
void setTest(qint32 t);
signals:
void testChanged(qint32 t);
void testChanged1(void);
void testChanged3(qint32 t);
public slots:
void OnTestChanged(qint32 t);
void OnTestChanged1(void);
void unset(void);
private:
qint32 m_test;
};

修改实现文件如下：

#include "cobj2.h"
#include <QDebug>

CObj2::CObj2(QObject *parent) : QObject(parent)
{
m_test = 0;
connect(this, SIGNAL(testChanged(qint32)), this, SLOT(OnTestChanged(qint32)));
connect(this, SIGNAL(testChanged1()), this, SLOT(OnTestChanged1()));
connect(this, SIGNAL(testChanged3(qint32)), this, SLOT(OnTestChanged(qint32)));
}

qint32 CObj2::test(void)
{
return (m_test);
}

void CObj2::setTest(qint32 t)
{
m_test = t;
emit testChanged(t);
emit testChanged1();
}

void CObj2::OnTestChanged(qint32 t)
{
qDebug() << "OnTestChanged : " << t;
}

void CObj2::OnTestChanged1(void)
{
qDebug() << "OnTestChanged1";
}

void CObj2::unset(void)
{
m_test = 0;
}

客户端调用:

CObj2 s;

s.setProperty("test2", QVariant(4));

运行后输出：

OnTestChanged : 4

此时，没有手工添加emit代码，信号仍旧被触发了。