Classe CRecentFileList
Supporta il controllo dell'elenco dei file usati di recente.
Sintassi
class CRecentFileList
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CRecentFileList::CRecentFileList | Costruisce un oggetto CRecentFileList. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CRecentFileList::Add | Aggiunge un file all'elenco di file MRU. |
| CRecentFileList::GetDisplayName | Fornisce un nome visualizzato per la visualizzazione del menu di un nome file MRU. |
| CRecentFileList::GetSize | Recupera il numero di file nell'elenco di file MRU. |
| CRecentFileList::ReadList | Legge l'elenco di file MRU dal Registro di sistema o . File INI. |
| CRecentFileList::Remove | Rimuove un file dall'elenco di file MRU. |
| CRecentFileList::UpdateMenu | Aggiorna la visualizzazione del menu dell'elenco di file MRU. |
| CRecentFileList::WriteList | Scrive l'elenco di file MRU dal Registro di sistema o . File INI. |
Operatori pubblici
| Nome | Descrizione |
|---|---|
| CRecentFileList::operator [ ] | Restituisce un CString oggetto in una determinata posizione. |
Osservazioni:
I file possono essere aggiunti o eliminati dall'elenco di file MRU, l'elenco di file può essere letto o scritto nel Registro di sistema o in un oggetto . È possibile aggiornare il file INI e il menu che visualizza l'elenco di file MRU.
Gerarchia di ereditarietà
CRecentFileList
Requisiti
Intestazione: afxadv.h
CRecentFileList::Add
Aggiunge un file all'elenco di file usati (MRU) più di recente.
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);
Parametri
lpszPathName
Specifica pathname da aggiungere all'elenco.
lpszAppID
Specifica l'ID modello utente applicazione per l'applicazione.
pItem
Specifica un puntatore all'elemento della shell da aggiungere all'elenco.
pLink
Specifica un puntatore a Collegamento shell da aggiungere all'elenco.
pidl
Specifica l'IDLIST per l'elemento della shell che deve essere aggiunto alla cartella docs recente.
Osservazioni:
Il nome del file verrà aggiunto all'inizio dell'elenco MRU. Se il nome file esiste già nell'elenco MRU, verrà spostato nella parte superiore.
CRecentFileList::CRecentFileList
Costruisce un oggetto CRecentFileList.
CRecentFileList(
UINT nStart,
LPCTSTR lpszSection,
LPCTSTR lpszEntryFormat,
int nSize,
int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);
Parametri
nStart
Offset per la numerazione nella visualizzazione del menu dell'elenco di file MRU (usato più di recente).
lpszSection
Punta al nome della sezione del Registro di sistema o dell'applicazione. File INI in cui l'elenco di file MRU è letto e/o scritto.
lpszEntryFormat
Punta a una stringa di formato da usare per i nomi delle voci archiviate nel Registro di sistema o nell'applicazione. File INI.
nSize
Numero massimo di file nell'elenco di file MRU.
nMaxDispLen
Lunghezza massima, in caratteri, disponibile per la visualizzazione del menu di un nome file nell'elenco di file MRU.
Osservazioni:
La stringa di formato a cui punta lpszEntryFormat deve contenere "%d", che verrà usata per sostituire l'indice di ogni elemento MRU. Ad esempio, se la stringa di formato è "file%d" , le voci verranno denominate file0, file1e così via.
CRecentFileList::GetDisplayName
Ottiene un nome visualizzato per un file nell'elenco dei file MRU, da utilizzare nella visualizzazione dei menu dell'elenco MRU.
virtual BOOL GetDisplayName(
CString& strName,
int nIndex,
LPCTSTR lpszCurDir,
int nCurDir,
BOOL bAtLeastName = TRUE) const;
Parametri
strName
Percorso completo del file il cui nome deve essere visualizzato nell'elenco di menu dei file MRU.
nIndex
Indice in base zero del file nell'elenco di file MRU.
lpszCurDir
Stringa contenente la directory corrente.
nCurDir
Lunghezza della stringa di directory corrente.
bAtLeastName
Se diverso da zero, indica che il nome di base del file deve essere restituito, anche se supera la lunghezza massima di visualizzazione (passata come parametro nMaxDispLen al CRecentFileList costruttore).
Valore restituito
FALSE se non è presente alcun nome file in corrispondenza dell'indice specificato nell'elenco dei file usati più di recente.
Osservazioni:
Se il file si trova nella directory corrente, la funzione lascia la directory fuori dalla visualizzazione. Se il nome file è troppo lungo, la directory e l'estensione vengono rimosse. Se il nome file è ancora troppo lungo, il nome visualizzato viene impostato su una stringa vuota a meno che bAtLeastName non sia diverso da zero.
CRecentFileList::GetSize
Recupera il numero di file nell'elenco di file MRU.
int GetSize() const;
Valore restituito
Numero di file nell'elenco dei file usati più di recente .
CRecentFileList::operator [ ]
L'operatore di indice di overload ([]) restituisce un singolo CString specificato dall'indice in base zero in nIndex.
CString& operator[ ](int nindex);
Parametri
nIndex
Indice in base zero di un CString oggetto in un set di CString.
CRecentFileList::ReadList
Legge l'elenco di file usati più di recente (MRU) dal Registro di sistema o dall'applicazione. File INI.
virtual void ReadList();
CRecentFileList::Remove
Rimuove un file dall'elenco di file MRU.
virtual void Remove(int nIndex);
Parametri
nIndex
Indice in base zero del file da rimuovere dall'elenco dei file usati più di recente.
CRecentFileList::UpdateMenu
Aggiorna la visualizzazione del menu dell'elenco di file MRU.
virtual void UpdateMenu(CCmdUI* pCmdUI);
Parametri
pCmdUI
Puntatore all'oggetto CCmdUI per il menu di elenco dei file usati più di recente.
CRecentFileList::WriteList
Scrive l'elenco di file usati più di recente (MRU) nel Registro di sistema o nell'applicazione. File INI.
virtual void WriteList();