关于duilib的理解

0 duilib文件(5/17)   [x] stb_image.c   [x] stdafx.h stdafx.cpp   [ ] UIActiveX.h UIActiveX.cpp   [x] UIBase.h UIBase.cpp   [ ] UICombo.h UICombo.cpp   [x] UICommonControls.h UICommonControls.cpp   [ ] UIContainer.h UIContainer.cpp   [x] UIControl.h UIControl.cpp   [x] UIDelegate.h UIDelegate.cpp   [x] UIDlgBuilder.h UIDlgBuilder.cpp   [x] UIlib.h UIlib.cpp   [ ] UIList.h UIList.cpp   [x] UIManager.h UIManager.cpp   [x] UIMarkup.h UIMarkup.cpp   [x] UIRender.h UIRender.cpp   [ ] UIRichEdit.h UIRichEdit.cpp   [x] XUnzip.cpp 1 stdAfx 预编译   * int lengthof(x)    计算数组长度宏   * MAX        两值最大   * MIN        两值最小   * CLAMP(x,a,b)    x在a,b之间则取x否则取最小   * winmm.lib Windows 多媒体相关应用程序接口库   * comctl32.lib Windows 通用控件库 2 UIBase   * UI_WNDSTYLE_ 窗口风格属性   * UI_CLASSSTYLE_ 窗口类属性     /<TODO:增加具体每项的解释>   * ASSERT(expr) - 断言 同_ASSERTE(expr) 显示断言所在文件，行以及expr的内容   * TRACE(LPCTSTR pstrFormat, ...)     功能 - 调试信息     参考 - 参考printf   * TRACEMSG(UINT uMsg)     功能 - 将windows消息转化成其对应的宏名     uMsg - Windows消息ID     返回值 - 宏名(字符串)   * class STRINGorID     功能 - 统一资源ID, 字符串类型和整型统一输出为字符串类型   * class CPoint     描述 - 点     函数 -       CPoint(LPARAM lParam)    //将消息中lParam转化成点   * class CSize     描述 - 矩形的宽和高   * class CRect     描述 - 矩形区域     函数 -       void Empty()    //设置left,right,top,bottom为零       void Join(const RECT& rc)    //合并两个矩形产生一个包含两个矩形的新的矩形       void ResetOffset()    //将矩形移动到left=0,top=0的位置       void Normalize()    //调整left,right,top,bottom使之left < right top < bottom       void Offset(int cx, int cy)    //移动矩形, cx 横向移动距离, cy 纵向移动距离       void Inflate(int cx, int cy)    //放大矩形, cx左右各放大的大小, cy 上下各放大的大小       void Deflate(int cx, int cy)    //缩小矩形, cx左右各缩小的大小, cy上下各缩小的大小       void Union(CRect& rc)    //合并矩形, 与Join()函数功能几乎一致, 但对空矩形处理不同   * class CStdPtrArray     变量 -       m_nAllocated    //已申请空间大小(可储存Ptr的数量), 如果空间不足则去realloc m_nAllocated*2的空间   * class CStdString         实现 - 如果长度小于MAX_LOCAL_STRING_LEN(63)则在栈上分配, 否则在堆上分配     函数 -       void Assign(LPCTSTR pstr, int nLength = -1)    //分配   * class CStdStringMap     描述 - 字符串map     实现 - 使用times33哈希算法   * class CWindowWnd     函数 -       RegisterWindowClass()    //RegisterClass的封装       RegisterSuperclass()    //超类化窗口       Subclass()    //子类化窗口       ShowModal()    //窗口模态化       ?MessageBox()    //?UIBase.cpp 为utf8       __WndProc()    //消息处理函数       __ControlProc()    //超类化消息处理函数    实现 -      duilib消息处理机制      1 创建 - 通过CreateEx最后一个参数传递类指针this, 在消息处理函数中对WM_NCCREATE消息进行处理, 通过SetWindowLongPtr(GWLP_USERDATA)进行保存      2 消息处理 - 在消息处理函数通过GetWindowLongPtr(GWLP_USERDATA)得到其类指针, 调用虚函数HandleMessage()相应其他消息。      3 销毁 - 消息处理函数中对WM_NCDESTROY消息进行处理, 调用原消息处理函数, 重置(GWLP_USERDATA), 调用虚函数OnFinalMessage()做最后处理。 ============update 2011 06 07 ===================== 3 the 3rd part stb_image   * 描述 - 载入各种图片格式文件   * 函数 -     stbi_load_from_memory()       功能 - 加载图片       buffer - 内存数据       len - 数据大小,       x - [out]图像宽度(像素)       y - [out]图像高度(像素)       comp - [out]图像数据组成结果       req_comp - 图像数据组成         STBI_default = 0, // only used for req_comp         STBI_grey       = 1,         STBI_grey_alpha = 2,         STBI_rgb        = 3,         STBI_rgb_alpha  = 4              [more than] stb_image.c line 100 - 130       stbi_image_free()       功能 - 释放已加载的图片数据 4 the 3rd part XUnzip * 描述 - 解压zip包 * 函数 -      OpenZip       功能 - 打开一个zip包       z - 内存地址, 文件名, 文件句柄       len - 长度       flag - 标识(ZIP_HANDLE=1, ZIP_FILENAME=2, ZIP_MEMORY=3)       return - HZIP      CloseZip        功能 - 关闭一个zip包          hz - HZIP      GetZipItem        功能 - 从zip包中获取一项        hz - HZIP        index - 序号        ze - zip入口点结构      FindZipItem        功能 - 在zip包中查找项        hz - HZIP        name - 项名        ic - 大小写敏感 CASE_INSENSITIVE=1, CASE_SENSITIVE=2        index - [out]序号        ze - zip入口点结构      UnzipItem        功能 - 解压项        hz - HZIP        dst - [out]解压后存储位置        len - 储存长度        flags - 标识(ZIP_HANDLE=1, ZIP_FILENAME=2, ZIP_MEMORY=3) 5 class CRenderClip   * 描述 - 渲染区域控制，设置在dc上绘制的区域，防止子控件绘制到父控件外侧（float属性控件除外）   * 实现 -   * 函数 -     GenerateClip()    //产生一个剪切区域, hDC窗口句柄, rc区域, clip[out]剪切区     GenerateRoundClip()    //产生一个圆角剪切区域, hDC窗口句柄, rc区域, width 横向圆角弧度, height纵向圆角弧度, clip[out]剪切区     UseOldClipBegin()    //使用整个活跃区域作为剪切区, hDC窗口句柄, clip剪切区     UseOldClipEnd()    //使用当前控件有效区域作为剪切区, hDC窗口句柄, clip剪切区 ============update 2011 06 15 ===================== 6 class CRenderEngine   * 渲染引擎   * 函数 -     LoadImage()       功能 - 加载图像       bitmap - 图像       type - 类型       mask - 隐蔽色       实现 -         1 读取文件，资源和zip包中图像文件数据到内存(通过HIWORD(bitmap.m_lpstr)区别从资源中或文件中加载MAKEINTRESOURCE  The return value is the specified value in the low-order word and zero in the high-order word. (from msdn))         2 创建DIB         3 通过stbi_load_from_memory加载数据文件并转化后复制到DIB中         4 返回TImageInfo结构     DrawImage()       功能 - 绘制图像       hDC - 设备句柄       hBitmap - 位图句柄       rc - 对象区域       rcPaint - 绘制区域       rcBmpPart - 位图区域       rcConrners - 拉伸区域       alphaChannel - alpha通道       uFade - 透明度       hole - 居中       xtiled - 横向平铺       ytiled - 纵向平铺       实现 -         1 CreateCompatibleDC (创建内存设备句柄)         2 SelectObject() (将位图选入内存设备句柄)         3 AlphaBlend (alpha混合)         4 BitBlt() or StretchBlt() (绘制到内存设备句柄)         5 SelectObject() (将老的位图选入内存设备句柄)         6 DeleteDC (释放内存设备句柄)     DrawImageString()       功能 - 按标识字符串绘制图像       hDC - 设备句柄       pManager - 绘制管理者       rc - 对象区域       rcPaint - 绘制区域       pStrImage - 标识字符串       pStrModify - 标识字符串       实现 -         1 分析标识字符串获取属性           1.1 先分析pStrImage信息后再分析pStrModify的信息         2 获取图像数据         3 绘制图像     DrawColor()       功能 - 绘制矩形       hDC - 设备句柄       rc - 对象区域       color - 颜色(alpha, r, g, b)       实现 -         如果不需要alpha混合则SetBkColor() ExtTextOut()         否则 创建一个像素大小的32位DIB     DrawGradient()       功能 - 绘制渐变       hDC - 设备句柄       rc - 对象区域       dwFirst - 颜色1       dwSecond - 颜色2       bVertical - 渐变方向 true垂直 false水平       nSteps - 步长 [使用GradientFill() API时无效]       实现 -         1 渐变填充         2 alpha混合     DrawLine() - 绘制直线     DrawRect() - 绘制矩形     DrawRoundRect() - 绘制圆角矩形     DrawText() - 绘制文字     DrawHtmlText()       功能 - 绘制 "mini-html" 标识字符串       hDC - 设备句柄       pManager - 绘制管理者       rc - 对象区域       pstrText -  "mini-html" 标识字符串       dwTextColor - 字符串类型       pLinks - 产生链接效果的区域组       sLinks - 产生链接效果的区域组数量       nLinkRects - 产生链接效果的区域组数量       uStyle - 类型，同DrawText() Format Flags     GenerateBitmap()       功能 - 产生一个BMP位图       pManager - 绘制管理者       pControl - 控件句柄       rc - 对象区域       返回 - BMP句柄      ===============update 2011-06-16 7 class INotifyUI - Listener interface 8 class IMessageFilterUI - MessageFilter interface 9 class CPaintManagerUI   * 绘制管理者   * 函数     Init() - 初始化     NeedUpdate() -     Invalidate() - InvalidateRect API的封装     GetPaintDC() - 设备句柄相关函数     GetPaintWindow() - 得到窗口句柄     GetTooltipWindow() - 得到提示窗口句柄     GetMousePos() - 得到鼠标位置     GetClientSize() - 得到客户端区域大小     获取/设置 窗口初始化时大小       GetInitSize()       SetInitSize()     获取/设置 托腮大小       GetSizeBox()       SetSizeBox()     获取/设置 标题区域大小       GetCaptionRect()       SetCaptionRect()     获取/设置 圆角大小       GetRoundCorner()       SetRoundCorner()     获取/设置 大小的最小限制       GetMinInfo()       SetMinInfo()     获取/设置 大小的最大限制       GetMaxInfo()       SetMaxInfo()     设置透明度       SetTransparent()     设置背景是否使用透明属性       SetBackgroundTransparent()     获取/设置 刷新区域属性       IsShowUpdateRect()       SetShowUpdateRect()     获取/设置 应用程序对象实例句柄       GetInstance()       SetInstance()     获取 可执行程序所在路径       GetInstancePath()     获取/设置 当前工作目录       GetCurrentPath()       SetCurrentPath()     获取/设置 资源动态库句柄       GetResourceDll()       SetResourceDll()     获取/设置 资源路径       GetResourcePath()       SetResourcePath()     获取/设置 资源压缩包文件名       GetResourceZip()     SetResourceZip()   使用绘制管理者的根绘制管理者的资源设置 - 循环得到父绘制管理者直到找到最顶层的绘制管理者     UseParentResource()   得到绘制管理者     GetParentResource()   获取/设置 非可用状态文字颜色     GetDefaultDisabledColor()     SetDefaultDisabledColor()   获取/设置 默认字体颜色     GetDefaultFontColor()     SetDefaultFontColor()   获取/设置超链接默认字体颜色     GetDefaultLinkFontColor()     SetDefaultLinkFontColor()   获取/设置 鼠标漂浮在链接上时默认字体颜色     GetDefaultLinkHoverFontColor()     SetDefaultLinkHoverFontColor()   获取/设置 选中后背景颜色     GetDefaultSelectedBkColor()     SetDefaultSelectedBkColor()   获取/设置 默认字体     GetDefaultFontInfo()     SetDefaultFont()   字体列表操作     DWORD GetCustomFontCount() - 得到字体列表中项数量     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) - 按属性查找字体列表中的一项     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);     bool RemoveImage(LPCTSTR bitmap);     void RemoveAllImages();   默认属性列表操作     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);   初始化控件 把控件名称加入到绘制管理者的控件名map中     bool InitControls(CControlUI* pControl, CControlUI* pParent = NULL);   重置控件     void ReapObjects(CControlUI* pControl);   选项组操作     bool AddOptionGroup(LPCTSTR pStrGroupName, CControlUI* pControl); - 添加控件到组中, 如果组选贤存在则加入pControl到此组中，如果不存在则创建新组并加入pControl     CStdPtrArray* GetOptionGroup(LPCTSTR pStrGroupName); - 通过名称得到选项组     void RemoveOptionGroup(LPCTSTR pStrGroupName, CControlUI* pControl); - 移除组中控件，如果组中没有控件则移除组     void RemoveAllOptionGroups(); - 移除所有选项组   得到控件焦点     CControlUI* GetFocus() const;   控件获得焦点     void SetFocus(CControlUI* pControl);   得到标签页控件     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); - 加入一个Listener     bool RemoveNotifier(INotifyUI* pControl);   - 移除一个Listener     void SendNotify(TNotifyUI& Msg); - 发送一个通知     void SendNotify(CControlUI* pControl, LPCTSTR pstrMessage, WPARAM wParam = 0, LPARAM lParam = 0); - 发送一个通知     bool AddPreMessageFilter(IMessageFilterUI* pFilter); - 加入一个预处理Message Filter     bool RemovePreMessageFilter(IMessageFilterUI* pFilter); - 移除一个预处理Message Filter     bool AddMessageFilter(IMessageFilterUI* pFilter); - 加入一个Message Filter     bool RemoveMessageFilter(IMessageFilterUI* pFilter); - 移除一个Message Filter   PostPaint控件操作     int GetPostPaintCount() const; - 得到PostPaint控件数量     bool AddPostPaint(CControlUI* pControl); - 加入PostPaint控件     bool RemovePostPaint(CControlUI* pControl); - 移除一个PostPaint控件     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;   在控件名map中按名字匹配控件     CControlUI* FindControl(LPCTSTR pstrName);   调用父控件的函数, 按名字匹配控件     CControlUI* FindControl(CControlUI* pParent, LPCTSTR pstrName);   消息循环     static void MessageLoop();   消息处理     static bool TranslateMessage(const LPMSG pMsg);   消息处理     bool MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT& lRes);   消息预处理     bool PreMessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT& lRes);   回调函数 - 比较属性(pData)与控件(pThis)的属性是否相同     static CControlUI* CALLBACK __FindControlFromNameHash(CControlUI* pThis, LPVOID pData); - 按名称查找控件的回调函数     static CControlUI* CALLBACK __FindControlFromCount(CControlUI* pThis, LPVOID pData); - 计算控件数目的回调函数     static CControlUI* CALLBACK __FindControlFromPoint(CControlUI* pThis, LPVOID pData); - 按位置查找控件的回调函数     static CControlUI* CALLBACK __FindControlFromTab(CControlUI* pThis, LPVOID pData); - 查找下一个相应tab的控件     static CControlUI* CALLBACK __FindControlFromShortcut(CControlUI* pThis, LPVOID pData); - 快捷方式对应的控件     static CControlUI* CALLBACK __FindControlFromUpdate(CControlUI* pThis, LPVOID pData); - 查找需要刷新的控件     static CControlUI* CALLBACK __FindControlFromNameByParent(CControlUI* pThis, LPVOID pData); - 查找子控件     HWND m_hWndPaint;    //绘制窗口句柄     HDC m_hDcPaint;        //绘制DC     HDC m_hDcOffscreen; //屏幕兼容DC     HDC m_hDcBackground;    //背景DC     HBITMAP m_hbmpOffscreen;    //屏幕DIB     HBITMAP m_hbmpBackground;    //背景DIB     HWND m_hwndTooltip;    //提示窗口句柄     TOOLINFO m_ToolTip;    //提示结构     bool m_bShowUpdateRect;    //是否更新     //     CControlUI* m_pRoot;    //根控件指针     CControlUI* m_pFocus;    //获得焦点控件指针     CControlUI* m_pEventHover;    //鼠标停留控件指针     CControlUI* m_pEventClick;    //点击事件控件指针     CControlUI* m_pEventKey;    //相应键盘事件控件指针     //     POINT m_ptLastMousePos;    //鼠标位置     SIZE m_szMinWindow;        //窗口最小限制     SIZE m_szMaxWindow;        //窗口最大限制     SIZE m_szInitWindowSize;    //初始化窗口大小     RECT m_rcSizeBox;        //托腮大小     SIZE m_szRoundCorner;    //圆角大小     RECT m_rcCaption;        //标题大小     UINT m_uTimerID;        //计时器ID     bool m_bFirstLayout;    //是否为第一层     bool m_bUpdateNeeded;    //是否需要更新     bool m_bFocusNeeded;    //是否需要焦点     bool m_bOffscreenPaint;    //是否绘制m_hDcOffscreen     bool m_bAlphaBackground;    //背景是否透明     bool m_bMouseTracking;    //是否追踪鼠标     bool m_bMouseCapture;    //是否捕获鼠标          CStdPtrArray m_aNotifiers;    //Listener 列表     CStdPtrArray m_aTimers;        //计时器列表     CStdPtrArray m_aPreMessageFilters;    //预处理消息列表     CStdPtrArray m_aMessageFilters;        //消息处理列表     CStdPtrArray m_aPostPaintControls;    //PostPaint控件列表     CStdPtrArray m_aDelayedCleanup;    //延迟释放控件列表     CStdStringPtrMap m_mNameHash;    //控件名哈希列表     CStdStringPtrMap m_mOptionGroup;    //选项组列表          CPaintManagerUI* m_pParentResourcePM;    //当前绘制管理者的上一层绘制管理者（父绘制管理者）     DWORD m_dwDefalutDisabledColor;    //默认非可用状态字体颜色     DWORD m_dwDefalutFontColor;    //默认字体颜色     DWORD m_dwDefalutLinkFontColor;    //默认链接颜色     DWORD m_dwDefalutLinkHoverFontColor;    //默认鼠标漂浮时字体颜色     DWORD m_dwDefalutSelectedBkColor;    //默认被选择后背景颜色     TFontInfo m_DefaultFontInfo;    //默认字体信息     CStdPtrArray m_aCustomFonts;    //字体列表     CStdStringPtrMap m_mImageHash;    //图片资源名哈希表     CStdStringPtrMap m_DefaultAttrHash;    //默认属性哈希表          static HINSTANCE m_hInstance;    //应用程序对象实例句柄     static HINSTANCE m_hResourceInstance;    //资源对象实例句柄     static CStdString m_pStrResourcePath;    //资源路径     static CStdString m_pStrResourceZip;    //zip包资源名称     static CStdPtrArray m_aPreMessages;    //预处理消息队列

