libcdos-fw
CFObject类 参考

支持库的基础类。 更多...

#include <CFObject.h>

+ 类 CFObject 继承关系图:

Public 成员函数

void * getObj ()
 获取支持库类实例所绑定的对象实例。 更多...
 
virtual ~CFObject ()
 析构函数。 更多...
 

静态 Public 成员函数

static CFObjectgetCFObject (void *realObj)
 通过对象实例获取所对应的 CFObject的子类对象实例。 更多...
 

Protected 成员函数

 CFObject ()
 构造函数 更多...
 
virtual void onRealObjectFinalize ()
 对象解除绑定前的回调函数。 更多...
 
virtual void onRealObjectInit ()
 对象绑定后进行初始化的回调函数。 更多...
 
void setRealObject (void *obj)
 将自身实例与需要使用的对象实例进行绑定。 更多...
 

详细描述

支持库的基础类。

支持库最基础的类, 需要使用支持库特性的类,都需要继承自本类。
本类为抽象类,无法被实例化,只可以被继承。

CFObject中,包含了支持库与实际需要使用的实例的映射机制,若需要使用该机制,则需要注意以下几个函数的使用:
setRealObject() 函数, 可以将继承类与实际使用类的实例进行关联,并将其储存在一个全局的映射表中; 需要获取
实际使用的实例,可以使用 getObj() 函数来获取该实例的指针; 若需要通过实际使用的类实例来获取与其绑定的支持
库类实例, 则需要使用 getCFObject() 来获取。

若需要在类实例绑定后, 对使用类进行信号绑定或其它必要操作时,需要重写父类的 onRealObjectInit() 函数,
在子类继承并重写父类的 onRealObjectInit() 函数时,请在其内部调用父类的 onRealObjectInit() 函数,以便
父类进行必要的操作。

构造及析构函数说明

§ ~CFObject()

virtual CFObject::~CFObject ( )
virtual

析构函数。

在类被销毁的时候会被自动调用。

§ CFObject()

CFObject::CFObject ( )
protected

构造函数

CFObject类的默认构造函数。
本构造函数为保护的,无法被直接实例化,但允许被继承。

成员函数说明

§ getCFObject()

static CFObject* CFObject::getCFObject ( void *  realObj)
static

通过对象实例获取所对应的 CFObject的子类对象实例。

使用 setRealObject() 函数将支持库类实例与所需要使用的对象实例进行绑定。
可以使用该函数通过使用的对象实例来获取与其绑定的支持库类实例。

参数
[in]realObj对象实例。
返回
返回与realObj绑定的支持库类对象实例。

§ getObj()

void* CFObject::getObj ( )

获取支持库类实例所绑定的对象实例。

获取通过 setRealObject() 函数所绑定的对象实例。

返回
返回所绑定的对象实例。

§ onRealObjectFinalize()

virtual void CFObject::onRealObjectFinalize ( )
protectedvirtual

对象解除绑定前的回调函数。

若需要在类实例解除绑定前, 对使用类进行信号解除绑定或其它必要操作时,需要重写父类的 onRealObjectFinalize() 函数,
在子类继承并重写父类的 onRealObjectFinalize() 函数时,请在该函数返回前调用父类的 onRealObjectFinalize() 函数,以便
父类进行必要的操作。

CFWidget, CFPlacesSidebar, CFListWidget, CFScrolledView, CFAdjustment, CFRange, CFMenuItem, CFMenuShell, CFSwitch, CFRadioButton, CFCheckButton , 以及 CFButton 重载.

§ onRealObjectInit()

virtual void CFObject::onRealObjectInit ( )
protectedvirtual

对象绑定后进行初始化的回调函数。

在使用 setRealObject() 绑定对象实例后, 本回调函数即会被调用,
若需要在类实例绑定后, 对使用类进行信号绑定或其它必要操作时,需要重写父类的 onRealObjectInit() 函数,
在子类继承并重写父类的 onRealObjectInit() 函数时,请在其内部调用父类的 onRealObjectInit() 函数,以便
父类进行必要的操作。

CFWidget, CFPlacesSidebar, CFListWidget, CFScrolledView, CFAdjustment, CFRange, CFMenuItem, CFMenuShell, CFSwitch, CFRadioButton, CFButton, CFCheckButton , 以及 CFEntry 重载.

§ setRealObject()

void CFObject::setRealObject ( void *  obj)
protected

将自身实例与需要使用的对象实例进行绑定。

将自身实例与参数 obj 进行绑定, 并储存在一个全局的映射表中,
以方便使用 getObj()getCFObject() 进行获取。

参数
[in]obj需要绑定的对象实例。

该类的文档由以下文件生成: