DuiLib 源码分析——UIBase

DuiLib源码分析 ——以DuiLib 1.01版为分析目标

——colin3dmax 分析于2011-6-16 19:44

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

分析约定:

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

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

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

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

本篇分析一下源文件

UIBase.h/UIBase.cpp

UILib的基础类的定义源文件

包括UI中常用宏的封装、代码调试宏、

绘图常用的各种数据结构，以及UILib中的窗体类等

UI里的宏

窗体样式宏

+---UI_WNDSTYLE_CONTAINER 容器样式，无任何样式

+---UI_WNDSTYLE_FRAME UI标准框架窗体样式(标题栏、边框、图标、标题、最大、最小按钮、关闭按钮)

+---UI_WNDSTYLE_CHILD UI窗体子控件样式

+---UI_WNDSTYLE_DIALOG UI对话框窗体样式

扩展窗体样式宏

+---UI_WNDSTYLE_EX_FRAME 窗体客户区凹陷样式

+---UI_WNDSTYLE_EX_DIALOG 工具栏窗口样式+模式对话框样式

类样式宏

+---UI_CLASSSTYLE_CONTAINER 类容器样式

+---UI_CLASSSTYLE_FRAME 水平、垂直大小改变时绘制

+---UI_CLASSSTYLE_CHILD 水平、垂直大小改变时绘制、支持双击事件、保存窗体位图

+---UI_CLASSSTYLE_DIALOG 水平、垂直大小改变时绘制、支持双击事件、保存窗体位图

ASSERT(expr) 判断表达式是否为NULL或FALSE

TRACE(LPSTSTR pstrFormat,...)

在Debug输出窗口打印格式化字符串

TRACEMSG(UINT uMsg) 返回指定消息的16进制表示

基础类

STRINGorID 用于构建资源名称或资源ID号

x---LPCTSTR m_lpstr;

+---STRINGorID(LPCTSTR lpString)

+---STRINGorID(UINT nID)



CPoint 点的封装类，支持LPARAM构建点

+---CPoint();

+---CPoint(const POINT& src);

+---CPoint(int x, int y);

+---CPoint(LPARAM lParam);



CSize 大小封装

+---CSize();

+---CSize(const SIZE& src);

+---CSize(const RECT rc);

+---CSize(int cx, int cy);

CRect 区域封装

+---CRect();

+---CRect(const RECT& src);

+---CRect(int iLeft, int iTop, int iRight, int iBottom);

+---int GetWidth() const 获取宽度

+---int GetHeight() const 获取高度

+---void Empty() 清空

+---bool IsNull() const 是否为Empty，IsEmpty

+---Join(const RECT& rc) 支持区域合并

+---Normalize() 正规化(使得left<right,top<bottom)

+---Offset(int cx, int cy) 区域偏移(移动)操作

+---Inflate(int cx, int cy) 区域膨胀

+---Deflate(int cx, int cy) 区域收缩

+---Union(CRect& rc) 区域并操作

CStdPtrArray 指针数组类

x---LPVOID* m_ppVoid 数据指针

x---int m_nCount 指针数量

x---int m_nAllocated 内存已分配大小

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

+---void Empty() 清空记录

+---void Resize(int iSize) 重新分配内存大小(注意:之前的记录丢失)

+---bool IsEmpty() const 是否为空数组

+---int Find(LPVOID iIndex) const 查询指定元素的索引号

+---bool Add(LPVOID pData) 在指针集合中添加新数据

+---bool SetAt(int iIndex, LPVOID pData)设置指定索引号处的新数据

+---bool InsertAt(int iIndex, LPVOID pData)在指定的索引号处插入数据

+---bool Remove(int iIndex) 移除指定索引号得数据

+---int GetSize() const 获取指针数量

+---LPVOID* GetData() 获取全部的数据

+---LPVOID GetAt(int iIndex) const 查询索引号所对应的元素

+---LPVOID operator[] (int nIndex) const支持[]查找元素



CStdValArray 自定义数据长度数组类

x---LPBYTE m_pVoid 指针数据

x---int m_iElementSize 元素大小

x---int m_nCount 元素数量

x---int m_nAllocated 当前分配的可用容量

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

+---CStdValArray(int iElementSize, int iPreallocSize = 0)

指定元素大小，预分配数量

+---void Empty() 清空数据

+---bool IsEmpty() const 是否为空数组

+---bool Add(LPCVOID pData) 追加数据

+---bool Remove(int iIndex) 移除指定索引号得数据

+---int GetSize() const 获取当前保存元素的个数

+---LPVOID GetData() 获取数据

+---LPVOID GetAt(int iIndex) const 获取指定索引号处的数据

+---LPVOID operator[] (int nIndex) const支持[]查找元素



CStdString 字符串类

x---LPTSTR m_pstr; 字符指针

x---TCHAR m_szBuffer[MAX_LOCAL_STRING_LEN + 1];字符缓冲区

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

+---CStdString(); 初始化字符串类

+---CStdString(const TCHAR ch);

+---CStdString(const CStdString& src);

+---CStdString(LPCTSTR lpsz, int nLen = -1);长度为-1由程序自己判断长度

+---void Empty(); 清空字符串

+---int GetLength() const; 获取字符串长度

+---bool IsEmpty() const; 字符串是否为空串

+---TCHAR GetAt(int nIndex) const; 获取指定位置处的字符

+---void Append(LPCTSTR pstr); 字符串追加操作