10 class UIMarkup -  解析XML     CMarkup()       功能 - 构造函数       pstrXML - xml数据       实现 -         初始化成员变量         调用Load()     ~CMarkup()       功能 - 析构函数     Load()       功能 - 加载xml数据       pstrXML - xml数据     LoadFromMem()       功能 - 从内存中加载xml数据       pByte - 内存数据指针       dwSize - 大小       encoding - 编码方式 XMLFILE_ENCODING_UTF8(默认) XMLFILE_ENCODING_UNICODE XMLFILE_ENCODING_ASNI       实现 -         进行编码转换         申请控件         复制数据     LoadFromFile()      功能 - 从文件中加载xml数据      pstrFilename - 文件名      encoding - 编码方式      实现 -        判断资源类型是否为zip包,如果为zip包则进行解压        调用LoadFromMem()     Release() - 释放xml数据和元素信息数据     IsValid() - Markup是否有效     SetPreserveWhitespace() - 设置是否保存空白行     GetLastErrorMessage()       功能 - 得到错误信息       pstrMessage - [out]错误信息内容       cchMax - 信息长度     GetLastErrorLocation       功能 - 得到出错位置       pstrSource - 错误所在位置内容       cchMax - 内容长度     GetRoot() - 得到根节点     tagXMLELEMENT    //元素结构     {         ULONG iStart;    //在m_pstrXML中起始位置         ULONG iChild;    //子标签在m_pstrXML中的位置         ULONG iNext;    //同级下一个标签在m_pstrXML中的位置         ULONG iParent;    //上一级标签在m_pstrXML中的位置         ULONG iData;    //元素数据在m_pstrXML中的位置     } XMLELEMENT;     LPTSTR m_pstrXML;    //xml数据     XMLELEMENT* m_pElements;    //元素列表     ULONG m_nElements;    //元素数量     ULONG m_nReservedElements;    //存储元素空间     TCHAR m_szErrorMsg[100];    //错误消息     TCHAR m_szErrorXML[50];        //错误内容     bool m_bPreserveWhitespace;    //是否过滤空白     解析xml数据     bool _Parse();     bool _Parse(LPTSTR& pstrText, ULONG iParent);       实现 -         for(;;)         {             如果为顶层则返回             填充element             解析名字             解析属性             标签闭合方式             如果为/>则continue             如果为>则递归调用_Parse()             如果为该标签的对应闭合标签 continue         }     XMLELEMENT* _ReserveElement(); - 申请保存元素空间     跳过空白       inline void _SkipWhitespace(LPTSTR& pstr) const;       inline void _SkipWhitespace(LPCTSTR& pstr) const;     跳过标识符       inline void _SkipIdentifier(LPTSTR& pstr) const;       inline void _SkipIdentifier(LPCTSTR& pstr) const;          bool _ParseData(LPTSTR& pstrText, LPTSTR& pstrData, char cEnd);      功能 - 解析数据      pstrText - 被解析的数据字符串      pstrData - 解析后的数据字符串      cEnd - 终止字符     解析转义字符       void _ParseMetaChar(LPTSTR& pstrText, LPTSTR& pstrDest);     解析属性       bool _ParseAttributes(LPTSTR& pstrText);     记录错误信息返回错误       bool _Failed(LPCTSTR pstrError, LPCTSTR pstrLocation = NULL); =======update 2011-07-10======== 11 class CMarkupNode     CMarkupNode() - 构造函数 构造一个空节点     CMarkupNode(CMarkup* pOwner, int iPos)       功能 - 构造函数       pOwner - CMarkup指针       iPos - 在xml数据中的位置     IsValid() - 节点对象是否有效     GetParent() - 得到父节点     GetSibling() - 得到兄弟节点     GetChild() - 得到子节点     GetChild(LPCTSTR pstrName)       功能 - 按名字得到子节点       实现 - 循环查找所有子节点，直到名字匹配     HasSiblings() - 是否有兄弟节点     HasChildren() - 是否有子节点     GetName() - 得到节点对应的标签名     GetValue() - 得到节点对应的标签数据值     HasAttributes() - 是否有属性     HasAttribute(LPCTSTR pstrName) - 是否有名为pstrName的属性     GetAttributeCount() - 得到节点属性的数量     GetAttributeName(int iIndex) - 按序号得到属性名称     bool GetAttributeValue(int iIndex, LPTSTR pstrValue, SIZE_T cchMax)       功能 - 得到属性       iIndex - 属性序号       pstrValue - [out] 属性值字符串       cchMax - 属性值字符串长度     bool GetAttributeValue(LPCTSTR pstrName, LPTSTR pstrValue, SIZE_T cchMax)       功能 - 得到属性       pstrName - 属性名       pstrValue - [out] 属性值字符串       cchMax - 属性值字符串长度     _MapAttributes() - 解析xml属性建立 属性名和值的表映射到xml数据的位置     enum { MAX_XML_ATTRIBUTES = 64 };    //属性最大数量限制     typedef struct     {         ULONG iName;         ULONG iValue;     } XMLATTRIBUTE;    //属性结构     int m_iPos;    //节点在xml数据中的位置     int m_nAttributes;    //属性数量     XMLATTRIBUTE m_aAttributes[MAX_XML_ATTRIBUTES];    //属性-值 映射xml位置 列表     CMarkup* m_pOwner;    - CMarkup指针 12 class IDialogBuilderCallback - 构建UI时回调类 用于创造用户自定义的控件    virtual CControlUI* CreateControl(LPCTSTR pstrClass) = 0 - 创建用户自定义控件, pstrClass控件名 13 class CDialogBuilder - UI构建者, 用于构建UI      CControlUI* Create();        功能 - 构建UI      STRINGorID xml - 可以是一个内存xml数据或一个文件名      STRINGorID type = (UINT) 0 - 如果xml数据位于EXE资源中则type指定资源类型      IDialogBuilderCallback* pCallback = NULL - 回调函数      CPaintManagerUI* pManager = NULL - 绘制管理者指针        实现 -          判断xml类型          加载xml数据          调用Create(pCallback, pManager)构建     CControlUI* Create(IDialogBuilderCallback* pCallback = NULL, CPaintManagerUI* pManager = NULL);       功能 - 构建UI       实现 -         得到顶层Window标签,并解析属性         调用_Parse() 解析xml     void GetLastErrorMessage(LPTSTR pstrMessage, SIZE_T cchMax) const; - 错误信息     void GetLastErrorLocation(LPTSTR pstrSource, SIZE_T cchMax) const; - 出错位置     CControlUI* _Parse(CMarkupNode* parent, CControlUI* pParent = NULL, CPaintManagerUI* pManager = NULL);     实现 -       for(循环顶级标签)       {           按xml标签创建控件对象           如果不是标准控件则调用m_pCallback->CreateControl()创建用户自定义控件对象           如果有子节点则递归调用_Parse()           因为某些属性和父窗口相关，比如selected，必须先Add到父窗口           初始化控件默认属性           根据xml数据解析处理控件属性      }    CMarkup m_xml; //CMarkup对象    IDialogBuilderCallback* m_pCallback;//构建控件回调 14 class CControlUI - 控件     GetName() - 得到控件名称 名称为控件的唯一ID     SetName() - 设置控件名称     GetInterface() - 得到控件指针     GetClass() - 得到控件类名     GetControlFlags() - 得到控件的类型标志     Activate() - 控件是否活跃 (非不可用状态，非不可见状态)     GetManager() - 得到绘制管理者     SetMananer()       功能 - 设置控件的绘制管理者       实现 -         设置控件管理者         初始化     GetParent() - 得到父控件     GetText() - 得到控件显示内容     SetText() - 设置控件显示内容     GetBkColor() - 得到背景色     GetBkColor2() - 得到背景色2     SetBkColor2() - 设置背景色2     GetBkColor3() - 得到背景色3     SetBkColor3() - 设置背景色3 * 背景色1,2,3用于渐变色 颜色渐变过程为1->2->3     GetBkImage() - 得到背景图片     SetBkImage() - 设置背景图片     GetBorderColor() - 得到边的颜色     SetBorderColor() - 设置边的颜色     GetFocusBorderColor() - 设置获得焦点时边的颜色     GetBorderSize() - 得到边的宽度     SetBorderSize() - 设置边的宽度     GetBorderRound() - 得到圆角     SetBorderRound() - 设置圆角     DrawImage() - 绘制图片     GetPos() - 得到控件位置     SetPos() - 设置控件位置并重绘     GetWidth() - 得到控件宽度     GetHeight() - 得到控件高度     GetX() - 得到控件横坐标位置(左上点横坐标)     GetY() - 得到控件纵坐标位置(左上点纵坐标)     GetPadding() - 设置外边距，由上层窗口绘制(求周围控件离它远点或近点(负值，不过受绘制顺序影响，比较少用)     SetPadding() - 设置外边距，由上层窗口绘制     GetFixedXY() - 实际大小位置使用GetPos获取，这里得到的是预设的参考值     SetFixedXY() - 仅float为true时有效     GetFixedWidth() - 实际大小位置使用GetPos获取，这里得到的是预设的参考值     SetFixedWidth() - 预设的参考值     GetFixedHeight() - 实际大小位置使用GetPos获取，这里得到的是预设的参考值     SetFixedHeight() - 预设的参考值     设置大小的限制值       GetMinWidth()       SetMinWidth()       GetMaxWidth()       SetMaxWidth()       GetMinHeight()       SetMinHeight()       GetMaxHeight()       SetMaxHeight()     SetRelativePos() - 设置相对位置比例     SetRelativeParentSize() - 设置父控件大小     GetRelativePos() - 得到相对位置比例     IsRelativePos() -是使用相对位置     获取/设置 提示信息       GetToolTip()       SetToolTip()     获取/设置 快捷键       GetShortcut()       SetShortcut()     获取/设置 上下文菜单是否被使用       IsContextMenuUsed()     获取/设置 用户数据(字符串)       GetUserData()       SetUserData()     获取/设置 用户指针       GetTag()       SetTag()     获取/设置 控件是否可见       IsVisible()       SetVisible()       SetInternVisible() // 仅供内部调用，有些UI拥有窗口句柄，需要重写此函数 =============update 2011-07-11     获取/设置 控件可用       IsEnabled()       SetEnabled()     获取/设置 是否处理鼠标事件       IsMouseEnabled()       SetMouseEnabled()     控件是否获得焦点       IsFocused()     设置控件获得焦点       SetFocuse()     控件是否悬浮       IsFloat()     设置控件为悬浮       SetFloat()     FindControl() - 查找控件     Invalidate()       功能 - 设置无效,引起刷新       实现 - 循环至顶层控件为止, 计算当前无效区域与父控件交叉区域作为新无效区域。     获取/设置 需更新状态       IsUpdateNeeded()       NeedUpdate()     Init() - 初始化控件事件响应, 在SetManager()中被调用     DoInit() - 做初始化处理函数, 被Init()调用     DoEvent() - 事件响应函数     SetAttribute() - 设置属性, 根据解析后的名称对所关心的属性设置状态成员变量的值     ApplyAttributeList() - 解析标签的属性字符串, 调用SetAttribute()     EstimateSize() - 预估控件大小     DoPaint()       功能 - 控件绘制       实现 - 绘制循序：背景颜色->背景图->状态图->文本->边框     PaintBkColor()       功能 - 绘制背景色     PaintBkImage()       功能 - 绘制背景图片     PaintStatusImage()       功能 - 根据状态绘制背景图片     PaintText() - 绘制文字     PaintBorder() - 绘制边框     DoPostPaint() - ?     事件源 - 可以通过委托的设计模式为初始化，销毁，事件处理过程中加入更多的处理过程     CEventSource OnInit; - 初始化事件源     CEventSource OnDestroy; - 销毁事件源     CEventSource OnEvent; - 事件响应事件源      ======update 2011 07 16 15 UIlib.h/UIlib.cpp    * UIlib.h      导出导入宏      包含系统的头文件      包含duilib库的头文件    * UIlib.cpp      Bjarke Viksoe UI library      dllmain() 函数 16 class CDelegateBase 委托模式中的虚基类      CDelegateBase(void* pObject, void* pFn); - 构造函数，pObject为委托者的对象， pFn为执行方法      CDelegateBase(const CDelegateBase& rhs); - 拷贝构造函数      virtual ~CDelegateBase(); - 析构函数      bool Equals(const CDelegateBase& rhs) const; - 比较两个委托者, true 一致 false不同      bool operator() (TEventUI& event); - 响应委托进行处理 event为响应的事件      virtual CDelegateBase* Copy() = 0; - 拷贝一个委托者      void* GetFn(); - 得到执行方法      void* GetObject(); - 得到委托者对象      virtual bool Invoke(TEventUI& event) = 0; - 调用执行方法      void* m_pObject; - 委托者      void* m_pFn; - 执行方法 17 class CDelegateStatic 静态委托，委托者为空，但有执行过程 18 class CDelegate 委托，委托者不为空 19 产生委托    CDelegate<O, T> MakeDelegate(O* pObject, bool (T::* pFn)(TEventUI&))   inline CDelegateStatic MakeDelegate(bool (*pFn)(TEventUI&)) 20 class CEventSource - 事件源      加入一个委托者        void operator+= (CDelegateBase& d);        void operator+= (FnType pFn);     删除一个委托者        void operator-= (CDelegateBase& d);        void operator-= (FnType pFn);     响应事件进行处理     bool operator() (TEventUI& event);     CStdPtrArray m_aDelegates; - 委托者列表 21 class CLabelUI - 标签控件     CLabelUI() - 构造函数     m_uTextStyle - 样式, 默认居中     m_dwTextColor - 可用时文字颜色     m_dwDisabledTextColor - 不可用时文字颜色     m_iFont - 字体序号     m_bShowHtml - 是否使用内嵌hmtl标记格式     GetClass() - 返回控件名     GetInterface() - 得到对象指针     获取/设置 文本样式       GetTextStyle()       SetTextStyle()     获取/设置 可用状态文字颜色       SetTextColor()       GetTextColor()     获取/设置 为可用状态文字颜色       SetDisableTextColor()       GetDisabledTextColor()     获取/设置 控件使用的字体, 对应在字体列表中的序号       SetFont()       GetFont()     获取/设置 文字与边框之间填充距离       GetTextPadding()       SetTextPadding()     获取/设置 是否使用内嵌html标记格式       IsShowHtml()       SetShowHtml()     EstimateSize() - 预估控件大小     DoEvent() - 事件处理     SetAttribute() - 设置属性     PaintText() - 绘制文本 22 class CButtonUI     CButtonUI() - 构造函数, 文本样式为单行居中     GetClass() - 返回控件名     GetInterface() - 得到对象指针     GetControlFlags() - 得到控件的类型标志     DoEvent() - 事件处理     非鼠标事件交给基类CLabelUI处理, 鼠标事件由此函数处理     Activate()       功能 - 激活按钮控件       实现 - 判断是否活跃，如活跃发送通知     SetEnabled() - 设置按钮控件是否可用       实现 - 调用基类设置, 如不可用则清空按钮状态     设置/获取 鼠标悬时文本的颜色       SetHotTextColor()       GetHotTextColor()     设置/获取 按钮按下时文本颜色       SetPushedTextColor()       GetPushedTextColor()     设置/获取 按钮获得焦点时文本颜色       SetFocusedTextColor()       GetFocusedTextColor()     获取/设置 正常状态下按钮背景图片       GetNormalImage()       SetNormalImage()     获取/设置 鼠标悬浮时按钮背景图片       SetHotImage()       GetHotImage()     获取/设置 按钮被按下时背景图片       GetPushedImage()       SetPushedImage()     获取/设置 按钮获得焦点时背景图片       GetFocusedImage()       SetFocusedImage()     获取/设置 非可用状态下按钮背景图片       GetDisabledImage()       SetDisabledImage()     EstimateSize() - 预估大小     SetAttribute() - 设置属性, 根据解析后的名称对所关心的属性设置状态成员变量的值     PaintText() - 绘制文本     PaintStatusImage() - 绘制状态背景图片 23 class COptionUI - 选项控件(如CheckBox RadioBox等)     COptionUI() - 构造函数     ~COptionUI() - 析构函数       CPaintManaerUI::RemoveOptionGroup()     GetClass() - 返回控件名     GetInterface() - 得到对象指针     SetManager() - 设置绘制管理者, 父控件     获取/设置 选项所属组     GetGroup()     SetGroup()     获取/设置 选项是否处于选中状态     IsSelected()     Selected()     Activate() - 激活选项控件     获取/设置 选中状态背景图片       GetSelectedImage()       SetSelectedImage()     获取/设置 前景图片       GetForeImage()       SetForeImage()     EstimateSize() - 预估选项控件大小     SetAttribute() - 设置属性, 根据解析后的名称对所关心的属性设置状态成员变量的值     PaintStatusImage() - 绘制状态背景图片 24 class CTextUI   * CTextUI() - 构造     ~CTextUI() － 析构     GetClass() - 返回控件名     GetControlFlags() - 得到控件的类型标志     GetInterface() - 得到对象指针     GetLinkContent() － 得到当前控件中指定序号的超文本的内容     DoEvent() - 事件处理     EstimateSize() - 预估选项控件大小     PaintText() - 绘制文字     MAX_LINK - 超文本数量限制     m_nLinks - 超文本数量     m_rcLinks - 超文本区域数组     m_sLinks - 超文本内容数组     int m_bHoverLink - 鼠标浮动的超文本链接序号 25 class CProgressUI     GetClass() - 返回控件名     GetInterface() - 得到对象指针     - 获取/设置 进度条方向       bool IsHorizontal();       void SetHorizontal(bool bHorizontal = true);     －获取/设置 最小值     int GetMinValue() const;     void SetMinValue(int nMin);     获取／设置 最大值     int GetMaxValue() const;     void SetMaxValue(int nMax);     获取 设置 最小值     int GetValue() const;     void SetValue(int nValue);     获取 设置 前景图     LPCTSTR GetFgImage() const;     void SetFgImage(LPCTSTR pStrImage);     void SetAttribute(LPCTSTR pstrName, LPCTSTR pstrValue); － 设置属性     void PaintStatusImage(HDC hDC); － 绘制状态图     bool m_bHorizontal - 进度条控件方向     int m_nMax; 最大值     int m_nMin; 最小值     int m_nValue; 当前值     CStdString m_sFgImage; － 前景图     CStdString m_sFgImageModify; - 前景图2 26 class CSliderUI     CSliderUI() - 构造     GetClass() - 返回控件名     GetInterface() - 得到对象指针     UINT GetControlFlags() const; -  得到控件的类型标志     void SetEnabled(bool bEnable = true); - 设置滑块控件是否可用     获取 设置滑块步长     int GetChangeStep();     void SetChangeStep(int step);     获取设置滑块大小     void SetThumbSize(SIZE szXY);     RECT GetThumbRect() const;     获取设置滑块图     LPCTSTR GetThumbImage() const;     void SetThumbImage(LPCTSTR pStrImage);     获取设置鼠标悬浮状态滑块图     LPCTSTR GetThumbHotImage() const;     void SetThumbHotImage(LPCTSTR pStrImage);     获取设置滑块按下状态滑块图     LPCTSTR GetThumbPushedImage() const;     void SetThumbPushedImage(LPCTSTR pStrImage);        void DoEvent(TEventUI& event); - 事件处理     void SetAttribute(LPCTSTR pstrName, LPCTSTR pstrValue); - 设置属性     void PaintStatusImage(HDC hDC); - 绘制状态图     SIZE m_szThumb; - 滑块大小     UINT m_uButtonState; - 控件状态     int m_nStep; - 步长     CStdString m_sThumbImage; - 正常状态滑块块图     CStdString m_sThumbHotImage; - 鼠标悬浮状态滑块图     CStdString m_sThumbPushedImage; - 按下状态滑块图     CStdString m_sImageModify; - 滑块图2