[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呢？我们定义如下代码：
声明：

[cpp]  view plain  copy

1. #ifndef COBJ2_H  
2. #define COBJ2_H  
3.   
4. #include <QObject>  
5.   
6. class CObj2 : public QObject  
7. {  
8. Q_OBJECT  
9. Q_PROPERTY(qint32 test READ test WRITE setTest NOTIFY testChanged RESET unset)  
10. Q_PROPERTY(qint32 test1 READ test WRITE setTest NOTIFY testChanged1)  
11. public:  
12. explicit CObj2(QObject *parent = 0);  
13. qint32 test(void);  
14. void setTest(qint32 t);  
15. signals:  
16. void testChanged(qint32 t);  
17. void testChanged1(void);  
18. public slots:  
19. void OnTestChanged(qint32 t);  
20. void OnTestChanged1(void);  
21. void unset(void);  
22. private:  
23. qint32 m_test;  
24. };  
25.   
26. #endif // COBJ2_H  
27. 实现：  
28. #include "cobj2.h"  
29. #include <QDebug>  
30.   
31. CObj2::CObj2(QObject *parent) : QObject(parent)  
32. {  
33. m_test = 0;  
34. connect(this, SIGNAL(testChanged(qint32)), this, SLOT(OnTestChanged(qint32)));  
35. connect(this, SIGNAL(testChanged1()), this, SLOT(OnTestChanged1()));  
36. }  
37.   
38. qint32 CObj2::test(void)  
39. {  
40. return (m_test);  
41. }  
42.   
43. void CObj2::setTest(qint32 t)  
44. {  
45. m_test = t;  
46. }  
47.   
48. void CObj2::OnTestChanged(qint32 t)  
49. {  
50. qDebug() << "OnTestChanged : " << t;  
51. }  
52.   
53. void CObj2::OnTestChanged1(void)  
54. {  
55. qDebug() << "OnTestChanged1";  
56. }  
57.   
58. void CObj2::unset(void)  
59. {  
60. m_test = 0;  
61. }  

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函数：

[cpp]  view plain  copy

1. void CObj2::setTest(qint32 t)  
2. {  
3. m_test = t;  
4. emit testChanged(t);  
5. emit testChanged1();  
6. }  

在代码中主动添加信号触发语句，修改之后再运行，可以得到预期输出：
OnTestChanged : 2
OnTestChanged1
OnTestChanged : 3
OnTestChanged1
这个例子可以说明两点：
1 NOTIFY信号触发需要在WRITE关联的函数中加入触发代码；
2 NOTIFY信号关联的成员函数可以支持带一个参数，也可以不带参数。
那么如果NOTIFY信号声明之后，不需要添加emit代码就能触发呢？这也是可以的，这种情况需要将NOTIFY和MEMBER搭配使用，在CObj2中增加一个新的属性：

[cpp]  view plain  copy

1. #ifndef COBJ2_H  
2. #define COBJ2_H  
3.   
4. #include <QObject>  
5.   
6. class CObj2 : public QObject  
7. {  
8. Q_OBJECT  
9. Q_PROPERTY(qint32 test READ test WRITE setTest NOTIFY testChanged RESET unset)  
10. Q_PROPERTY(qint32 test1 READ test WRITE setTest NOTIFY testChanged1)  
11. Q_PROPERTY(qint32 test2 MEMBER m_test NOTIFY testChanged3)  
12. public:  
13. explicit CObj2(QObject *parent = 0);  
14. qint32 test(void);  
15. void setTest(qint32 t);  
16. signals:  
17. void testChanged(qint32 t);  
18. void testChanged1(void);  
19. void testChanged3(qint32 t);  
20. public slots:  
21. void OnTestChanged(qint32 t);  
22. void OnTestChanged1(void);  
23. void unset(void);  
24. private:  
25. qint32 m_test;  
26. };  

修改实现文件如下：

[cpp]  view plain  copy

1. #include "cobj2.h"  
2. #include <QDebug>  
3.   
4. CObj2::CObj2(QObject *parent) : QObject(parent)  
5. {  
6. m_test = 0;  
7. connect(this, SIGNAL(testChanged(qint32)), this, SLOT(OnTestChanged(qint32)));  
8. connect(this, SIGNAL(testChanged1()), this, SLOT(OnTestChanged1()));  
9. connect(this, SIGNAL(testChanged3(qint32)), this, SLOT(OnTestChanged(qint32)));  
10. }  
11.   
12. qint32 CObj2::test(void)  
13. {  
14. return (m_test);  
15. }  
16.   
17. void CObj2::setTest(qint32 t)  
18. {  
19. m_test = t;  
20. emit testChanged(t);  
21. emit testChanged1();  
22. }  
23.   
24. void CObj2::OnTestChanged(qint32 t)  
25. {  
26. qDebug() << "OnTestChanged : " << t;  
27. }  
28.   
29. void CObj2::OnTestChanged1(void)  
30. {  
31. qDebug() << "OnTestChanged1";  
32. }  
33.   
34. void CObj2::unset(void)  
35. {  
36. m_test = 0;  
37. }  

客户端调用:
CObj2 s;
s.setProperty("test2", QVariant(4));
运行后输出：
OnTestChanged : 4
此时，没有手工添加emit代码，信号仍旧被触发了。