CRecentFileList (clase)

Admite el control de lista de los archivos utilizados más recientemente (MRU).

Sintaxis

class CRecentFileList

Miembros

Constructores públicos

Métodos públicos

Operadores públicos

Comentarios

Los archivos se pueden agregar o eliminar en la lista de archivos MRU, la lista de archivos se puede leer o escribir en el registro o un archivo .INI, y el menú que muestra la lista de archivos MRU se puede actualizar.

Jerarquía de herencia

CRecentFileList

Requisitos

Encabezado: afxadv.h

CRecentFileList::Add

Agrega un archivo a la lista de los archivos usados más recientemente (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);

Parámetros

lpszPathName
Especifica el nombre de la ruta de acceso que se va a agregar a la lista.

lpszAppID
Especifica el id. de modelo de usuario de aplicación de la aplicación.

pItem
Especifica un puntero al elemento de shell que se va a agregar a la lista.

pLink
Especifica un puntero al vínculo de shell que se va a agregar a la lista.

pidl
Especifica el valor IDLIST del elemento de shell que se debe agregar a la carpeta de documentos recientes.

Comentarios

El nombre de archivo se agrega en la parte superior de la lista MRU. Si el nombre de archivo ya existe en la lista MRU, se mueve a la parte superior.

CRecentFileList::CRecentFileList

Construye un objeto CRecentFileList.

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

Parámetros

nStart
Desplazamiento para la numeración en la presentación del menú de la lista de archivos MRU (usados más recientemente).

lpszSection
Apunta al nombre de la sección del registro o el archivo .INI de la aplicación donde se lee o escribe la lista de archivos MRU.

lpszEntryFormat
Apunta a una cadena de formato que se va a usar para los nombres de las entradas almacenadas en el registro o el archivo .INI de la aplicación.

nSize
Número máximo de archivos de la lista de archivos MRU.

nMaxDispLen
Longitud máxima, en caracteres, disponible para la presentación del menú de un nombre de archivo en la lista de archivos MRU.

Comentarios

La cadena de formato a la que apunta lpszEntryFormat debe contener "%d", que se usa para sustituir el índice de cada elemento MRU. Por ejemplo, si la cadena de formato es "file%d", las entradas tienen el nombre file0, file1, etc.

CRecentFileList::GetDisplayName

Obtiene un nombre para mostrar de un archivo de la lista de archivos MRU para su uso en la presentación del menú de la lista MRU.

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

Parámetros

strName
Ruta de acceso completa del archivo cuyo nombre se va a mostrar en la lista de menús de archivos MRU.

nIndex
Índice basado en cero del archivo en la lista de archivos MRU.

lpszCurDir
Cadena que contiene el directorio actual.

nCurDir
Longitud de la cadena de directorio actual.

bAtLeastName
Si es distinto de cero, indica que se debe devolver el nombre base del archivo, aunque supere la longitud máxima de presentación (se pasa como el parámetro nMaxDispLen al constructor CRecentFileList).

Valor devuelto

FALSE si no hay ningún nombre de archivo en el índice especificado en la lista de archivos usados más recientemente (MRU).

Comentarios

Si el archivo está en el directorio actual, la función deja al directorio fuera de la pantalla. Si el nombre de archivo es demasiado largo, el directorio y la extensión se quitan. Si el nombre de archivo sigue siendo demasiado largo, el nombre para mostrar se establece en una cadena vacía a menos que bAtLeastName sea distinto de cero.

CRecentFileList::GetSize

Recupera el número de archivos de la lista de archivos MRU.

int GetSize() const;

Valor devuelto

Número de archivos de la lista de archivos usados más recientemente (MRU).

CRecentFileList::operator [ ]

El operador de subíndice sobrecargado ([]) devuelve un solo elemento CString especificado por el índice basado en cero de nIndex.

CString& operator[ ](int nindex);

Parámetros

nIndex
Índice basado en cero de CString en un conjunto de CString.

CRecentFileList::ReadList

Lee la lista de archivos usados más recientemente (MRU) del registro o el archivo .INI de la aplicación.

virtual void ReadList();

CRecentFileList::Remove

Quita un archivo de la lista de archivos MRU.

virtual void Remove(int nIndex);

Parámetros

nIndex
Índice basado en cero del archivo que se va a quitar de la lista de archivos usados más recientemente (MRU).

CRecentFileList::UpdateMenu

Actualiza la presentación del menú de la lista de archivos MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Parámetros

pCmdUI
Puntero al objeto CCmdUI del menú de la lista de archivos usados más recientemente (MRU).

CRecentFileList::WriteList

Escribe la lista de archivos usados más recientemente (MRU) en el registro o el archivo .INI de la aplicación.

virtual void WriteList();

Consulte también

Gráfico de jerarquías