Klasa CRecentFileList

Obsługuje kontrolę nad ostatnio używaną listą plików (MRU).

Składnia

class CRecentFileList

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CRecentFileList::CRecentFileList	CRecentFileList Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CRecentFileList::Add	Dodaje plik do listy plików MRU.
CRecentFileList::GetDisplayName	Zawiera nazwę wyświetlaną dla menu wyświetlania nazwy pliku MRU.
CRecentFileList::GetSize	Pobiera liczbę plików na liście plików MRU.
CRecentFileList::ReadList	Odczytuje listę plików MRU z rejestru lub . Plik INI.
CRecentFileList::Remove	Usuwa plik z listy plików MRU.
CRecentFileList::UpdateMenu	Aktualizuje wyświetlanie menu listy plików MRU.
CRecentFileList::WriteList	Zapisuje listę plików MRU z rejestru lub . Plik INI.

Operatory publiczne

Nazwa/nazwisko	opis
CRecentFileList::operator [ ]	CString Zwraca obiekt na danej pozycji.

Uwagi

Pliki można dodawać lub usuwać z listy plików MRU. Lista plików może być odczytywana lub zapisywana w rejestrze lub . Plik INI i menu z wyświetloną listą plików MRU można zaktualizować.

Hierarchia dziedziczenia

CRecentFileList

Wymagania

Nagłówek: afxadv.h

CRecentFileList::Add

Dodaje plik do listy ostatnio używanych plików (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);

Parametry

lpszPathName
Określa nazwę ścieżki do dodania do listy.

lpszAppID
Określa identyfikator modelu użytkownika aplikacji dla aplikacji.

pItem
Określa wskaźnik do elementu powłoki, który ma zostać dodany do listy.

Plink
Określa wskaźnik do linku powłoki, który ma zostać dodany do listy.

pidl
Określa identyfikator IDLIST elementu powłoki, który powinien zostać dodany do ostatniego folderu dokumentacji.

Uwagi

Nazwa pliku zostanie dodana na początku listy MRU. Jeśli nazwa pliku już istnieje na liście MRU, zostanie przeniesiona na górę.

CRecentFileList::CRecentFileList

CRecentFileList Tworzy obiekt.

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

Parametry

nStart
Przesunięcie numerowania w menu wyświetlanym na liście plików MRU (ostatnio używanych).

lpszSection
Wskazuje nazwę sekcji rejestru lub aplikacji . Plik INI, w którym lista plików MRU jest odczytywana i/lub zapisywana.

lpszEntryFormat
Wskazuje ciąg formatu, który ma być używany dla nazw wpisów przechowywanych w rejestrze lub aplikacji . Plik INI.

nSize
Maksymalna liczba plików na liście plików MRU.

nMaxDispLen
Maksymalna długość, w znakach, dostępna dla menu wyświetlania nazwy pliku na liście plików MRU.

Uwagi

Ciąg formatu wskazywany przez element lpszEntryFormat powinien zawierać ciąg "%d", który będzie używany do zastępowania indeksu każdego elementu MRU. Jeśli na przykład ciąg formatu to "file%d" wpisy będą mieć nazwę file0, file1itd.

CRecentFileList::GetDisplayName

Uzyskuje nazwę wyświetlaną pliku na liście plików MRU do użycia w menu listy MRU.

virtual BOOL GetDisplayName(
    CString& strName,
    int nIndex,
    LPCTSTR lpszCurDir,
    int nCurDir,
    BOOL bAtLeastName = TRUE) const;

Parametry

strName
Pełna ścieżka pliku, którego nazwa ma być wyświetlana na liście menu plików MRU.

nIndex
Zerowy indeks pliku na liście plików MRU.

lpszCurDir
Ciąg zawierający bieżący katalog.

nCurDir
Długość bieżącego ciągu katalogu.

bAtLeastName
Jeśli niezerowa, wskazuje, że powinna zostać zwrócona podstawowa nazwa pliku, nawet jeśli przekracza maksymalną długość wyświetlania (przekazana jako parametr nMaxDispLen do konstruktora CRecentFileList ).

Wartość zwracana

FALSE , jeśli nie ma nazwy pliku w określonym indeksie na liście plików ostatnio używanych (MRU).

Uwagi

Jeśli plik znajduje się w bieżącym katalogu, funkcja opuszcza katalog poza wyświetlaniem. Jeśli nazwa pliku jest za długa, katalog i rozszerzenie zostaną usunięte. Jeśli nazwa pliku jest nadal za długa, nazwa wyświetlana jest ustawiona na pusty ciąg, chyba że nazwa bAtLeastName jest niezerowa.

CRecentFileList::GetSize

Pobiera liczbę plików na liście plików MRU.

int GetSize() const;

Wartość zwracana

Liczba plików na bieżącej liście plików ostatnio używanych (MRU).

CRecentFileList::operator [ ]

Przeciążony operator indeksu dolnego ([]) zwraca jeden określony CString przez indeks zerowy w nIndex.

CString& operator[ ](int nindex);

Parametry

nIndex
Indeks CString oparty na wartości zerowej CStringw zestawie s.

CRecentFileList::ReadList

Odczytuje listę ostatnio używanych plików (MRU) z rejestru lub aplikacji . Plik INI.

virtual void ReadList();

CRecentFileList::Remove

Usuwa plik z listy plików MRU.

virtual void Remove(int nIndex);

Parametry

nIndex
Zerowy indeks pliku, który ma zostać usunięty z listy ostatnio używanych plików (MRU).

CRecentFileList::UpdateMenu

Aktualizuje wyświetlanie menu listy plików MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Parametry

pCmdUI
Wskaźnik do obiektu CCmdUI dla ostatnio używanego menu listy plików (MRU).

CRecentFileList::WriteList

Zapisuje listę plików ostatnio używanych (MRU) do rejestru lub aplikacji . Plik INI.

virtual void WriteList();

Zobacz też

Wykres hierarchii