CFileFind類的使用總結(jié)
2007-7-7
1、CFileFind類的聲明文件保存在afx.h頭文件中。
2、該類的實(shí)現(xiàn)的功能：執(zhí)行本地文件的查找(查找某個(gè)具體的文件，查找某類文件x*.x*，查找所有文件*.*)
3、CFileFind類是CGopherFileFind和CFtpFileFind類的基類。
4、CFileFind類的構(gòu)造函數(shù)::CFileFind()和關(guān)閉函數(shù)::Close()我會(huì)成對(duì)使用。
5、CFileFind類的成員函數(shù)我根據(jù)其操作特性劃分為３類：查找操作類、獲得文件屬性類、判斷文件屬性類。(下面我先進(jìn)行函數(shù)羅列并沒(méi)有完整的描述函數(shù)的參數(shù))
查找操作類
::FindFile();
::FindNextFile();
獲得文件屬性類
::GetCreationTime();
::GetLastAccessTime();
::GetLastWriteTime();
::GetFileName();
::GetRoot();
::GetFilePath();
::GetFileTitle();
::GetFileURL();
::GetLength();
判斷文件屬性類
::IsArchived();
::IsCompressed();
::IsDirectory();
::IsDots();
::IsHidden();
::IsNormal();
::IsReadOnly();
::IsSystem();
::IsTemporary();
::MatchesMask();
6、CFileFind類中成員函數(shù)使用應(yīng)注意的順序
在創(chuàng)建了CFileFind對(duì)象后，先執(zhí)行::FindFile()函數(shù)，然后執(zhí)行::FindNextFile()，然后選擇執(zhí)行（獲得文件屬性類）的函數(shù)或者（判斷文件屬性類）函數(shù)。
7、CFileFind類成員函數(shù)的詳細(xì)分析
virtual BOOL FindFile(LPCTSTR pstrName = null,DWORD dwUnused = 0);
該函數(shù)若返回非0 則表明執(zhí)行成功，0 則表明執(zhí)行不成功。
pstrName：需要查找的文件名，例：“E:\\編程工具\\VC++\\MFC例子.rar”，“E:\\編程工具\\VC++\\MFC*.rar”，“E:\\編程工具\\VC++\\*.*”，也可以是NULL表示“*.*”。
dwUnused：必須為0
virtual BOOL FindNextFile();
該函數(shù)返回值非0 還有符合條件的文件， 0表示是最后一個(gè)文件。
virtual BOOL GetCreationTime(FILETIME *pFileTime) const;
virtual BOOL GetCreationTime(CTime& refTime) const;
該函數(shù)用來(lái)獲得查找到的某個(gè)文件的創(chuàng)建時(shí)間，返回值非0 獲得創(chuàng)建時(shí)間成功操作，0表示執(zhí)行獲得創(chuàng)建時(shí)間失敗或者FindNextFile()沒(méi)有被執(zhí)行的時(shí)候。
FILETIME *：容納時(shí)間的結(jié)構(gòu)指針
CTime&：容納時(shí)間的對(duì)象地址
此處介紹：FILETIME和CTime相互轉(zhuǎn)換的處理方法：
FILETIME轉(zhuǎn)CTime的方法：
A、CTime對(duì)象在初始化時(shí)可以傳遞FILETIME結(jié)構(gòu)
FILETIME ft；
CTime time(ft)；
B、將FILETIME轉(zhuǎn)換為SYSTEMTIME，然后CTime對(duì)象在初始化時(shí)可以傳遞SYSTEMTIME結(jié)構(gòu)
FILETIME ft；
SYSTEMTIME st；
BOOL bSuccess ＝ ::FileTimeToSystemTime(&ft , &st);
CTime time(st)；
CTime轉(zhuǎn)FILETIME方法：
CTime time(CTime::GetCurrentTime());
SYSTEMTIME st;
time.GetAsSystemTime(st);
FILETIME ft;
::SystemTimeToFileTime(&st,&ft);
virtual BOOL GetLastAccessTime(FILETIME *pFileTime) const;
virtual BOOL GetLastAccessTime(CTime& refTime) const;
該函數(shù)用來(lái)獲得某個(gè)文件最后被訪問(wèn)的時(shí)間，非0表示執(zhí)行成功，0表示執(zhí)行失敗或者FindNextFile()函數(shù)沒(méi)有執(zhí)行的時(shí)候。
virtual BOOL GetLastWriteTime(FILETIME *pFileTime) const;
virtual BOOL GetLastWriteTime(CTime& refTime) const;
該函數(shù)用來(lái)獲得某個(gè)文件最后被訪問(wèn)的時(shí)間，非0表示執(zhí)行成功，0表示執(zhí)行失敗或者FindNextFile()函數(shù)沒(méi)有執(zhí)行的時(shí)候。
virtual CString GetFilePath() const;
該函數(shù)用來(lái)獲得查找到的文件絕對(duì)路徑，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
返回的結(jié)果是CString對(duì)象，例“E:\\編程工具\\VC++\\MFC.rar”
virtual CString GetFileName() const;
該函數(shù)用來(lái)獲得查找到的文件的全稱，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
返回的結(jié)果是CString對(duì)象，例“MFC.rar”
virtual CString GetFileTitle() const;
該函數(shù)用來(lái)獲得查找到的文件的名稱，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
返回的結(jié)果是CString對(duì)象，例“MFC”
virtual CString GetRoot() const;
該函數(shù)用來(lái)獲得查找到的文件的根目錄，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
返回的結(jié)果是CString對(duì)象，例“E:\\編程工具\\VC++\\”
virtual CString GetFileURL() const;
該函數(shù)用來(lái)獲得查找到的文件的URL路徑，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
返回的結(jié)果是CString對(duì)象，例“file://E:\\編程工具\\VC++\\MFC.rar”
DWORD GetLength() const;
該函數(shù)返回值獲得查找到的文件的長(zhǎng)度，必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功。
BOOL IsArchived() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否是檔案文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsCompressed() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否是壓縮文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsDirectory() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否是路徑文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsDots() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否是“.”，“..”，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsHidden() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否隱藏文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsNormal() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否正常文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsReadOnly() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否只讀文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsSystem() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否系統(tǒng)文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL IsTemporary() const;
該函數(shù)用來(lái)判斷查找的文件屬性是否臨時(shí)文件，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
BOOL MatchesMask(DWORD dwMask) const;
該函數(shù)用來(lái)判斷查找的文件的綜合屬性，非0表示是，0表示不是。必須在執(zhí)行了FindNextFile()后該函數(shù)才能執(zhí)行成功
dwMask參數(shù)的使用方法：幾種文件屬性采用或運(yùn)算（|）
文件屬性的結(jié)構(gòu)定義：
FILE_ATTRIBUTE_ARCHIVE：檔案文件
FILE_ATTRIBUTE_COMPRESSED：壓縮文件
FILE_ATTRIBUTE_DIRECTORY：路徑文件
FILE_ATTRIBUTE_NORMAL：正常文件
FILE_ATTRIBUTE_READONLY：只讀文件
FILE_ATTRIBUTE_SYSTEM：系統(tǒng)文件
FILE_ATTRIBUTE_TEMPORARY：臨時(shí)文件
FILE_ATTRIBUTE_HIDDEN：隱藏文件