CRecentFileList, classe

Prend en charge le contrôle de la liste des derniers fichiers utilisés (MRU).

Syntaxe

class CRecentFileList

Membres

Constructeurs publics

Nom	Description
CRecentFileList ::CRecentFileList	Construit un objet CRecentFileList.

Méthodes publiques

Nom	Description
CRecentFileList ::Add	Ajoute un fichier à la liste des fichiers MRU.
CRecentFileList ::GetDisplayName	Fournit un nom d’affichage pour l’affichage de menu d’un nom de fichier MRU.
CRecentFileList ::GetSize	Récupère le nombre de fichiers dans la liste des fichiers MRU.
CRecentFileList ::ReadList	Lit la liste des fichiers MRU à partir du Registre ou . Fichier INI.
CRecentFileList ::Remove	Supprime un fichier de la liste des fichiers MRU.
CRecentFileList ::UpdateMenu	Met à jour l’affichage du menu de la liste des fichiers MRU.
CRecentFileList ::WriteList	Écrit la liste des fichiers MRU à partir du Registre ou . Fichier INI.

Opérateurs publics

Nom	Description
CRecentFileList ::operator [ ]	Retourne un CString objet à une position donnée.

Notes

Les fichiers peuvent être ajoutés ou supprimés de la liste de fichiers MRU, la liste de fichiers peut être lue ou écrite dans le Registre ou dans un . Le fichier INI et le menu affichant la liste des fichiers MRU peuvent être mis à jour.

Hiérarchie d'héritage

CRecentFileList

Spécifications

En-tête : afxadv.h

CRecentFileList ::Add

Ajoute un fichier à la liste des fichiers les plus récemment utilisés (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);

Paramètres

lpszPathName
Spécifie le chemin d’accès à ajouter à la liste.

lpszAppID
Spécifie l’ID de modèle utilisateur de l’application.

pItem
Spécifie un pointeur vers l’élément shell à ajouter à la liste.

Plink
Spécifie un pointeur vers shell Link à ajouter à la liste.

pidl
Spécifie l’IDLIST de l’élément shell qui doit être ajouté au dossier docs récent.

Notes

Le nom de fichier est ajouté en haut de la liste mrU. Si le nom de fichier existe déjà dans la liste mrU, il est déplacé vers le haut.

CRecentFileList ::CRecentFileList

Construit un objet CRecentFileList.

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

Paramètres

nStart
Décalage de la numérotation dans l’affichage du menu de la liste de fichiers MRU (la plus récemment utilisée).

lpszSection
Pointe vers le nom de la section du Registre ou de l’application. Fichier INI dans lequel la liste de fichiers MRU est lue et/ou écrite.

lpszEntryFormat
Pointe vers une chaîne de format à utiliser pour les noms des entrées stockées dans le Registre ou dans l’application. Fichier INI.

nSize
Nombre maximal de fichiers dans la liste des fichiers MRU.

nMaxDispLen
Longueur maximale, en caractères, disponible pour l’affichage de menu d’un nom de fichier dans la liste de fichiers MRU.

Notes

La chaîne de format pointée par lpszEntryFormat doit contenir « %d », qui sera utilisée pour remplacer l’index de chaque élément MRU. Par exemple, si la chaîne de format est "file%d" alors que les entrées sont nommées file0, file1et ainsi de suite.

CRecentFileList ::GetDisplayName

Obtient un nom d’affichage pour un fichier dans la liste de fichiers MRU, à utiliser dans l’affichage de menu de la liste DESU.

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

Paramètres

strName
Chemin complet du fichier dont le nom doit être affiché dans la liste de menus des fichiers MRU.

nIndex
Index de base zéro du fichier dans la liste des fichiers MRU.

lpszCurDir
Chaîne contenant le répertoire actif.

nCurDir
Longueur de la chaîne de répertoire active.

bAtLeastName
S’il n’est pas différent de zéro, indique que le nom de base du fichier doit être retourné, même s’il dépasse la longueur d’affichage maximale (passée en tant que paramètre nMaxDispLen au CRecentFileList constructeur).

Valeur de retour

FALSE s’il n’existe aucun nom de fichier à l’index spécifié dans la liste de fichiers (MRU) la plus récente.

Notes

Si le fichier se trouve dans le répertoire actif, la fonction quitte le répertoire de l’affichage. Si le nom de fichier est trop long, le répertoire et l’extension sont supprimés. Si le nom de fichier est encore trop long, le nom d’affichage est défini sur une chaîne vide, sauf si bAtLeastName n’est pas différent de zéro.

CRecentFileList ::GetSize

Récupère le nombre de fichiers dans la liste des fichiers MRU.

int GetSize() const;

Valeur de retour

Nombre de fichiers dans la liste des fichiers les plus récemment utilisés (MRU).

CRecentFileList ::operator [ ]

L’opérateur d’indice[] surchargé () retourne une valeur spécifiée CString par l’index de base zéro dans nIndex.

CString& operator[ ](int nindex);

Paramètres

nIndex
Index de base zéro d’un CString ensemble de CStrings.

CRecentFileList ::ReadList

Lit la liste des fichiers les plus récemment utilisés (MRU) à partir du Registre ou de l’application. Fichier INI.

virtual void ReadList();

CRecentFileList ::Remove

Supprime un fichier de la liste des fichiers MRU.

virtual void Remove(int nIndex);

Paramètres

nIndex
Index de base zéro du fichier à supprimer de la liste de fichiers (MRU) la plus récente.

CRecentFileList ::UpdateMenu

Met à jour l’affichage du menu de la liste des fichiers MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Paramètres

pCmdUI
Pointeur vers l’objet CCmdUI pour le menu de liste de fichiers (MRU) le plus récemment utilisé.

CRecentFileList ::WriteList

Écrit la liste des fichiers les plus récemment utilisés (MRU) dans le Registre ou dans le registre de l’application. Fichier INI.

virtual void WriteList();

Voir aussi

Graphique hiérarchique