DuiLib——第一篇UIManager

DUiLib 源码分析 ——以UiLib 1.01版为分析目标

----------------------------------------------------------------------------------

分析约定:

private o------- 私有的成员变量或方法

protect x------- 受保护的成员变量或方法

public +------- 公开的成员变量或方法

----------------------------------------------------------------------------------



本篇分析一下源文件

UIManager.h/UIManager.cpp



CPaintManagerUI

成员变量



窗体句柄

o---m_hWndPaint 要CPaintManagerUI进行Direct绘图操作的窗体句柄

o---m_hwndTooltip 提示窗口句柄

o---m_hInstance 当前管理的Instance实例

o---m_hResourceInstance 当前管理的资源DLL Instance实例

o---m_pStrResourcePath 当前使用的资源路径

o---m_pStrResourceZip 当前使用的资源压缩包文件全称









------------------------------------------------------CPaintManagerUI使用的资源

绘图设备

o---m_hDcPaint 直接绘制到窗体的DC(为窗体的整个区域包括费客户区)

o---m_hDcOffscreen 内存缓冲区绘图DC

o---m_hDcBackground 背景绘制(支持AlphaBackground时使用)

位图

o---m_hbmpOffscreen m_hDcPaint的后台作图画布

o---m_hbmpBackground 背景图片bmp



------------------------------------------------------CPaintManagerUI用到的信息

o---m_ToolTip 提示消息

typedef struct tagTOOLINFOA {

UINT cbSize; //该结构体的大小 sizeof(TOOLINFO)

UINT uFlags; //附加标识类信息

HWND hwnd; //消息接受的窗体

UINT_PTR uId; //控件ID

RECT rect; //消息产生的区域位置

HINSTANCE hinst; //消息接收的实例

LPSTR lpszText; //提示消息

LPARAM lParam; //IE3.0以上的版本有该属性

void *lpReserved; //NT5.0以上的版本有该属性 附加信息

} TOOLINFO

标识类信息 

o---m_bShowUpdateRect 是否显示更新区域

o---m_bFirstLayout 是否是首个布局 

o---m_bUpdateNeeded 是否需要更新界面

o---m_bFocusNeeded 是否需要焦点

o---m_bOffscreenPaint 是否需要开双缓存绘图

o---m_bAlphaBackground 窗体背景是否需要支持Alpha通道(如png图片的半透明效果)

o---m_bMouseTracking 是否需要支持鼠标追踪

o---m_bMouseCapture 是否需要支持鼠标捕获



控件信息

o---m_pRoot xml根节点解析成的对象，通常为各种Window

o---m_pFocus 处于获得焦点状态的控件

o---m_pEventHover 处于鼠标悬停状态的控件

o---m_pEventClick 被鼠标点击的控件

o---m_pEventKey 接收键盘输入的控件



位置记录信息

o---m_pLastMousePos 鼠标最新的位置

o---m_szMinWindow 设置窗体可以调整到的最小大小

o---m_szMaxWindow 窗体可以调整到的最大大小

o---m_szInitWindowSize 窗体初始化是的大小

o---m_rcSizeBox 窗体外边框区域的大小

o---m_szRoundCorner 窗体四角的圆角弧度

o---m_rcCaption 窗体标题栏区域大小

o---m_uTimerID 当前定时器ID



集合类信息

o---m_aNotifiers 能够接收通知的对象集合

o---m_aTimers 定时器集合

o---m_aPreMessage 预处理消息集合

o---m_aPreMessageFilters 预处理消息过滤器集合

o---m_aMessageFilters 消息过滤器集合

o---m_aPostPaintControls 发送绘制请求的控件集合

o---m_aDelayedCleanup 延迟清理的对象集合

o---m_aAsyncNotify 异步通知消息集合

o---m_mNameHash 名称HashMap

o---m_mOptionGroup 选项组Map



xml对应资源

o---m_pParentResourcePM 上级(父类)资源的PaintManagerUI绘图管理器

