Classe CRecentFileList

Suporta o controlo da lista de ficheiros mais recentemente usada (MRU).

Sintaxe

class CRecentFileList

Membros

Construtores Públicos

Métodos Públicos

Operadores Públicos

Observações

Os ficheiros podem ser adicionados ou eliminados da lista de ficheiros MRU, a lista pode ser lida ou escrita no registo ou num arquivo . INI, e o menu que mostra a lista de ficheiros MRU podem ser atualizados.

Hierarquia de herança

CRecentFileList

Requerimentos

Cabeçalho: afxadv.h

CRecentFileList::Add

Adiciona um ficheiro à lista de ficheiros mais recentemente usada (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 o nome do caminho a ser adicionado à lista.

lpszAppID
Especifica o ID do Modelo de Utilizador da Aplicação para a aplicação.

pItem
Especifica um apontador para o Item Shell a ser adicionado à lista.

pLink
Especifica um ponteiro para o Shell Link a ser adicionado à lista.

pidl
Especifica a IDLIST para o item shell que deve ser adicionado à pasta docs recente.

Observações

O nome do ficheiro será adicionado ao topo da lista da MRU. Se o nome do ficheiro já existir na lista MRU, será movido para o topo.

CRecentFileList::CRecentFileList

Constrói um CRecentFileList objeto.

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

Parâmetros

nStart
Deslocamento para a numeração no menu da lista de ficheiros MRU (mais recentemente utilizada).

Secção lpsz
Aponta para o nome da secção do registo ou para a aplicação . INI onde a lista de ficheiros MRU é lida e/ou escrita.

lpszEntryFormat
Aponta para uma cadeia de formatos a ser usada para os nomes das entradas armazenadas no registo ou na aplicação . Ficheiro INI.

nTamanho
Número máximo de ficheiros na lista de ficheiros MRU.

nMaxDispLen
Comprimento máximo, em caracteres, disponível para a visualização de um nome de ficheiro no menu na lista de ficheiros MRU.

Observações

A cadeia de formato apontada por lpszEntryFormat deve conter "%d", que será usada para substituir o índice de cada item da MRU. Por exemplo, se a string de formato for "file%d" então as entradas serão chamadas file0, file1, e assim sucessivamente.

CRecentFileList::GetDisplayName

Obtém um nome de exibição para um ficheiro na lista de ficheiros MRU, para uso no menu de visualização da lista MRU.

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

Parâmetros

strName
O percurso completo do ficheiro cujo nome deve ser apresentado na lista de menu dos ficheiros MRU.

nIndex
Índice base zero do ficheiro na lista de ficheiros MRU.

lpszCurDir
String que contém o diretório atual.

nCurDir
Comprimento da cadeia de diretórios atual.

bPelo MenosNome
Se não nulo, indica que o nome base do ficheiro deve ser devolvido, mesmo que exceda o comprimento máximo de exibição (passado como parâmetro nMaxDispLen ao CRecentFileList construtor).

Valor de retorno

FALSE se não houver nome de ficheiro no índice especificado na lista de ficheiros mais recentemente usada (MRU).

Observações

Se o ficheiro estiver no diretório atual, a função deixa o diretório fora do ecrã. Se o nome do ficheiro for demasiado longo, o diretório e a extensão são removidos. Se o nome do ficheiro continuar demasiado longo, o nome de exibição é definido para uma string vazia, a menos que bAtLeastName não seja zero.

CRecentFileList::GetSize

Recupera o número de ficheiros na lista de ficheiros MRU.

int GetSize() const;

Valor de retorno

O número de ficheiros na lista de ficheiros mais recentemente usada (MRU).

CRecentFileList::operator [ ]

O operador subíndice sobrecarregado ([]) devolve um único CString especificado pelo índice baseado em zero em nIndex.

CString& operator[ ](int nindex);

Parâmetros

nIndex
Índice de base zero de a CString num conjunto de CStrings.

CRecentFileList::ReadList

Lê a lista de ficheiros mais recentemente usada (MRU) do registo ou da aplicação . Ficheiro INI.

virtual void ReadList();

CRecentFileList::Remover

Remove um ficheiro da lista de ficheiros da MRU.

virtual void Remove(int nIndex);

Parâmetros

nIndex
Índice baseado em zero do ficheiro a ser removido da lista de ficheiros mais recentemente utilizada (MRU).

CRecentFileList::MenuUpdateT

Atualiza a visualização do menu da lista de ficheiros MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Parâmetros

pCmdUI
Um apontador para o objeto CCmdUI para o menu de lista de ficheiros mais recentemente usado (MRU).

CRecentFileList::WriteList

Grava a lista de ficheiros mais recentemente usada (MRU) no registo ou na aplicação . Ficheiro INI.

virtual void WriteList();

Consulte também

Gráfico de Hierarquia