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 Devolução

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 Devolução

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

Confira também

Gráfico da hierarquia