MFC常用类、成员函数、数组类、Cstring类、CTime类、CPoint类

MFC数组类
CByteArray：
CDWordArray：
CPtrArray：
CUIntArray：
CWordArray：
CStringArray：
常用成员函数
1．int Add（ ARG_TYPE    newElement ）; throw（ CMemoryException ）;
2．TYPE&    ElementAt（ int nIndex ）;
3．void FreeExtra（ ）;
4．TYPE GetAt（ int nIndex ） const
5．int GetSize（ ） const;
6．int GetUpperBound（ ） const;
7．(1)void InsertAt（ int nIndex, ARG_TYPE newElement, int nCount = 1 ）;
throw（ CMemoryException ）;
(2)void InsertAt（ int nStartIndex, CArray* pNewArray ）;
              throw（ CMemoryException ）;
8．void RemoveAll（ ）;
9．void SetAt（ int nIndex, ARG_TYPE newElement ）;
10．void SetAtGrow（ int nIndex, ARG_TYPE newElement ）; throw（ CMemoryException ）;
11．void SetSize（ int nNewSize, int nGrowBy = -1 ）; throw（ CMemoryException ）;
例：
CStringArray m_strArray
m_strArray.SetSize(5,5);
m_strArray[0] = "111111111111";
m_strArray[2] = "333333333333";
m_strArray[4] = "555555555555";
增加元素
int m_nIndex = 0;
       CString m_strValue = "Default";
       int m_nRadio = 0;
if (m_nRadio == 0)
          m_strArray.SetAtGrow(m_nIndex, m_strValue);
else if (m_nRadio == 1)
m_strArray.Add(m_strValue);
else
m_strArray.InsertAt(m_nIndex, m_strValue, 1);
删除
      int m_nIndex= 0;
      m_strArray.RemoveAt(m_nIndex);

MFC的链表类
模板类 Clist     CTypedPtrList
非模板类 CObList    CPtrList    CStringList
MFC链表类的常用成员函数——以Clist为例
1．CList（ int nBlockSize = 10 ）;
2．TYPE GetHead（ ） const;
3．TYPE GetTail（） const;
4．RemoveHead（）
5．RemoveTail（）
6．原型1：POSITION AddHead（ ARG_TYPE newElement ）;
原型2：void AddHead（ CList* pNewList ）;
7．原型1：POSITION AddTail（ ARG_TYPE newElement ）;
原型2：void AddTail（ CList* pNewList ）;
8．RemoveAll（）
9．POSITION GetHeadPosition（ ） const;
10．POSITION GetTailPosition（ ） const;
11．TYPE GetNext（ POSITION& rPosition ） const;
12．TYPE GetPrev（ POSITION& rPosition ） const;
13．TYPE GetAt（ POSITION position ） const;
14．void SetAt（ POSITION pos, ARG_TYPE newElement ）;
15．void RemoveAt（ POSITION position ）;
16．POSITION InsertBefore（ POSITION position, ARG_TYPE newElement ）;
17．POSITION InsertAfter（ POSITION position, ARG_TYPE newElement ）;
18．POSITION Find（ ARG_TYPE searchValue, POSITION startAfter = NULL） const;
19．POSITION FindIndex（ int nIndex ） const;
20．int GetCount（） const;
21．BOOL IsEmpty（ ） const;
例题
struct CStudent
{
       CString m_strName;
       int m_nScore;
};
CPtrList m_List;

向添加链表中添加元素
CStudent* m_pStudent = new CStudent;
m_pStudent->m_strName = m_strName;
m_pStudent->m_nScore = m_nScore;
m_List.AddTail(m_pStudent);
删除节点
         int nNumber;
