詳解Brew中Widget實現分析
Brew中Widget實現分析是本文要介紹的內容，主要是來了解并學習Widget應用的內容，具體內容的實現來看本文詳解。
一、WidgetBase及其作用
1、結構體的定義
- 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、該結構體定義了所有widget公用的數據成員。當然也提供了公用的函數，如WidgetBase_XXX等函數群。具體的widget 的實現類，都以該結構體作為第一個成員。
二、ContainerBase及其作用
1、container的簡單說明
widget的容器，而container又可以看作是一種特殊的widget。這里就是一個composite模式。
2、WidgetNode
Container中的所有widget的相關信息放在一個雙向鏈表中。鏈表的節點的定義如下：
- 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構成了雙向鏈表；piWidget就是容器中的一個widget的指針；rc代表了該widget的位置，及大小。
對容器的操作，如添加widget，刪除widget，查找widget，遍歷所有的widget等，都映射為對該鏈表的操作。
3、結構體定義
- 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;
- }
- }
當客戶通過該指針調用IWidget接口的方法時，
- (*(IWidgetVtbl**)(void*)ptr)->AddRef();
*ptr為字段pvt的值，即指向IWidgetVtbl結構體的指針。上述語句只不過是添加了強制類型轉換。
通過這里我們可以清楚地了解到，把IContainer當作是普通的widget來看待時，它和該container里有多少個widget并沒有關系，并且也不是其中的任何一個widget。
注1：其實QueryInterface的意思就是object-oriented中的“is-a”的關系，即繼承關系，而按照object-oriented的原則，is-a是比has-a強得多的關系，所以如果可能的話，推薦使用get，set函數來表達has-a的關系。
注2：其實普通的接口指針，如 IWidget * ， IContainer * 等，都是指向虛函數表的2級指針。因為是2級指針，增加了相當的靈活性（還記得那著名的添加一個間接層的名言嗎）。
5、Draw函數
當顯示Container時，container會遍歷所有的widget，并調用IWIDGET_Draw函數完成顯示操作
- Widget1
- Container(wid2, wid3)
- Widget3
- Container( 0x11111111 )
- IWidget( 0x22222222 )
三、Decorator的實現方法
1、說明
Decorator是一種特殊的container，它管理并且只管理一個widget。它向該widget添加更多的UI功能
2、結構體
- struct WidgetContBase {
- WidgetBase base;
- IContainer container;
- AEEVTBL(IContainer) vtContainer;
- };
- struct Decorator {
- WidgetContBase base;
- IWidget * pChild;
- };
3、結構體說明
摘抄的代碼如下：
- 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本身是一個container，但是可以把它作為widget來看待。
IDecorator本身是一個widget，但是可以把它作為container來看待。
4、如果IDecorator已經wrap了target widget的話，那么調用ICONTAINER_GetWidget可以得到target widget。
IROOTCONTAINER_GetFirstWidget返回最先被加入的widget。
IROOTCONTAINER_GetLastWidget返回最后被加入的widget。
小結：詳解Brew中Widget實現分析的內容介紹完了，希望通過Widget內容的學習能對你有所幫助。
