CRecentFileList 類別
支援最近使用的 (MRU) 檔案清單控制項。
語法
class CRecentFileList
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CRecentFileList：：CRecentFileList | 建構 CRecentFileList 物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CRecentFileList：：Add | 將檔案新增至 MRU 檔案清單。 |
| CRecentFileList：：GetDisplayName | 提供 MRU 檔名功能表顯示的顯示名稱。 |
| CRecentFileList：：GetSize | 擷取 MRU 檔案清單中的檔案數目。 |
| CRecentFileList：：ReadList | 從登錄或 讀取 MRU 檔案清單。INI 檔案。 |
| CRecentFileList：：Remove | 從 MRU 檔案清單中移除檔案。 |
| CRecentFileList：：UpdateMenu | 更新 MRU 檔案清單的功能表顯示。 |
| CRecentFileList：：WriteList | 從登錄或 寫入 MRU 檔案清單。INI 檔案。 |
公用運算子
| 名稱 | 描述 |
|---|---|
| CRecentFileList：：operator [ ] | 傳 CString 回位於指定位置的物件。 |
備註
檔案可以加入或刪除 MRU 檔案清單，檔案清單可以從登錄或寫入登錄或 寫入。INI 檔案和顯示 MRU 檔案清單的功能表可以更新。
繼承階層架構
CRecentFileList
需求
標頭： afxadv.h
CRecentFileList：：Add
將檔案新增至最近使用的 （MRU） 檔案清單。
virtual void Add(LPCTSTR lpszPathName);
virtual void Add(
LPCTSTR lpszPathName,
LPCTSTR lpszAppID);
void Add(
IShellItem* pItem,
LPCTSTR lpszAppID);
void Add(
IShellLink* pLink,
LPCTSTR lpszAppID);
void Add(
PIDLIST_ABSOLUTE pidl,
LPCTSTR lpszAppID);
參數
lpszPathName
指定要新增至清單的路徑名稱。
lpszAppID
指定應用程式的應用程式使用者模型識別碼。
pItem
指定要加入清單之Shell專案的指標。
pLink
指定要新增至清單的Shell連結指標。
pidl
指定應該新增至最近 docs 資料夾之殼層專案的 IDLIST。
備註
檔名將會新增至 MRU 清單頂端。 如果檔名已存在於 MRU 清單中，則會移至頂端。
CRecentFileList：：CRecentFileList
建構 CRecentFileList 物件。
CRecentFileList(
UINT nStart,
LPCTSTR lpszSection,
LPCTSTR lpszEntryFormat,
int nSize,
int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);
參數
nStart
MRU 功能表顯示中編號的位移（最近使用過的）檔案清單。
lpszSection
指向登錄或應用程式的 區段名稱。讀取和/或寫入 MRU 檔案清單的 INI 檔案。
lpszEntryFormat
指向要用於登錄或應用程式 中所儲存專案名稱的格式字串。INI 檔案。
nSize
MRU 檔案清單中的檔案數目上限。
nMaxDispLen
最大長度，以字元為單位，可用於 MRU 檔案清單中的檔案名功能表顯示。
備註
lpszEntryFormat 所指向的格式字串應該包含 「%d」，用來取代每個 MRU 專案的索引。 例如，如果格式字串是 "file%d" ，則專案會命名為 file0、 file1等。
CRecentFileList：：GetDisplayName
取得 MRU 檔案清單中的檔案顯示名稱，以用於 MRU 清單的功能表顯示。
virtual BOOL GetDisplayName(
CString& strName,
int nIndex,
LPCTSTR lpszCurDir,
int nCurDir,
BOOL bAtLeastName = TRUE) const;
參數
strName
名稱要顯示在 MRU 檔案選單清單中之檔案的完整路徑。
nIndex
MRU 檔案清單中的檔案以零起始的索引。
lpszCurDir
保存目前目錄的字串。
nCurDir
目前目錄字串的長度。
bAtLeastName
如果為非零，表示應該傳回檔案的基底名稱，即使它超過最大顯示長度（傳遞為 nMaxDispLen 參數至建 CRecentFileList 構函式）。
傳回值
如果最近使用的檔案清單中沒有指定索引的檔名，則為 FALSE 。
備註
如果檔案位於目前目錄中，函式會將目錄離開顯示。 如果檔名太長，則會移除目錄和擴展名。 如果檔名仍然太長，除非 bAtLeastName 非零，否則顯示名稱會設定為空字串。
CRecentFileList：：GetSize
擷取 MRU 檔案清單中的檔案數目。
int GetSize() const;
傳回值
目前最近使用之檔案清單中的檔案數目。
CRecentFileList：：operator [ ]
多載的下標 （[]） 運算子會傳回 nIndex 中以零起始的索引所指定的單CString一 。
CString& operator[ ](int nindex);
參數
nIndex
以零為起始的 CString 索引集合中的 CString。
CRecentFileList：：ReadList
從登錄或應用程式的 讀取最近使用的 （MRU） 檔案清單。INI 檔案。
virtual void ReadList();
CRecentFileList：：Remove
從 MRU 檔案清單中移除檔案。
virtual void Remove(int nIndex);
參數
nIndex
要從最近使用之檔案清單中移除之檔案的以零起始的索引。
CRecentFileList：：UpdateMenu
更新 MRU 檔案清單的功能表顯示。
virtual void UpdateMenu(CCmdUI* pCmdUI);
參數
pCmdUI
最近使用之檔案清單功能表的 CCmdUI 物件指標。
CRecentFileList：：WriteList
將最近使用的 （MRU） 檔案清單寫入登入或應用程式的 。INI 檔案。
virtual void WriteList();