CStudent* m_pStudent = NULL;
if (m_List.IsEmpty())
MessageBox("结点已经全部删除!" ;
else
{
if (m_nRadio == 0)
m_pStudent = (CStudent*)m_List.RemoveHead();
else if(m_nRadio == 1)
m_pStudent = (CStudent*)m_List.RemoveTail();
else
{
if(nNumber < m_List.GetCount())
{
          POSITION pos = m_List.FindIndex(m_nNumber);
          POSITION pos1 = pos;
          m_pStudent = (CStudent*)m_List.GetNext(pos1);
             m_List.RemoveAt(pos);
}
else
{
MessageBox("指定结点超出范围!" ;
}
}
if(m_pStudent)
delete m_pStudent;
}
遍历链表
POSITION pos = m_List.GetHeadPosition();
while (pos != NULL)
{
CStudent* m_pStudent = (CStudent*) m_List.GetNext(pos);
char s[81];
wsprintf(s, " 的成绩是 %d.",m_pStudent->m_nScore);
CString m_string=m_pStudent->m_strName+s;
}


CString类
一、常用成员函数
1．int GetLength（ ） const;
说明：获取CString类对象包含字符串的长度（字符数）。
2．BOOL IsEmpty（ ） const;
说明：测试CString类对象包含的字符串是否为空。
3．void Empty（ ）;
说明：使CString类对象包含的字符串为空字符串。
4．TCHAR GetAt（ int nIndex ） const;
说明：获得字符串指定位置处的字符。
5．TCHAR operator []（ int nIndex ） const;
说明：获得字符串指定位置处的字符，作用和GetAt（）一样。
6．void SetAt（ int nIndex, TCHAR ch ）;
说明：设定字符串指定位置处的字符。
7．operator LPCTSTR （ ） const;
说明：返回指向储存在CString类对象内的字符串指针。
8．Mid
Mid函数有两个重载函数：
CString Mid（ int nFirst ） const; throw（ CMemoryException ）;
获取从nFirst位置开始的子串。
CString Mid（ int nFirst, int nCount ） const; throw（ CMemoryException ）;
获取从nFirst位置开始包含nCount个字符的子串。
9.CString Left（ int nCount ） const;throw（ CMemoryException ）;
说明：获取字符串左边nCount长度的字符串。
10．CString Right（ int nCount ） const; throw（ CMemoryException ）;
说明：获取字符串右边nCount长度的字符串。
11．CString SpanIncluding（ LPCTSTR lpszCharSet ） const;throw（ CMemoryException ）;
说明：从字符串中提取包含在指定字符集lpszCharSet中的字符的子串。它从字符串的第一个字符开始，直到遇到不属于lpszCharSet中的字符为止。
12．CString SpanExcluding（ LPCTSTR lpszCharSet ） const;throw（ CMemoryException ）;
说明：从字符串中提取不包含在指定字符集lpszCharSet中的字符的子串。
13．MakeUpper
将字符串中所有的字符全部转化成大写形式。
14．MakeLower
将字符串中所有的字符全部转化成小写形式。
15．MakeReverse
将字符串倒置，即将字符的顺序颠倒，第一个字符变成最后一个字符。
16．int Replace（ TCHAR chOld, TCHAR chNew ）;
int Replace（ LPCTSTR lpszOld, LPCTSTR lpszNew ）;
说明：将字符串中的字符chOld或字符子串lpszOld替换成新的字符chNew或字符串lpszNew。
17.     void CString::TrimLeft（ TCHAR chTarget ）;
void CString::TrimLeft（ LPCTSTR lpszTargets ）;
说明：删除字符串左边开头的字符或字符子串，参数缺省时删除左边的空格。
18．void CString::TrimRight（ TCHAR chTarget ）;
void CString::TrimRight（ LPCTSTR lpszTargets ）;
说明：删除字符串右边开头的字符或字符子串，参数缺省时删除右边的空格。
19．Find
原型：
int Find（ TCHAR ch ） const;
int Find（ LPCTSTR lpszSub ） const;
int Find（ TCHAR ch, int nStart ） const;
int Find（ LPCTSTR pstr, int nStart ） const;
说明：在字符串中查找指定的字符或字符串。参数ch为要查找的字符；lpszSub为要查找的字符子串；nStart指定查找的起始位置，如缺省为从最左边开始；pstr指向欲查找子串的指针。
20．ReverseFind
原型：int ReverseFind（ TCHAR ch ） const;
说明：返回字符串中最后一个和指定的字符匹配的字符的下标。
21．FindOneOf
原型：int FindOneOf（ LPCTSTR lpszCharSet ） const;
说明：在字符串中查找第一个和指定的字符集lpszCharSet中任何一个字符匹配的字符的位置。
22．比较运算符
CString类重载了“==”、“!=”、“>=”、“>”、“<=”、“<”等比较运算符，可用于两个字符串间的各种比较运算，比较时区分大小写。
23．Compare
原形：int Compare（ LPCTSTR lpsz ） const;
说明：比较两个字符串，如果两个字符串相等，返回值等于0；如果本对象大于参数字符串，返回值大于0；如果本对象小于参数字符串，返回值小于0，比较时区分大小写。
24．CompareNoCase
原型：int CompareNoCase（ LPCTSTR lpsz ） const;
说明：与Compare函数类似，不同的是在忽略字符大小写的情况下比较两个字符串。
25．operator =
说明：将一个新的值赋予CString对象。
26．operator +
说明：将两个字符串合并成一个新的字符串。在两个参数中必须有一个是CString类型的，而另一个参数可以是字符、字符指针或CString类型对象。
27．operator +=
说明：在一个字符串的后面再添加一个字符串或一个字符。
二、例题
例1：连结字符串
CString m_str1="工作";
CString m_str2="正常";
CString m_str3=m_str1+m_str2;
执行第三行后，m_str3的值应该是“工作正常”。
例2：比较字符串
CString m_str1="a";
CString m_str2="b";
int result=m_str1.Compare(m_str2);
if(result=0)
AfxMessageBox("两者相同" ;
else if(result>0)
AfxMessageBox("m_str1大于m_str2" ;
else
AfxMessageBox("m_str1小于m_str2" ;
运行结果在信息框中显示“m_str1小于m_str2”。两个字符串比较大小时从第一个字母开始，按照对应的ASCII值比较。如果第一个字母相同，再比较下一个字母。依次往下直到比较出大小为止。
例3：提取字符串
CString m_str1="abcde";
CString m_str2=m_str1.Left(1)+m_str1.Mid(2,1)+m_str1.Right(1);
AfxMessageBox(m_str2);

运行结果在信息框中显示m_str2的内容“ace”。m_str1.Left（1）得到m_str1的最左边的一个字符“a”，m_str1.Mid（2,1） 从m_str1中取得从索引为2开始的一个字符“c”，m_str1.Right（1） 得到m_str1的最右边的一个字符“e”。
例4：查找字符串
CString m_str1="abcdef";
CString m_str2="deq";
int index=m_str1.Find(m_str2);
if(index>=0)
{
char s[10];
wsprintf(s,"匹配字符的下标为%d",index);
MessageBox(s);
}
else
MessageBox("没有匹配字符" ;
运行结果在信息框中显示“没有匹配字符”。m_str1.Find（m_str2）在m_str1中查找m_str2的内容“deq”，由于未找到返回 –1。
例5：变换字符串
CString m_str="     ABCabc     ";
m_str.TrimLeft();
m_str.TrimRight();
m_str.MakeUpper();
MessageBox(m_str);
运行结果在信息框中显示“ABCABC”。m_str.TrimLeft（）和m_str.TrimRight（）分别去掉m_str左边和右边的空格，m_str.MakeUpper（）将m_str中的所有字母转换成大写。
例6：转化为字符串
把CString 转化为LPTSTR和LPCTSTR可分别用如下方法
    (LPTSTR)(LPCTSTR)(_T(CString))

(LPCTSTR)(_T(CString))

CTime类
1．构造和初始化CTime类对象
CTime类有下列构造函数：
CTime（ ）;
CTime（ const CTime& timeSrc ）;
CTime（ time_t time ）;
CTime（ int nYear, int nMonth, int nDay, int nHour, int nMin, int nSec, int nDST = -1 ）;
CTime（ WORD wDosDate, WORD wDosTime, int nDST = -1 ）;
CTime（ const SYSTEMTIME& sysTime, int nDST = -1 ）;
CTime（ const FILETIME& fileTime, int nDST = -1 ）;
说明：以不同的方式构造一个CTime对象。可以用一个已经存在的CTime对象或一个time_t（在time.h中被定义为long）类型变量来构造和初始化CTime对象，也可以用年、月、日、小时、分、秒来构造和初始化CTime对象，还可以用SYSTEMTIME、FILETIME结构来构造和初始化CTime对象。SYSTEMTIME、FILETIME结构定义如下：
typedef struct _SYSTEMTIME {
      WORD wYear;
      WORD wMonth;
      WORD wDayOfWeek;
      WORD wDay;
      WORD wHour;
      WORD wMinute;
      WORD wSecond;
      WORD wMilliseconds;
} SYSTEMTIME;

typedef struct _FILETIME {
      DWORD dwLowDateTime;     /* low 32 bits    */
      DWORD dwHighDateTime;    /* high 32 bits */
} FILETIME, *PFILETIME, *LPFILETIME;

2．时间值的提取函数
（1）GetCurrentTime（）     获取系统当前时间。
原型：static CTime PASCAL GetCurrentTime（ ）;
（2）GetTime（）    由CTime对象返回一个time_t变量。
原型：time_t GetTime（ ） const;
（3）GetYear（）     获取CTime对象代表的年。
原型：int GetYear（ ） const;
以下（4）至（9）函数原型与GetYear（）类似。
（4）GetMonth（）获取CTime对象代表的月。
（5）GetDay（） 获取CTime对象代表的日期。
（6）GetHour（） 获取CTime对象代表的小时。
（7）GetMinute（）获取CTime对象代表的分。
（8）GetSecond（） 获取CTime对象代表的秒。
（9）GetDayOfWeek（） 获取CTime对象代表的星期几，1代表周日、2代表周一、等等。
3．格式化时间
成员函数Format（） 将CTime对象中的时间信息转化为一个格式化的字符串。其函数原型为：
CString Format（ LPCTSTR pFormat ） const;
CString Format（ UINT nFormatID ） const;
参数pFormat是格式字符串，类似于printf中的格式字符串，格式字符如下：
%a：周的英文缩写形式；
%A：周的英文全名形式；
%b： 月的英文缩写形式；
%B：月的英文全名形式；
%c： 完整的日期和时间；
%d：十进制形式的日期（01-31）；
%H：24小时制的小时（00-23）；
%I： 12小时制的小时（00-11）；
%j： 十进制表示的一年中的第几天（001-366）；
%m： 月的十进制表示（01-12）；
%M：十进制表示的分钟（00-59）；
%p： 12小时制的上下午标示（AM/PM）；
%S： 十进制表示的秒（00-59）；
%U： 一年中的第几个星期（00-51），星期日是一周的第一天；
%W： 一年中的第几个星期（00-51），星期一是一周的第一天；
%w： 十进制表示的星期几（0-6）；
%Y： 十进制表示的年；
参数nFormatID 是格式字符串资源的ID号。
4．重载运算符
operator = ：    赋予新的时间。
operator + ：    增加CTime和CTimeSpan对象。
operator – ：    减小CTime和CTimeSpan对象。
operator += ： CTime对象加一个CTimeSpan对象。
operator -= ：    CTime对象减一个CTimeSpan对象。
operator == ：    比较两个绝对时间是否相等。
operator != ：    比较两个绝对时间是否不相等。
operator > ：    比较两个绝对时间，是否前一个大于后一个。
operator < ：    比较两个绝对时间，是否前一个小于后一个。
operator >=    ： 比较两个绝对时间，是否前一个大于等于后一个。
operator <=    ： 比较两个绝对时间，是否前一个小于等于后一个。
例子代码
例1：获取当前时间
CTime m_time=CTime::GetCurrentTime();
CString s=m_time.Format("%A,%B,%d,%Y" ;
CString m_strTime="当前时间是："+s;
MessageBox(m_strTime);
运行结果在信息框中显示“当前时间是：Sunday,February,4,2001”，程序第一行获取系统当前时间，并赋给m_time。第二行从m_time创建一个字符串对象，将该字符串赋给变量s，格式%A为周的英文全名形式，%B为月的英文全名形式，%d为十进制形式的日期（01-31），%Y为 十进制表示的年。
例2：由年、月、日得到对应的周日。
CTime m_time(2001,2,5,12,0,0);
int weekday=m_time.GetDayOfWeek();
switch(weekday)
{
case 1:
MessageBox("今天是周日" ;
break;
case 2:
MessageBox("今天是周一" ;
break;
case 3:
MessageBox("今天是周二" ;
break;
case 4:
MessageBox("今天是周三" ;
break;
case 5:
MessageBox("今天是周四" ;
break;
case 6:
MessageBox("今天是周五" ;
break;
case 7:
MessageBox("今天是周六" ;
break;
default:
break;
}
运行结果在信息框中显示“今天是周一”，m_time.GetDayOfWeek（）获取m_time代表的周几（1代表周日，2代表周一等等）。
CTimeSpan类
1．构造函数。
CTimeSpan类有下列构造函数：
（1）CTimeSpan（） ;
（2）CTimeSpan（ const CTimeSpan& timeSpanSrc ）;
（3）CTimeSpan（ time_t time ）;
（4）CTimeSpan（ LONG lDays, int nHours, int nMins, int nSecs ）;
参数timeSpanSrc为一个已存在的 CTimeSpan 对象，time为一个time_t 类型的时间值，lDays, nHours, nMins, nSecs分别为天数、小时数、分数和秒数。
2．时间值的提取函数
（1）GetDays（）     获得CTimeSpan类对象中包含的完整的天数。
（2）GetHours（）     获得当天的小时数，值在-23到23之间。
（3）GetTotalHours（）     获得CTimeSpan类对象中包含的完整的小时数。
（4）GetMinutes（）     获得当前小时包含的分数，值在-59到59之间。
（5）GetTotalMinutes（）    获得CTimeSpan类对象中包含的完整的分数。
（6）GetSeconds（）     获得当前分钟包含的秒数，值在-59到59之间。
（7）GetTotalSeconds（）    获得CTimeSpan类对象中包含的完整的秒数。
格式化时间
Format（） 将一个CTimeSpan对象转换成格式字符串。使用方式与CTime类似，格式化字符包括以下几个：
%D：     CTimeSpan的总天数；
%H：     不足整天的小时数；
%M：     不足1小时的分数；
%S：     不足1分钟的秒数；
%%：     百分号。
4．重载运算符
CTimeSpan类也重载了运算符“=”，“+”，“-”，“+=”，“-=”，“==”，“！=”，“<”，“>”，“<=”，“>=”，用于CTimeSpan对象的赋值、加减运算及两个CTimeSpan对象的比较。
例子代码
构造一个CTimeSpan对象，并获取其中的完整天数、小时数、分数和秒数，将获得的信息在信息框中显示。
CTimeSpan m_timespan(3,4,5,6);       //    3天，4小时，5分，6秒
LONG m_totalDays=m_timespan.GetDays();         //获得完整天数
LONG m_totalHours=m_timespan.GetTotalHours();     //获得完整小时数
LONG m_totalMinutes=m_timespan.GetTotalMinutes();     //获得完整分数
LONG m_totalSeconds=m_timespan.GetTotalSeconds();     //获得完整秒数
char s1[8], s2[8], s3[8], s4[8];
wsprintf(s1,"%ld",m_totalDays);
wsprintf(s2,"%ld",m_totalHours);
wsprintf(s3,"%ld",m_totalMinutes);
wsprintf(s4,"%ld",m_totalSeconds);
CString m_str = "此时间范围包含：\n完整天数 :"+CString(s1)+"\n完整小时数:"+CString(s2)+"\n完整分数 :"+CString(s3)+"\n完整秒数 :"+CString(s4);
MessageBox(m_str);
运行结果在信息框中显示5行，其中s1的内容为“3”，s2的内容为“76”（3*24+4），s3的内容为“4565”（76*60+5），s4的内容为“273906”（4565*60+6）。
CPoint类
类CPoint是对Windows结构POINT的封装，凡是能用POINT结构的地方都可以用CPoint代替。
结构POINT表示屏幕上的一个二维点，其定义为：
typedef struct tagPOINT{
LONG x;
LONG y;
} POINT;
                   其中 x、y分别是点的横坐标和纵坐标。
                      由于CPoint提供了一些重载运算符，使得CPoint的操作更加方便。如运算符“+”，“-”，“+=”和“-=”用于两个CPoint对象或一个CPoint对象与一个CSize对象的加减运算，运算符“==”和“！=”用于比较两个CPoint对象是否相等。
CSize类

类CSize是对Windows结构SIZE的封装，凡是能用SIZE结构的地方都可以用CSize代替。
结构SIZE表示一个矩形的长度和宽度，其定义为：
typedef struct tagSIZE{
LONG cx;
LONG cy;
} SIZE;
其中 cx、cy分别是长度和宽度。
与CPoint类似，CSize也提供了一些重载运算符。如运算符“+”，“-”，“+=”和“-=”，用于两个CSize对象或一个CSize对象与一个CPoint对象的加减运算，运算符“==”和“！=”用于比较两个CSize对象是否相等。
由于CPoint和CSize都包含两个整数类型的成员变量，他们可以进行相互操作。CPoint对象的操作可以以CSize对象为参数。同样，CSize对象的操作也可以以CPoint对象为参数。如可以用一个CPoint对象构造一个CSize对象，也可以用一个CSize对象构造一个CPoint对象，允许一个CPoint对象和一个CSize对象进行加减运算。
CRect类
类CRect是对Windows结构RECT的封装，凡是能用RECT结构的地方都可以用CRect代替。
结构RECT表示一个矩形的位置和尺寸，其定义为：
typedef struct tagRECT{
LONG left;
LONG top;
LONG right;
LONG bottom;
} RECT;
其中 left、top分别表示矩形左上角顶点的横坐标和纵坐标，right、bottom分别表示矩形右下角顶点的横坐标和纵坐标。
由于CRect提供了一些成员函数和重载运算符，使得CRect的操作更加方便。
1．CRect的构造函数
CRect有如下6个构造函数：
CRect（ ）;
CRect（ int l, int t, int r, int b ）;
CRect（ const RECT& srcRect ）;
CRect（ LPCRECT lpSrcRect ）;
CRect（ POINT point, SIZE size ）;
CRect（ POINT topLeft, POINT bottomRight ）;
说明：分别以不同的方式构造CRect对象，参数l，t，r，b分别指定矩形的左边、上边、右边和底边。SrcRect是一个RECT结构的引用。LpSrcRect是一个指向RECT结构的指针。Point指定矩形的左上角顶点的坐标，size指定矩形的长度和宽度。topLeft指定矩形的左上角顶点的坐标，bottomRight指定矩形的右下角顶点的坐标。
2．CRect重载运算符
CRect重载的运算符包括：赋值运算符、比较运算符、算术运算符、交并运算符等。
赋值运算符“=”实现CRect对象间的拷贝。
比较运算符“==”和“!=”比较两个CRect对象是否相等（四个成员都相等时，两个对象才相等）。
算术运算符包括“+=”、“-=”、“+”、“-”，他们的第一个操作数是CRect对象，第二个操作数可以是POINT、SIZE或RECT。当第二个操作数是POINT或SIZE时，“+”和“+=”的运算结果使CRect矩形向x轴和y轴的正方向移动POINT或SIZE指定的大小。“-”和“-=”的运算结果则使CRect矩形向x轴和y轴的负方向移动POINT或SIZE指定的大小。当第二个操作数是RECT时，“+”和“+=”的运算结果使CRect矩形的左上角顶点向左上方向移动RECT前两个成员指定的大小，而CRect矩形的右下角顶点向右下方向移动RECT后两个成员指定的大小。“-”和“-=”的运算结果则使CRect矩形的左上角顶点向右下方向移动RECT前两个成员指定的大小，而CRect矩形的右下角顶点向左上方向移动RECT后两个成员指定的大小。
运算符“&”和“&=”得到两个矩形的交集（两个矩形的公共部分），运算符“|”和“|=”得到两个矩形并集（包含两个矩形的最小矩形）。
3．Crect其他常用成员函数
（1）Width（ ） ：得到矩形的宽度；
（2）Height（ ）：得到矩形的高度；
（3）Size（ ）：得到矩形的大小（高度和宽度）；
（4）TopLeft（ ）：得到矩形左上角顶点坐标；
（5）BottomRight（ ） ：得到矩形右下角顶点坐标；
（6）PtInRect（ ）：判断一个点是否在矩形内，如是返回真，否则返回假。原形如下：
BOOL PtInRect（ POINT point ） const;
（7）IsRectEmpty（ ）：判断矩形是否为空（高度和宽度都是0）；
（8）IsRectNull（ ）：判断矩形是否为0（左上角和右下角坐标都是0）；
（9）SetRect（ ）：设置矩形四个成员变量的值。
4．CRect的规格化
一个规格化的矩形是指他的高度和宽度都是正值，即矩形的右边大于矩形的左边，矩形的底边大于矩形的上边。矩形的规格化函数是NormalizeRect（），该函数比较矩形的的left和right及top和bottom，如果不满足规格化要求，则对换两个值。上面介绍的大部分运算符和成员函数，只有规格化的矩形才能得到正确结果。