o---m_dwDefaultDisabledColor 默认失效状态颜色

o---m_dwDefaultFontColor 默认字体颜色

o---m_dwDefaultLinkFontColor 默认超链接字体颜色

o---m_dwDefaultLinkHoverFontColor默认超链接鼠标悬停状态的字体颜色

o---m_dwDefaultSelectedBkColor 默认选中状态背景色

o---m_DefaultFontInfo 默认字体信息

TFontInfo{

hFont 该字体的句柄

sFontName 字体名称

iSize 字号

bBold 是否粗体

bUnderline 是否有下划线

bItalic 是否为斜体

TEXTMETRIC tm 该字体的TEXTMETRIC信息

}

o---m_aCustonFonts 自定义字体资源集合

o---m_mImageHash 图片资源HashMap

o---m_DefaultAttrHash DefaultAttr资源HashMap



私有方法

将所有的控件添加到m_mNameHash哈希表中

o---static CControlUI* CALLBACK __FindControlFromNameHash(CControlUI* pThis, LPVOID pData);

计算控件数量

o---static CControlUI* CALLBACK __FindControlFromCount(CControlUI* pThis, LPVOID pData);

根据点是否在区域中，查询控件

o---static CControlUI* CALLBACK __FindControlFromPoint(CControlUI* pThis, LPVOID pData);

通过Tab信息查询控件

o---static CControlUI* CALLBACK __FindControlFromTab(CControlUI* pThis, LPVOID pData);

从快照中查询控件

o---static CControlUI* CALLBACK __FindControlFromShortcut(CControlUI* pThis, LPVOID pData);

查找需要更新的控件

o---static CControlUI* CALLBACK __FindControlFromUpdate(CControlUI* pThis, LPVOID pData);

通过名称比较查询控件

o---static CControlUI* CALLBACK __FindControlFromName(CControlUI* pThis, LPVOID pData);



公开方法

绘图管理器的初始化(m_hWndPaint,m_hDcPaint赋值，在预处理消息中加入管理器)

+---void Init(HWND hWnd);

当前需要更新界面

+---void NeedUpdate();

指定区域失效

+---void Invalidate(RECT& rcItem);

获取绘图设备DC

+---HDC GetPaintDC() const;

获取绘图的窗口句柄

+---HWND GetPaintWindow() const;

获取提示窗体句柄

+---HWND GetTooltipWindow() const;

获取当前鼠标的位置

+---POINT GetMousePos() const;

获取客户区大小

+---SIZE GetClientSize() const;

获取窗体初始化时的大小

+---SIZE GetInitSize();

设置窗体初始化大小

+---void SetInitSize(int cx, int cy);

获取窗体的边框区域大小

+---RECT& GetSizeBox();

设置窗体的边框区域大小

+---void SetSizeBox(RECT& rcSizeBox);

获取标题区域位置

+---RECT& GetCaptionRect();

设置标题区域位置

+---void SetCaptionRect(RECT& rcCaption);

获取窗体四角的圆角弧度

+---SIZE GetRoundCorner() const;

设置窗体四角的圆角弧度

+---void SetRoundCorner(int cx, int cy);

获取窗体可以调整到的最小大小

+---SIZE GetMinInfo() const;

设置窗体可以调整到的最小大小

+---void SetMinInfo(int cx, int cy);

获取窗体可以调整到的最大大小

+---SIZE GetMaxInfo() const;

设置窗体可以调整到的最大大小

+---void SetMaxInfo(int cx, int cy);

窗体的不透明度(0完全透明-255完全不透明)

+---void SetTransparent(int nOpacity);

设置绘图是否支持透明处理

+---void SetBackgroundTransparent(bool bTrans);

是否显示更新区域

+---bool IsShowUpdateRect() const;

设置是否显示更新

+---void SetShowUpdateRect(bool show);

获取当前管理的实例句柄

