CRecentFileList – třída
Podporuje kontrolu nad seznamem naposledy použitých souborů (MRU).
Syntaxe
class CRecentFileList
Členové
Veřejné konstruktory
Název | Popis |
---|---|
CRecentFileList::CRecentFileList | CRecentFileList Vytvoří objekt. |
Veřejné metody
Název | Popis |
---|---|
CRecentFileList::Add | Přidá soubor do seznamu souborů MRU. |
CRecentFileList::GetDisplayName | Poskytuje zobrazovaný název pro zobrazení názvu souboru MRU. |
CRecentFileList::GetSize | Načte počet souborů v seznamu souborů MRU. |
CRecentFileList::ReadList | Přečte seznam souborů MRU z registru nebo . SOUBOR INI. |
CRecentFileList::Remove | Odebere soubor ze seznamu souborů MRU. |
CRecentFileList::UpdateMenu | Aktualizuje zobrazení nabídky seznamu souborů MRU. |
CRecentFileList::WriteList | Zapíše seznam souborů MRU z registru nebo . SOUBOR INI. |
Veřejné operátory
Název | Popis |
---|---|
CRecentFileList::operator [ ] | CString Vrátí objekt na dané pozici. |
Poznámky
Soubory lze přidat do seznamu souborů MRU nebo je z nich odstranit, ze seznamu souborů lze číst nebo zapisovat do registru nebo do souboru . Soubor INI a nabídka zobrazující seznam souborů MRU lze aktualizovat.
Hierarchie dědičnosti
CRecentFileList
Požadavky
Hlavička: afxadv.h
CRecentFileList::Add
Přidá soubor do seznamu naposledy použitých souborů (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
Určuje název cesty, který se má přidat do seznamu.
lpszAppID
Určuje ID modelu uživatele aplikace pro aplikaci.
pItem
Určuje ukazatel na položku prostředí, která se má přidat do seznamu.
pLink
Určuje ukazatel na odkaz prostředí, který se má přidat do seznamu.
pidl
Určuje IDLIST položky prostředí, která by se měla přidat do poslední složky docs.
Poznámky
Název souboru se přidá do horní části seznamu MRU. Pokud název souboru již v seznamu MRU existuje, přesune se do horní části.
CRecentFileList::CRecentFileList
CRecentFileList
Vytvoří objekt.
CRecentFileList(
UINT nStart,
LPCTSTR lpszSection,
LPCTSTR lpszEntryFormat,
int nSize,
int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);
Parametry
nStart
Posun pro číslování v zobrazení nabídky seznamu souborů MRU (naposledy použitých).
lpszSection
Odkazuje na název oddílu registru nebo aplikace . SOUBOR INI, kde je seznam souborů MRU přečtený nebo zapsaný.
lpszEntryFormat
Odkazuje na formátovací řetězec, který se má použít pro názvy položek uložených v registru nebo v aplikaci . SOUBOR INI.
NSize
Maximální počet souborů v seznamu souborů MRU.
nMaxDispLen
Maximální délka ve znaznachu, která je k dispozici pro zobrazení názvu souboru v seznamu souborů MRU.
Poznámky
Formátovací řetězec odkazující na lpszEntryFormat by měl obsahovat "%d", který se použije k nahrazení indexu každé položky MRU. Pokud je "file%d"
například formátovací řetězec, položky budou pojmenovány file0
, file1
a tak dále.
CRecentFileList::GetDisplayName
Získá zobrazovaný název souboru v seznamu souborů MRU pro použití v zobrazení nabídky seznamu MRU.
virtual BOOL GetDisplayName(
CString& strName,
int nIndex,
LPCTSTR lpszCurDir,
int nCurDir,
BOOL bAtLeastName = TRUE) const;
Parametry
strName
Úplná cesta k souboru, jehož název se má zobrazit v seznamu souborů MRU.
nIndex
Index souboru založený na nule v seznamu souborů MRU.
lpszCurDir
Řetězec držící aktuální adresář.
nCurDir
Délka aktuálního řetězce adresáře
bAtLeastName
Pokud není hodnota nenulová, znamená to, že by se měl vrátit základní název souboru, i když překročí maximální délku zobrazení (předanou jako parametr nMaxDispLen konstruktoru CRecentFileList
).
Návratová hodnota
NEPRAVDA , pokud v zadaném indexu v seznamu naposledy použitých souborů (MRU) neexistuje žádný název souboru.
Poznámky
Pokud je soubor v aktuálním adresáři, funkce opustí adresář mimo displej. Pokud je název souboru příliš dlouhý, adresář a přípona se odstraní. Pokud je název souboru stále příliš dlouhý, je zobrazovaný název nastaven na prázdný řetězec, pokud bAtLeastName není nenulový.
CRecentFileList::GetSize
Načte počet souborů v seznamu souborů MRU.
int GetSize() const;
Návratová hodnota
Počet souborů v aktuálním seznamu naposledy použitých souborů (MRU).
CRecentFileList::operator [ ]
Přetížený dolní index ([]
) vrátí jeden CString
zadaný indexem založeným na nule v nIndex.
CString& operator[ ](int nindex);
Parametry
nIndex
Index CString
založený na nule v sadě CString
s.
CRecentFileList::ReadList
Přečte seznam naposledy použitých souborů (MRU) z registru nebo aplikace . SOUBOR INI.
virtual void ReadList();
CRecentFileList::Remove
Odebere soubor ze seznamu souborů MRU.
virtual void Remove(int nIndex);
Parametry
nIndex
Index souboru založený na nule, který se má odebrat ze seznamu naposledy použitých souborů (MRU).
CRecentFileList::UpdateMenu
Aktualizuje zobrazení nabídky seznamu souborů MRU.
virtual void UpdateMenu(CCmdUI* pCmdUI);
Parametry
pCmdUI
Ukazatel na objekt CCmdUI pro naposledy použitou nabídku seznamu souborů (MRU).
CRecentFileList::WriteList
Zapíše seznam naposledy použitých souborů (MRU) do registru nebo aplikace . SOUBOR INI.
virtual void WriteList();