+---void Assign(LPCTSTR pstr, int nLength = -1);分配内存赋值

+---LPCTSTR GetData(); 获取字符串指针

+---void SetAt(int nIndex, TCHAR ch); 在指定索引处设置字符

+---int Compare(LPCTSTR pstr) const; 字符串比较

+---int CompareNoCase(LPCTSTR pstr) const;字符串忽略大小写比较

+---void MakeUpper(); 字符串转换为大小

+---void MakeLower(); 字符串转换为小写

+---CStdString Left(int nLength) const; 从左边截取指定长度的子串

+---CStdString Mid(int iPos, int nLength = -1) const;

截取中间字符串

+---CStdString Right(int nLength) const;从右开始截取指定长度的字符串

+---int Find(TCHAR ch, int iPos = 0) const;

从指定位置开始寻找匹配字符的位置

+---int Find(LPCTSTR pstr, int iPos = 0) const;

重指定位置开始寻找匹配字符串的位置

+---int ReverseFind(TCHAR ch) const; 反向查询字符位置

+---int Replace(LPCTSTR pstrFrom, LPCTSTR pstrTo);

将匹配的字符子串用指定字符串替换

+---int __cdecl Format(LPCTSTR pstrFormat, ...);

最长63位的字符串格式化

+---int __cdecl SmallFormat(LPCTSTR pstrFormat, ...);

一次格式化1024长度的字符串格式化



TITEM结构

o---CStdString Key 键

o---LPVOID Data 值

o---struct TITEM* pNext 下一个TITEM结构体指针



CStdStringPtrMap

x---TITEM** m_aT; TITEM双指针

x---int m_nBuckets; 容器容量

+---CStdStringPtrMap(int nSize = 83); 构建字符串Map集合

+---void Resize(int nSize = 83); 重新分配集合大小

+---LPVOID Find(LPCTSTR key) const; 更具键查询字符串指针

+---bool Insert(LPCTSTR key, LPVOID pData);插入数据

+---LPVOID Set(LPCTSTR key, LPVOID pData);设置指定键的数据

+---bool Remove(LPCTSTR key); 通过键移除数据

+---int GetSize() const; 获取大小

+---LPCTSTR GetAt(int iIndex) const; 获取指定索引处得字符串

+---LPCTSTR operator[] (int nIndex) const;通过下标获取字符串





CWindowWnd

x---HWND m_hWnd 窗体句柄，初始化为NULL

x---WNDPROC m_OldWndProc Win32窗口过程，默认为DefWindowProc

x---bool m_bSubclassed 是否子类化，默认为false

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

获取窗口类名称，子类必须实现该纯虚函数

o---virtual LPCTSTR GetWindowClassName() const = 0;

获取父类名称，用以子类化

o---virtual LPCTSTR GetSuperClassName() const;

获得类样式

o---virtual UINT GetClassStyle() const;

消息处理函数

o---virtual LRESULT HandleMessage(UINT uMsg, WPARAM wParam, LPARAM lParam);

窗体销毁前最后的处理工作

o---virtual void OnFinalMessage(HWND hWnd);

窗口过程回调函数

o---static LRESULT CALLBACK __WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam);

控件过程回调函数

o---static LRESULT CALLBACK __ControlProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam);

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



+---CWindowWnd();

获取窗口句柄

+---HWND GetHWND() const;

获取窗口句柄

+---operator HWND() const;

注册窗口过程

1.调用GetClassStyle获取样式信息

2.调用绘图管理器的静态函数获取实例CPaintManagerUI::GetInstance()

3.调用GetWindowClassName()获取要注册的类名称

+---bool RegisterWindowClass();

通过已存在的窗体作为父类注册窗口类

+---bool RegisterSuperclass();

窗口创建

+---HWND Create(HWND hwndParent, LPCTSTR pstrName, DWORD dwStyle, DWORD dwExStyle, const RECT rc, HMENU hMenu = NULL);

创建窗口

1.如果存在父类名，就用注册父类来创建

2.不存在父类名，进行正常的窗口注册

3.以上注册成功后，创建窗口

+---HWND Create(HWND hwndParent, LPCTSTR pstrName, DWORD dwStyle, DWORD dwExStyle, int x = CW_USEDEFAULT, int y = CW_USEDEFAULT, int cx = CW_USEDEFAULT, int cy = CW_USEDEFAULT, HMENU hMenu = NULL);

窗口子类化

+---HWND Subclass(HWND hWnd);

卸载窗口子类化

+---void Unsubclass();

显示窗口

+---void ShowWindow(bool bShow = true, bool bTakeFocus = true);

显示模式窗口

+---bool ShowModal();

关闭窗口

+---void Close();

窗口居中，如果为子窗口，则居于父窗口的中央

+---void CenterWindow();

通过资源ID号设置图标

+---void SetIcon(UINT nRes);

发送UI同步消息

+---LRESULT SendMessage(UINT uMsg, WPARAM wParam = 0, LPARAM lParam = 0L);

投递UI异步消息

+---LRESULT PostMessage(UINT uMsg, WPARAM wParam = 0, LPARAM lParam = 0L);

调整客户区大小

+---void ResizeClient(int cx = -1, int cy = -1);

CWaitCursor 等待光标

x---HCURSOR m_hOrigCursor 替换前光标

+---CWaitCursor() 设置成等待光标

+---~CWaitCursor() 还原为之前的光标

来自：http://www.cnblogs.com/xubin0523/archive/2012/06/01/2530910.html