2.2.4 属性
C++的类成员只有方法与字段,没有属性和事件,这给开发者带来了不便。为了实现Objective-C中提供的属性功能,我们不得不使用方法来模拟get和set访问器。Cocos2d-x规定了属性访问器的方法名称以get或set为前缀,后接属性名。在CCNode中包含大量属性,例如用于给节点做标记的Tag属性,它的访问器分别为getTag()和setTag(int aTag),其实现原理大致如下:
- int tag;
- int getTag() { return tag; }
- void setTag(int aTag) { tag = aTag; }
在这个例子中,属性的类型是int,处理较为简单。由于涉及内存管理,开发中我们对数值类型、结构体类型、Cocos2d-x对象的处理方法都不尽相同,这一点在读者了解2.3节介绍的Cocos2d-x内存管理后,会有更深刻的体会。
为每一个属性编写一个或两个访问器方法是一项十分枯燥的任务,为了避免重复性的工作,Cocos2d-x提供了一系列宏来帮助我们方便地创建属性。表2-1列举了所有属性相关的宏,它们定义在引擎目录中的"platform/CCPlatformMacros.h"中。
表2-1 Cocos2d-x中与属性相关的宏
宏
|
描述
|
CC_PROPERTY
|
定义一个属性及其访问器,没有实现。
通常用于简单的值类型
|
CC_PROPERTY_READONLY
|
定义一个属性,只包含
get
访问器,没有实现
|
CC_PROPERTY_PASS_BY_REF
|
定义一个属性,访问器使用引用类型传
递参数,没有实现。通常用于结构体类型
|
CC_PROPERTY_READONLY_PASS_BY_REF
|
定义一个属性,只包含
get
访问器,
且使用引用类型传递参数,没有实现
|
(续)
宏
|
描述
|
CC_PROPERTY_READONLY_PASS_BY_REF
|
定义一个属性,只包含
get
访问器,
且使用引用类型传递参数,没有实现
|
CC_SYNTHESIZE
|
同
CC_PROPERTY
,实现了访问器方法
|
CC_SYNTHESIZE_READONLY
|
同
CC_PROPERTY_READONLY
,实现了访问器方法
|
CC_SYNTHESIZE_PASS_BY_REF
|
同
CC_PROPERTY_PASS_BY_REF
,
实现了访问器方法
|
CC_SYNTHESIZE_READONLY_PASS_BY_REF
|
同
CC_PROPERTY_READONLY_PASS_BY_REF
,
实现了访问器方法
|
CC_SYNTHESIZE_RETAIN
|
同
CC_PROPERTY
,实现了访问器方法。
用于派生自
CCObject
的类型,访问
器采取
Cocos2d-x
的内存管理机
制自动维护
对象的引用计数
|
这些宏只要写在类的定义之中即可。每个宏都有3个参数,分别是:varType,属性类型,如果属性类型是对象,需要写成指针的形式;varName,属性的私有字段名称;funName,属性的访问器名称,也就是紧接在get或set前缀后的部分。
利用Cocos2d-x提供的宏,上面的Tag属性定义就可以用下面一条语句代替了:
- CC_SYNTHESIZE(int, tag, Tag)