共用方式為


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" ,則專案會命名為 file0file1等。

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

另請參閱

階層架構圖表