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 파일.

Public 연산자

이름	설명
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
애플리케이션에 대한 애플리케이션 사용자 모델 ID를 지정합니다.

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
레지스트리 또는 애플리케이션의 섹션 이름을 가리킵니다. MRU 파일 목록을 읽고/또는 쓰는 INI 파일입니다.

lpszEntryFormat
레지스트리 또는 애플리케이션에 저장된 항목의 이름에 사용할 형식 문자열을 가리킵니다. INI 파일.

nSize
MRU 파일 목록의 최대 파일 수입니다.

nMaxDispLen
MRU 파일 목록의 파일 이름 메뉴 표시에 사용할 수 있는 최대 길이(문자)입니다.

설명

lpszEntryFormat에서 가리키는 형식 문자열에는 각 MRU 항목의 인덱스를 대체하는 데 사용되는 "%d"가 포함되어야 합니다. 예를 들어 형식 문자열이 "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 파일 목록에 있는 파일의 인덱스(0부터 시작하는 인덱스)입니다.

lpszCurDir
현재 디렉터리를 포함하는 문자열입니다.

nCurDir
현재 디렉터리 문자열의 길이입니다.

bAtLeastName
0이 아닌 경우 파일의 기본 이름이 최대 표시 길이(생성자에 nMaxDispLen 매개 변수 CRecentFileList 로 전달됨)를 초과하는 경우에도 반환되어야 임을 나타냅니다.

Return Value

가장 최근에 사용한(MRU) 파일 목록의 지정된 인덱스에서 파일 이름이 없으면 FALSE 입니다.

설명

파일이 현재 디렉터리에 있는 경우 함수는 디렉터리를 디스플레이에서 끕니다. 파일 이름이 너무 길면 디렉터리와 확장명은 제거됩니다. 파일 이름이 너무 긴 경우 bAtLeastName이 0이 아닌 경우 표시 이름은 빈 문자열로 설정됩니다.

CRecentFileList::GetSize

MRU 파일 목록의 파일 수를 검색합니다.

int GetSize() const;

Return Value

현재 가장 최근에 사용한(MRU) 파일 목록의 파일 수입니다.

CRecentFileList::operator [ ]

오버로드된 하위 첨자([]) 연산자는 nIndex에서 0부터 시작하는 인덱스로 지정된 단일 CString 값을 반환합니다.

CString& operator[ ](int nindex);

매개 변수

nIndex
s 집합CString의 인 CString 덱스(0부터 시작하는 인덱스)입니다.

CRecentFileList::ReadList

레지스트리 또는 애플리케이션에서 가장 최근에 사용한(MRU) 파일 목록을 읽습니다. INI 파일.

virtual void ReadList();

CRecentFileList::Remove

MRU 파일 목록에서 파일을 제거합니다.

virtual void Remove(int nIndex);

매개 변수

nIndex
가장 최근에 사용한(MRU) 파일 목록에서 제거할 파일의 인덱스(0부터 시작)입니다.

CRecentFileList::UpdateMenu

MRU 파일 목록의 메뉴 표시를 업데이트.

virtual void UpdateMenu(CCmdUI* pCmdUI);

매개 변수

pCmdUI
가장 최근에 사용한(MRU) 파일 목록 메뉴의 CCmdUI 개체에 대한 포인터입니다.

CRecentFileList::WriteList

가장 최근에 사용한(MRU) 파일 목록을 레지스트리 또는 애플리케이션에 씁니다. INI 파일.

virtual void WriteList();

참고 항목

계층 구조 차트