Form&Widget构架分析.doc

1、 Form .54. IForm：接口 .55. IRootForm：接口 .51.2. Form.61.2.1. 在 Form /加引用数量Form /减引用数量2. IQueryInforace 接口该接口继承于 IBASE 接口，支持接口查询，查询成功，返回对象的引用，并增加接口引用数量。 int (*QueryInterface)(iname *, AEECLSID, void *);/查询接口3. IHandler：接口; 该接口继承于 IQueryInerface 接口，支持消息处理，所有从 HandleEvent 接口继承的对象，具备消息处理机制，用于支持消息传递。 boolea

2、n (*HandleEvent) (iname *, AEEEvent evt, uint16 wParam, uint32 dwParam); void (*SetHandler) (iname *, HandlerDesc *pDesc); /设置消息处理器4. IForm：接口IForm 完全继承于 IHandler 接口，没有自己的定义成员函数。 IForm 所有支持的成员函数如下：/IBASEuint32 (*AddRef) (iname*);uint32 (*Release) (iname*);/IQueryInforace.int (*QueryInterface)(iname

3、*, AEECLSID, void *);/hander event; boolean (*HandleEvent) (iname *, AEEEvent evt, uint16 wParam, uint32 dwParam);void (*SetHandler) (iname *, HandlerDesc *pDesc);Formuint32 (*Release) (iname*);/IQueryInforace.int (*QueryInterface)(iname *, AEECLSID, void *);/hander event; boolean (*HandleEvent) (in

4、ame *, AEEEvent evt, uint16 wParam, uint32 dwParam);void (*SetHandler) (iname *, HandlerDesc *pDesc);/IRootFormint (*InsertForm) (iname *, IForm *pf, IForm *pfBefore); /插入窗体int (*RemoveForm) (iname *, IForm *pf); /移出窗体IForm *(*GetForm) (iname *, IForm *pwRef, boolean bNext, boolean bWrap);int (*Reso

5、lveForm) (iname *, char const *szFormUrl, IForm *ppiForm); void (*GetClientRect) (iname *, IXYContainer *ppContainer, AEERect *rc)1.2.FormForm 用于管理一个固定的窗体外观，处理用户交互消息， 可以通过 ISHELL_CreateInstance 进行创建。Formint nRefs;IModule * piModule;/事件处理机制HandlerDesc handler;PFNHANDLER pfnDefHandler; /消息处理器函数IShell

6、* piShell;IWidget * piWidget; /指向自身Widget对象的指针XYContainerIRootForm * piRootForm; /指向RootForm的指针boolean bActive; /表明该Form 是否是激活的boolean bIsPopup; /是否是弹出窗体uint16 wCancelKey;const char * themeBaseName; /Theme文件名,支持ThemeIModel * piModel; /保存Model指针uint32 dwItemMask;struct /记录 SoftKey的两个文本和Title标题文本AECHA

7、R *softkey2;AECHAR *title; text;Form bgImage;struct /记录标题图片IImage *ptr; titleImage; Form;1.2.1. 在 Form/你要处理的事件函数（回调函数）Void * pCxt;/你传入的第一个对象参数PFNFREEHANDLER pfnFree;/释放函数 HandlerDesc; 使用三个函数（宏定义）来初始化数据结构，和调用数据结构中保存的函数。#define HANDLERDESC_Init(pdesc,ph,pv,pf) (pdesc)-pfn = (PFNHANDLER)(ph),(pdesc)-pC

8、xt = (pv), (pdesc)-pfnFree = (PFNFREEHANDLER)(pf)#define HANDLERDESC_Call(pdesc,e,w,dw) ( (pdesc)-pfn) ? (pdesc)-pfn(pdesc)-pCxt,(e),(w),(dw) : FALSE )Form用于替换原来的 Hander， 重新指向 HandlerEvent 函数，SetHander 的常用实现如下所示：void WidgetBase_SetHandler(IWidget *po, HandlerDesc *phd)DECLARE_ME;/ Reset on null desc

9、riptorif (!phd) HANDLERDESC_Init( else HandlerDesc hdTemp = *phd;*phd = me-hd;/返回了自身的Handler ，以备对方调用。me-hd = hdTemp;看上边的代码，在 SetHandle 扔调用过程中，替换了当前 Widget 的 HandleEvent，并返回了自己现在的 Hander， 这样，开发时在处理好了自己的事件，并可调用替换掉的 Hander 所指向的 HandleEvent。在提供事件处理的对象中，一般提供了HandlerDesc handler;PFNHANDLER pfnDefHandler;支

10、持 IHandler 接口的对象，都必须实现 HandleEvent 接口。Form而真正处理事件的函数保存在 me-handler 中，在 Handler 中的函数改变，消息处理函数相应的跟着改变。在 FormSoftkeyWidget *me = MALLOCREC(SoftkeyWidget);if (!me)return ENOMEMORY;ISHELL_CreateInstance(piShell, AEECLSID_PROPCONTAINER, (void *)IPROPCONTAINER_QueryInterface(me-piContainer, AEEIID_WIDGET, (void *)HANDLERDESC_Init(IWIDGET_SetHandler(piContWidget, 这里重载父类 PropContainer 的处理函数。HANDLERDESC_Init 中的第一个参数为 HandleResc 的 Hander，第二个参数为 HandleEvent 的处理函数，第三个为 HandleEvent 调用时的第一个参数（一般为对象参数，在这里是 SoftkeyWidget），第四个为对象在释放时调用的 Release 函数。2在自己的消息处理函数中调用父类的消息处理函数