CRecentFileList (clase)
Admite el control de lista de los archivos utilizados más recientemente (MRU).
Sintaxis
class CRecentFileList
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CRecentFileList::CRecentFileList | Construye un objeto CRecentFileList. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CRecentFileList::Add | Agrega un archivo a la lista de archivos MRU. |
| CRecentFileList::GetDisplayName | Proporciona un nombre para mostrar en la representación del menú de un nombre de archivo MRU. |
| CRecentFileList::GetSize | Recupera el número de archivos de la lista de archivos MRU. |
| CRecentFileList::ReadList | Lee la lista de archivos MRU del registro o el archivo .INI. |
| CRecentFileList::Remove | Quita un archivo de la lista de archivos MRU. |
| CRecentFileList::UpdateMenu | Actualiza la presentación del menú de la lista de archivos MRU. |
| CRecentFileList::WriteList | Escribe la lista de archivos MRU del registro o el archivo .INI. |
Operadores públicos
| Nombre | Descripción |
|---|---|
| CRecentFileList::operator [ ] | Devuelve un objeto CString situado en una posición determinada. |
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();