DuiLib帮助文档篇之二UIBase

----------------------------------------------------------------------------------
分析约定:
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() 还原为之前的光标