zoukankan      html  css  js  c++  java
  • 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

  • 相关阅读:
    vue源码分析—Vue.js 源码目录设计
    vue源码分析—认识 Flow
    在Windows上安装配置MongoDB
    mongoDB概述
    Could not load file or assembly Microsoft.Web.Infrastructure
    配置错误 不能在此路径中使用此配置节(转)
    VS2013快捷键大全
    Create new tool for CSV
    How to get http response.
    C#中Split用法
  • 原文地址:https://www.cnblogs.com/jinsedemaitian/p/5589088.html
Copyright © 2011-2022 走看看