CRecentFileList osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja a legutóbb használt (MRU) fájllista vezérlését.

Szemantika

class CRecentFileList

Tagok

Nyilvános konstruktorok

Név Description
CRecentFileList::CRecentFileList Egy CRecentFileList objektumot hoz létre.

Nyilvános metódusok

Név Description
CRecentFileList::Add Hozzáad egy fájlt az MRU-fájllistához.
CRecentFileList::GetDisplayName Megjeleníti az MRU-fájlnév menübeli megjelenítésének nevét.
CRecentFileList::GetSize Lekéri a fájlok számát az MRU-fájllistában.
CRecentFileList::ReadList Beolvassa az MRU-fájllistát a beállításjegyzékből vagy a . INI-fájl.
CRecentFileList::Remove Eltávolít egy fájlt az MRU-fájllistából.
CRecentFileList::UpdateMenu Frissíti az MRU-fájllista menükijelenítését.
CRecentFileList::WriteList Az MRU-fájllistát a beállításjegyzékből vagy a . INI-fájl.

Nyilvános operátorok

Név Description
CRecentFileList::operátor [ ] CString Egy adott pozícióban lévő objektumot ad vissza.

Megjegyzések

A fájlok hozzáadhatók vagy törölhetők az MRU fájllistájából, a fájllista beolvasható vagy beírható a beállításjegyzékbe vagy egy adatbázisba. AZ INI-fájl és az MRU-fájllistát megjelenítő menü frissíthető.

Öröklési hierarchia

CRecentFileList

Requirements

Fejléc: afxadv.h

CRecentFileList::Add

Hozzáad egy fájlt a legutóbb használt (MRU) fájllistához.

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

Paraméterek

lpszPathName
Megadja a listához hozzáadni kívánt elérési utat.

lpszAppID
Az alkalmazás felhasználói modellazonosítóját adja meg.

pItem
A listához hozzáadni kívánt Shell-elem mutatója.

pLink
A listához hozzáadni kívánt Shell-hivatkozásra mutató mutatót ad meg.

pidl
Megadja annak a rendszerhéjelemnek az IDLIST-azonosítóját, amelyet hozzá kell adni a legutóbbi dokumentummappához.

Megjegyzések

A fájlnév hozzá lesz adva az MRU-lista elejéhez. Ha a fájlnév már létezik az MRU-listában, a rendszer a lap tetejére helyezi.

CRecentFileList::CRecentFileList

Egy CRecentFileList objektumot hoz létre.

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

Paraméterek

nStart
Az MRU (legutóbb használt) fájllista menübeli számozásának eltolása.

lpszSection
A beállításjegyzék vagy az alkalmazás szakaszának nevére mutat. INI-fájl, amelyben az MRU-fájllista olvasható és/vagy írható.

lpszEntryFormat
A beállításjegyzékben vagy az alkalmazásban tárolt bejegyzések nevére használandó formátumsztringre mutat. INI-fájl.

nSize
Az MRU-fájllistában szereplő fájlok maximális száma.

nMaxDispLen
A fájlnév mrU-fájllistában való megjelenítéséhez elérhető maximális hossz karakterben.

Megjegyzések

Az lpszEntryFormat által mutatott formázási sztringnek tartalmaznia kell a "%d" értéket, amelyet az egyes MRU-elemek indexének helyettesítésére használunk. Ha például a formátumsztring az, "file%d" akkor a bejegyzéseket elnevezi file0, file1és így tovább.

CRecentFileList::GetDisplayName

Beolvas egy fájl megjelenítendő nevét az MRU-fájllistában az MRU-lista menükijelenítésében való használatra.

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

Paraméterek

strName
Annak a fájlnak a teljes elérési útja, amelynek a neve megjelenik az MRU-fájlok menülistájában.

nIndex
A fájl nulla alapú indexe az MRU-fájllistában.

lpszCurDir
Az aktuális könyvtárat tartalmazó karakterlánc.

nCurDir
Az aktuális könyvtársztring hossza.

bAtLeastName
Ha nem, akkor a fájl alapnevét kell visszaadni, még akkor is, ha az meghaladja a maximális megjelenítési hosszt ( nMaxDispLen paraméterként átadva a CRecentFileList konstruktornak).

Visszaadott érték

HAMIS , ha a legutóbb használt (MRU) fájllistában nincs fájlnév a megadott indexben.

Megjegyzések

Ha a fájl az aktuális könyvtárban található, a függvény nem jeleníti meg a könyvtárat. Ha a fájlnév túl hosszú, a könyvtár és a bővítmény elveszik. Ha a fájlnév még mindig túl hosszú, a megjelenítendő név üres sztringre van állítva, kivéve, ha a bAtLeastName nem.

CRecentFileList::GetSize

Lekéri a fájlok számát az MRU-fájllistában.

int GetSize() const;

Visszaadott érték

A legutóbb használt (MRU) fájllistában szereplő fájlok száma.

CRecentFileList::operátor [ ]

A túlterhelt alsó index ([]) operátor egyetlen CString értéket ad vissza, amelyet az nIndex nulla alapú indexe határoz meg.

CString& operator[ ](int nindex);

Paraméterek

nIndex
Egy s-halmaz nullaalapú indexe CStringCString.

CRecentFileList::ReadList

Beolvassa a legutóbb használt (MRU) fájllistát a beállításjegyzékből vagy az alkalmazásból. INI-fájl.

virtual void ReadList();

CRecentFileList::Remove

Eltávolít egy fájlt az MRU-fájllistából.

virtual void Remove(int nIndex);

Paraméterek

nIndex
A legutóbb használt (MRU) fájllistából eltávolítandó fájl nulla alapú indexe.

CRecentFileList::UpdateMenu

Frissíti az MRU-fájllista menükijelenítését.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Paraméterek

pCmdUI
A legutóbb használt (MRU) fájllista menü CCmdUI-objektumára mutató mutató.

CRecentFileList::WriteList

A legutóbb használt (MRU) fájllistát beírja a beállításjegyzékbe vagy az alkalmazásba. INI-fájl.

virtual void WriteList();

Lásd még

hierarchiadiagram