詳解Brew中Widget實(shí)現(xiàn)分析
Brew中Widget實(shí)現(xiàn)分析是本文要介紹的內(nèi)容，主要是來了解并學(xué)習(xí)Widget應(yīng)用的內(nèi)容，具體內(nèi)容的實(shí)現(xiàn)來看本文詳解。
一、WidgetBase及其作用
1、結(jié)構(gòu)體的定義
- struct WidgetBase {
- const AEEVTBL(IWidget) *pvt;
- int nRefs;
- IModule * piModule;
- WExtent extent;
- IContainer * piContainer;
- IModel * piModel;
- HandlerDesc hd;
- PFNHANDLER pfnDefHandler;
- // view model
- IModel * piViewModel;
- };
2、各字段的說明
3、該結(jié)構(gòu)體定義了所有widget公用的數(shù)據(jù)成員。當(dāng)然也提供了公用的函數(shù)，如WidgetBase_XXX等函數(shù)群。具體的widget 的實(shí)現(xiàn)類，都以該結(jié)構(gòu)體作為第一個(gè)成員。
二、ContainerBase及其作用
1、container的簡單說明
widget的容器，而container又可以看作是一種特殊的widget。這里就是一個(gè)composite模式。
2、WidgetNode
Container中的所有widget的相關(guān)信息放在一個(gè)雙向鏈表中。鏈表的節(jié)點(diǎn)的定義如下：
- struct WidgetNode {
- WidgetNode * pNext;
- WidgetNode * pPrev;
- IWidget * piWidget;
- AEERect rc;
- // if non-null, then this widget is raised
- IXYContainer * pixyRaise; // xy container that widget is raised to
- #if defined(OPTIMIZ3)
- AEERect rcDraw;
- #endif
- flg fVisible : 1;
- flg fDraw : 1;
- };
pNext，pPrev構(gòu)成了雙向鏈表；piWidget就是容器中的一個(gè)widget的指針；rc代表了該widget的位置，及大小。
對容器的操作，如添加widget，刪除widget，查找widget，遍歷所有的widget等，都映射為對該鏈表的操作。
3、結(jié)構(gòu)體定義
- struct ContainerBase
- {
- AEEVTBL(IContainer) * pvt;
- uint32 nRefs;
- IModule * piModule;
- IModel * piModel;
- WExtent extent;
- IContainer * piParent;
- IWidget widget;
- AEEVTBL(IWidget) vtWidget;
- Border border;
- IModel * piViewModel;
- HandlerDesc hd;
- PFNHANDLER pfnDefHandler;
- WidgetNode head;
- …
- };
4、字段說明
摘抄的代碼如下：
- int ContainerBase_QueryInterface(IContainer *po, AEECLSID id, void **ppo)
- {
- if ((id == AEEIID_WIDGET)
- || (id == AEEIID_HANDLER)) {
- *ppo = &me->widget;
- ICONTAINER_AddRef(po);
- return SUCCESS;
- }
- }
當(dāng)客戶通過該指針調(diào)用IWidget接口的方法時(shí)，
- (*(IWidgetVtbl**)(void*)ptr)->AddRef();
*ptr為字段pvt的值，即指向IWidgetVtbl結(jié)構(gòu)體的指針。上述語句只不過是添加了強(qiáng)制類型轉(zhuǎn)換。
通過這里我們可以清楚地了解到，把IContainer當(dāng)作是普通的widget來看待時(shí)，它和該container里有多少個(gè)widget并沒有關(guān)系，并且也不是其中的任何一個(gè)widget。
注1：其實(shí)QueryInterface的意思就是object-oriented中的“is-a”的關(guān)系，即繼承關(guān)系，而按照object-oriented的原則，is-a是比has-a強(qiáng)得多的關(guān)系，所以如果可能的話，推薦使用get，set函數(shù)來表達(dá)has-a的關(guān)系。
注2：其實(shí)普通的接口指針，如 IWidget * ， IContainer * 等，都是指向虛函數(shù)表的2級指針。因?yàn)槭?級指針，增加了相當(dāng)?shù)撵`活性（還記得那著名的添加一個(gè)間接層的名言嗎）。
5、Draw函數(shù)
當(dāng)顯示Container時(shí)，container會遍歷所有的widget，并調(diào)用IWIDGET_Draw函數(shù)完成顯示操作
- Widget1
- Container(wid2, wid3)
- Widget3
- Container( 0x11111111 )
- IWidget( 0x22222222 )
三、Decorator的實(shí)現(xiàn)方法
1、說明
Decorator是一種特殊的container，它管理并且只管理一個(gè)widget。它向該widget添加更多的UI功能
2、結(jié)構(gòu)體
- struct WidgetContBase {
- WidgetBase base;
- IContainer container;
- AEEVTBL(IContainer) vtContainer;
- };
- struct Decorator {
- WidgetContBase base;
- IWidget * pChild;
- };
3、結(jié)構(gòu)體說明
摘抄的代碼如下：
- int WidgetContBase_QueryInterface(IWidget *po, AEECLSID clsid, void **ppo)
- {
- WidgetContBase *me = (WidgetContBase*) po;
- if (clsid == AEEIID_CONTAINER) {
- *ppo = (void *)&me->container;
- WidgetBase_AddRef((IWidget*)po);
- return SUCCESS;
- }
- return WidgetBase_QueryInterface(po, clsid, ppo);
- }
可以看出：
IContainer本身是一個(gè)container，但是可以把它作為widget來看待。
IDecorator本身是一個(gè)widget，但是可以把它作為container來看待。
4、如果IDecorator已經(jīng)wrap了target widget的話，那么調(diào)用ICONTAINER_GetWidget可以得到target widget。
IROOTCONTAINER_GetFirstWidget返回最先被加入的widget。
IROOTCONTAINER_GetLastWidget返回最后被加入的widget。
小結(jié)：詳解Brew中Widget實(shí)現(xiàn)分析的內(nèi)容介紹完了，希望通過Widget內(nèi)容的學(xué)習(xí)能對你有所幫助。
