DUiLib 源码分析 ——以UiLib 1.01版为分析目标
----------------------------------------------------------------------------------
分析约定:
private o------- 私有的成员变量或方法
protect x------- 受保护的成员变量或方法
public +------- 公开的成员变量或方法
----------------------------------------------------------------------------------本篇分析一下源文件
UIManager.h/UIManager.cppCPaintManagerUI
成员变量窗体句柄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 内存缓冲区绘图DCo---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; //控件IDRECT 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根节点解析成的对象，通常为各种Windowo---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 名称HashMapo---m_mOptionGroup 选项组Mapxml对应资源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 图片资源HashMapo---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);——colin3dmax 分析于2011-6-15 22:00在此我再次感谢colin3dmax的无私分享还有为duilib开源做出贡献的人哈 详细解决方案
DUiLib 源码分析——第一篇UIManager
热度：44 发布时间：2024-01-04 04:37:37.0