Класс 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
Указывает указатель на элемент оболочки, добавляемый в список.

pLink
Указывает указатель на ссылку оболочки, добавляемую в список.

pidl
Указывает IDLIST для элемента оболочки, который должен быть добавлен в последнюю папку документов.

Замечания

Имя файла будет добавлено в начало списка MRU. Если имя файла уже существует в списке MRU, оно будет перемещено в начало.

CRecentFileList::CRecentFileList

Формирует объект CRecentFileList.

CRecentFileList(
    UINT nStart,
    LPCTSTR lpszSection,
    LPCTSTR lpszEntryFormat,
    int nSize,
    int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);

Параметры

nStart
Смещение для нумеровки в меню списка файлов MRU (последнее используемое).

lpszSection
Указывает имя раздела реестра или приложения. INI-файл, в котором выполняется чтение и запись списка файлов MRU.

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 , если имя файла отсутствует в указанном индексе в списке последних использованных файлов (MRU).

Замечания

Если файл находится в текущем каталоге, функция покидает его. Если имя файла слишком длинное, каталог и расширение удаляются. Если имя файла еще слишком длинное, отображаемое имя имеет пустую строку, если bAtLeastName не является ненулевой.

CRecentFileList::GetSize

Извлекает количество файлов в списке файлов MRU.

int GetSize() const;

Возвращаемое значение

Количество файлов в текущем списке недавно использованных файлов (MRU).

CRecentFileList::operator [ ]

Перегруженный оператор подстрочного ([]) возвращает один, CString заданный отсчитываемым от нуля индексом в nIndex.

CString& operator[ ](int nindex);

Параметры

nIndex
Отсчитываемый от нуля индекс CString набора CStrings.

CRecentFileList::ReadList

Считывает последний используемый список файлов (MRU) из реестра или приложения. INI-файл.

virtual void ReadList();

CRecentFileList::Remove

Удаляет файл из списка файлов MRU.

virtual void Remove(int nIndex);

Параметры

nIndex
Отсчитываемый от нуля индекс файла, который нужно удалить из списка недавно использованных файлов (MRU).

CRecentFileList::UpdateMenu

Обновляет меню списка файлов MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Параметры

pCmdUI
Указатель на объект CCmdUI для меню списка недавно использованных файлов (MRU).

CRecentFileList::WriteList

Записывает последний используемый список файлов (MRU) в реестр или приложение. INI-файл.

virtual void WriteList();

См. также

Диаграмма иерархии