Classe CRecentFileList

Supporta il controllo dell'elenco dei file usati di recente.

Sintassi

class CRecentFileList

Membri

Costruttori pubblici

Metodi pubblici

Operatori pubblici

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

Vedi anche

Grafico della gerarchia