+---static HINSTANCE GetInstance();

获得当前运行的实例的路径

+---static CStdString GetInstancePath();

获得当前的工作路径

+---static CStdString GetCurrentPath();

获取资源DLL的实例句柄

+---static HINSTANCE GetResourceDll();

获取资源的路径(以"\"结尾)

+---static const CStdString& GetResourcePath();

获得Zip资源的路径

+---static const CStdString& GetResourceZip();

设置实例句柄

+---static void SetInstance(HINSTANCE hInst);

设置当前的工作路径

+---static void SetCurrentPath(LPCTSTR pStrPath);

设置当前的DLL资源的实例句柄

+---static void SetResourceDll(HINSTANCE hInst);

设置资源所在文件夹路径

+---static void SetResourcePath(LPCTSTR pStrPath);

设置Zip资源的路径(包括Zip文件名)

+---static void SetResourceZip(LPCTSTR pStrZip);

设置使用上级资源的绘图管理器

+---bool UseParentResource(CPaintManagerUI* pm);

获得上级资源绘图管理器

+---CPaintManagerUI* GetParentResource() const;

获取禁用状态的默认颜色

+---DWORD GetDefaultDisabledColor() const;

设置禁用状态的默认颜色

+---void SetDefaultDisabledColor(DWORD dwColor);

获取字体默认颜色

+---DWORD GetDefaultFontColor() const;

设置字体默认颜色

+---void SetDefaultFontColor(DWORD dwColor);

设置链接文字的默认字体颜色 

+---DWORD GetDefaultLinkFontColor() const;

获取链接文字的默认颜色

+---void SetDefaultLinkFontColor(DWORD dwColor);

获取鼠标悬停与超链上的默认字体颜色

+---DWORD GetDefaultLinkHoverFontColor() const;

获取鼠标悬停与超链上的默认字体颜色

+---void SetDefaultLinkHoverFontColor(DWORD dwColor);

获取选中状体的默认背景颜色

+---DWORD GetDefaultSelectedBkColor() const;

设置选中状态的默认背景颜色

+---void SetDefaultSelectedBkColor(DWORD dwColor);

获取默认使用的字体信息

+---TFontInfo* GetDefaultFontInfo();

设置默认使用的字体信息

+---void SetDefaultFont(LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

获取用户自定义字体的数量(一般对应xml中Font的数量)

+---DWORD GetCustomFontCount() const;

向字体数组列表追加字体资源

+---HFONT AddFont(LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

向字体数组列表中插入字体资源

+---HFONT AddFontAt(int index, LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

获取数组中指定下标的字体对象句柄

+---HFONT GetFont(int index);

从字体数组中获取指定配置的字体对象句柄

+---HFONT GetFont(LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

字体数组集合中是否存在字体对象

+---bool FindFont(HFONT hFont);

字体数组集合中是否存在指定配置的字体对象

+---bool FindFont(LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

获得字体对象的

+---int GetFontIndex(HFONT hFont);

根据指定的配置信息查询字体索引

+---int GetFontIndex(LPCTSTR pStrFontName, int nSize, bool bBold, bool bUnderline, bool bItalic);

从字体数组列表中移除字体对象

+---bool RemoveFont(HFONT hFont);

从字体数组列表中移除指定位置的字体信息

+---bool RemoveFontAt(int index);

清空字体数组列表

+---void RemoveAllFonts();

通过字体数组索引查找字体信息

+---TFontInfo* GetFontInfo(int index);

通过字体对象句柄获取字体信息

+---TFontInfo* GetFontInfo(HFONT hFont);

根据图像路径查找图像信息

+---const TImageInfo* GetImage(LPCTSTR bitmap);

根据名称,类型，遮罩色 查询 图像信息

+---const TImageInfo* GetImageEx(LPCTSTR bitmap, LPCTSTR type = NULL, DWORD mask = 0);

添加图像

+---const TImageInfo* AddImage(LPCTSTR bitmap, LPCTSTR type = NULL, DWORD mask = 0);

添加图像

+---const TImageInfo* AddImage(LPCTSTR bitmap, HBITMAP hBitmap, int iWidth, int iHeight, bool bAlpha);

根据图像名称移除图像

+---bool RemoveImage(LPCTSTR bitmap);

移除全部图像

+---void RemoveAllImages();

添加控件的默认配置信息(如button)

+---void AddDefaultAttributeList(LPCTSTR pStrControlName, LPCTSTR pStrControlAttrList);

根据控件名称查询该类控件的默认配置

+---LPCTSTR GetDefaultAttributeList(LPCTSTR pStrControlName) const;

移除指定控件类型名称的默认配置

+---bool RemoveDefaultAttributeList(LPCTSTR pStrControlName);

获取默认配置信息列表

+---const CStdStringPtrMap& GetDefaultAttribultes() const;

清空默认配置信息列表

+---void RemoveAllDefaultAttributeList();

将对话框控件附加到当前的管理器中

+---bool AttachDialog(CControlUI* pControl);

控件初始化

+---bool InitControls(CControlUI* pControl, CControlUI* pParent = NULL);

控件回收

+---void ReapObjects(CControlUI* pControl);



添加控件到指定的选项组

+---bool AddOptionGroup(LPCTSTR pStrGroupName, CControlUI* pControl);

查询指定选项组名称中的全部选项

+---CStdPtrArray* GetOptionGroup(LPCTSTR pStrGroupName);

从指定控件中移除指定选项组名称的选项组

+---void RemoveOptionGroup(LPCTSTR pStrGroupName, CControlUI* pControl);

清空全部选项组列表

+---void RemoveAllOptionGroups();



获取焦点状态的控件

+---CControlUI* GetFocus() const;

设置控件为获得焦点状态

+---void SetFocus(CControlUI* pControl);

设置控件为需要绘制焦点

+---void SetFocusNeeded(CControlUI* pControl);



设置下一个获得Tab键会获得焦点的控件，Tab是否继续往下走

+---bool SetNextTabControl(bool bForward = true);



为指定控件以及其子控件设置定时器

+---bool SetTimer(CControlUI* pControl, UINT nTimerID, UINT uElapse);

移除指定控件上的指定编号的定时器

+---bool KillTimer(CControlUI* pControl, UINT nTimerID);

清空所有的定时器

+---void RemoveAllTimers();



设置窗体接受鼠标事件

+---void SetCapture();

释放窗体捕获鼠标事件

+---void ReleaseCapture();

判断窗体是否接受鼠标事件

+---bool IsCaptured();



添加控件到通知集合中

+---bool AddNotifier(INotifyUI* pControl);

将控件从通知集合中移除

+---bool RemoveNotifier(INotifyUI* pControl); 

发送同步/异步通知

+---void SendNotify(TNotifyUI& Msg, bool bAsync = false);

构建同步或异步通知并发送

+---void SendNotify(CControlUI* pControl, LPCTSTR pstrMessage, WPARAM wParam = 0, LPARAM lParam = 0, bool bAsync = false);





向预处理消息过滤器链中添加消息过滤器

+---bool AddPreMessageFilter(IMessageFilterUI* pFilter);

从预处理消息过滤器链合中移除指定的消息过滤器

+---bool RemovePreMessageFilter(IMessageFilterUI* pFilter);



向消息过滤器链中添加消息过滤器

+---bool AddMessageFilter(IMessageFilterUI* pFilter);

从消息过滤器链中移除消息过滤器

+---bool RemoveMessageFilter(IMessageFilterUI* pFilter);

获取发送需要绘制的控件的数量

+---int GetPostPaintCount() const;

向绘制请求集合中添加要绘制的控件

+---bool AddPostPaint(CControlUI* pControl);

从绘制请求集合中移除指定的控件

+---bool RemovePostPaint(CControlUI* pControl);

将绘制请求控件插入到绘制请求集合的指定位置

+---bool SetPostPaintIndex(CControlUI* pControl, int iIndex);

向延迟清理集合中添加需要延迟清理的对象

+---void AddDelayedCleanup(CControlUI* pControl);

获取根节点控件

+---CControlUI* GetRoot() const;

从根节点开始查找指定点所在的控件

+---CControlUI* FindControl(POINT pt) const;

从指定节点开始查找指定点所在的控件

+---CControlUI* FindControl(CControlUI* pParent, POINT pt) const;

从根节点开始，查找指定名称的控件

+---CControlUI* FindControl(LPCTSTR pstrName);

从指定节点开始查找指定名称的控件

+---CControlUI* FindControl(CControlUI* pParent, LPCTSTR pstrName);



消息循环，非游戏框架消息泵，无法利用无消息的空闲时间 

+---static void MessageLoop();

消息翻译，在Win32原有的消息转换基础上，将需要自己处理的消息转发给消息预处理器

+---static bool TranslateMessage(const LPMSG pMsg);

消息预处理器

1.消息预处理过滤(消息预处理过滤器集合对消息进行过滤处理)

2.检查是否按下Tab键，设置下一个获得焦点的控件

3.处理Alt+Shortcut Key按下后的控件获得焦点和激活的设置

4.检查是否有系统键消息，有则发送获得焦点的控件的事件

+---bool PreMessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT& lRes);





----------------------------------------------------------------------------------------

----------------------------------------------------------------------------------------

消息处理器(核心处理器)

1.消息过滤

2.检查Custom消息并处理

3.检查是否有WM_CLOSE消息并处理

4.处理WM_ERASEBKGND(不允许进行背景擦除，防止闪烁)

5.绘制处理(核心)

5.1做延迟绘图判断，当前是否有 窗体大小调整的操作，或者是否需要初始化窗体

5.2设置焦点控件

5.3如果开启双缓存绘图，采用双缓存方式绘图，否则采用标准绘图方式绘图

5.4 

6.处理客户区的绘制WM_PRINTCLIENT

7.接到WM_GETMINMAXINFO消息后向系统提交该窗体可调整大小的最小和最大限制

8.窗体大小改变时，向焦点控件发送改变大小消息并设置窗体需要更新

9.处理定时器消息，向定时器集合中广播定时消息

10.处理鼠标悬停

10.1向鼠标悬停的控件发送鼠标悬停消息

10.2如果当前控件有提示消息，创建消息提示窗体

11.处理鼠标离开事件，关闭消息提示框，发送鼠标离开消息，取消鼠标的追踪

12.鼠标移动时，开始追踪鼠标

12.1处理鼠标移动时，鼠标在控件上进入，移动，悬停和离开的消息

13.处理鼠标左键按下的消息设定活动的焦点的控件

14.鼠标双击事件处理，向需要接收鼠标双击事件的控件发送双击事件

15.鼠标左键抬起时，向上次接收到点击消息的控件发送鼠标左键抬起的消息

16.鼠标右键按下时，向需要接收鼠标右键按下的控件发送右键按下消息

17.鼠标右键快捷菜单消息，将该消息通知给上次点击过的按钮

18.滚轮消息时，象鼠标所在的控件发送滚轮消息

19.WM_CHAR 消息时，向获得焦点的控件发送该消息

20.键盘按下时，向焦点控件发送该键盘消息，并设定焦点控件为键盘消息控件

21.键盘按键抬起时，向事键盘消息控件发送该事件

22.设定鼠标光标消息时，获得光标所在控件接收该消息

23.通知消息到来时，加OCM_BASE后发送通知消息

24.命令消息到来，加OCM_BASE后发送消息

25.WM_CTLCOLOREDIT，STATIC消息到来后，加OCM_BASE后发送消息

+---bool MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT& lRes);

转自：http://www.cnblogs.com/wuqi924/articles/2127062.html