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();

另請參閱

階層架構圖表