Classe CRecentFileList
Dá suporte ao controle da lista de arquivos MRU (usados mais recentemente).
Sintaxe
class CRecentFileList
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CRecentFileList::CRecentFileList | Constrói um objeto CRecentFileList. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CRecentFileList::Add | Adiciona um arquivo à lista de arquivos MRU. |
| CRecentFileList::GetDisplayName | Fornece um nome de exibição para a exibição de menu de um nome de arquivo MRU. |
| CRecentFileList::GetSize | Recupera o número de arquivos na lista de arquivos MRU. |
| CRecentFileList::ReadList | Lê a lista de arquivos MRU do registro ou do arquivo .INI. |
| CRecentFileList::Remove | Remove um arquivo da lista de arquivos MRU. |
| CRecentFileList::UpdateMenu | Atualiza a exibição de menu da lista de arquivos MRU. |
| CRecentFileList::WriteList | Grava a lista de arquivos MRU no registro ou no arquivo .INI. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CRecentFileList::operator [ ] | Retorna um objeto CString em uma determinada posição. |
Comentários
Os arquivos podem ser adicionados ou excluídos da lista de arquivos MRU, a lista de arquivos pode ser lida ou gravada no registro ou em um arquivo .INI e o menu que exibe a lista de arquivos MRU pode ser atualizado.
Hierarquia de herança
CRecentFileList
Requisitos
Cabeçalho: afxadv.h
CRecentFileList::Add
Adiciona um arquivo à lista de arquivos MRU (usados mais recentemente).
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 o nome do caminho a ser adicionado à lista.
lpszAppID
Especifica a ID do Modelo de Usuário do Aplicativo para o aplicativo.
pItem
Especifica um ponteiro para o Item do Shell a ser adicionado à lista.
pLink
Especifica um ponteiro para o Link do Shell a ser adicionado à lista.
pidl
Especifica a IDLIST para o item do Shell que deve ser adicionado à pasta de documentos recentes.
Comentários
O nome do arquivo será adicionado à parte superior da lista MRU. Se o nome do arquivo já existir na lista MRU, ele será movido para a parte superior.
CRecentFileList::CRecentFileList
Constrói um objeto CRecentFileList.
CRecentFileList(
UINT nStart,
LPCTSTR lpszSection,
LPCTSTR lpszEntryFormat,
int nSize,
int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);
Parâmetros
nStart
Deslocamento para a numeração na exibição de menu da lista de arquivos MRU (usados mais recentemente).
lpszSection
Aponta para o nome da seção do registro ou o arquivo .INI do aplicativo no qual a lista de arquivos MRU é lida e/ou gravada.
lpszEntryFormat
Aponta para uma cadeia de caracteres de formato a ser usada para os nomes das entradas armazenadas no registro ou no arquivo .INI do aplicativo.
nSize
Número máximo de arquivos na lista de arquivos MRU.
nMaxDispLen
Comprimento máximo, em caracteres, disponível para a exibição de menu de um nome de arquivo na lista de arquivos MRU.
Comentários
A cadeia de caracteres de formato apontada por lpszEntryFormat deve conter "%d", que será usado para substituir o índice de cada item do MRU. Por exemplo, se a cadeia de caracteres de formato for "file%d", então as entradas serão chamadas file0, file1 e assim por diante.
CRecentFileList::GetDisplayName
Obtém um nome de exibição para um arquivo na lista de arquivos MRU para uso na exibição de menu da lista MRU.
virtual BOOL GetDisplayName(
CString& strName,
int nIndex,
LPCTSTR lpszCurDir,
int nCurDir,
BOOL bAtLeastName = TRUE) const;
Parâmetros
strName
Caminho completo do arquivo cujo nome deve ser exibido na lista de menus de arquivos MRU.
nIndex
Índice baseado em zero do arquivo na lista de arquivos MRU.
lpszCurDir
Cadeia de caracteres que contém o diretório atual.
nCurDir
Comprimento da cadeia de caracteres do diretório atual.
bAtLeastName
Se for diferente zero, indica que o nome base do arquivo deve ser retornado, mesmo que ele exceda o comprimento máximo de exibição (passado como o parâmetro nMaxDispLen para o construtor CRecentFileList).
Valor de retorno
FALSE se não houver nenhum nome de arquivo no índice especificado na lista de arquivos MRU (usados mais recentemente).
Comentários
Se o arquivo estiver no diretório atual, a função deixará o diretório fora da exibição. Se o nome do arquivo for muito longo, o diretório e a extensão serão removidos. Se o nome do arquivo ainda continuar muito longo, o nome de exibição será definido como uma cadeia de caracteres vazia, a menos que bAtLeastName seja diferente de zero.
CRecentFileList::GetSize
Recupera o número de arquivos na lista de arquivos MRU.
int GetSize() const;
Valor de retorno
O número de arquivos na lista de arquivos MRU (usados mais recentemente) atual.
CRecentFileList::operator [ ]
O operador subscrito sobrecarregado ([]) retorna um único CString especificado pelo índice baseado em zero em nIndex.
CString& operator[ ](int nindex);
Parâmetros
nIndex
Índice baseado em zero de um CString em um conjunto de CStrings.
CRecentFileList::ReadList
Lê a lista de arquivos MRU (usados mais recentemente) do registro ou do arquivo .INI do aplicativo.
virtual void ReadList();
CRecentFileList::Remove
Remove um arquivo da lista de arquivos MRU.
virtual void Remove(int nIndex);
Parâmetros
nIndex
Índice baseado em zero do arquivo a ser removido da lista de arquivos MRU (usados mais recentemente).
CRecentFileList::UpdateMenu
Atualiza a exibição de menu da lista de arquivos MRU.
virtual void UpdateMenu(CCmdUI* pCmdUI);
Parâmetros
pCmdUI
Um ponteiro para o objeto CCmdUI para o menu da lista de arquivos MRU (usados mais recentemente).
CRecentFileList::WriteList
Grava a lista de arquivos MRU (usados mais recentemente) no registro ou no arquivo .INI do aplicativo.
virtual void WriteList();