Compartilhar via


Classe de CObList

O oferece suporte ordenaram listas de ponteiros nonunique de CObject acessíveis em seqüência ou pelo valor de ponteiro.

class CObList : public CObject

Membros

425sx0t2.collapse_all(pt-br,VS.110).gifConstrutores public

Nome

Descrição

CObList::CObList

Constrói uma lista vazia para ponteiros de CObject .

425sx0t2.collapse_all(pt-br,VS.110).gifMétodos públicos

Nome

Descrição

CObList::AddHead

Adiciona elemento (ou todos os elementos em outros lista) no início da lista (faz um novo o início.)

CObList::AddTail

Adiciona elemento (ou todos os elementos em outros lista) ao final da lista (faz uma nova parte final).

CObList::Find

Obtém a posição de um elemento especificado pelo valor de ponteiro.

CObList::FindIndex

Obtém a posição de um elemento especificado por um índice com base zero.

CObList::GetAt

Obtém o elemento em uma posição determinada.

CObList::GetCount

Retorna o número de elementos em esta lista.

CObList::GetHead

Retorna o elemento principal de lista (não pode ser deixado).

CObList::GetHeadPosition

Retorna a posição do elemento principal da lista.

CObList::GetNext

Obtém o próximo elemento para iterar.

CObList::GetPrev

Obtém o elemento anterior para iterar.

CObList::GetSize

Retorna o número de elementos em esta lista.

CObList::GetTail

Retorna o elemento da parte final da lista (não pode ser deixado).

CObList::GetTailPosition

Retorna a posição do elemento da parte final da lista.

CObList::InsertAfter

Insere um novo elemento após uma posição determinada.

CObList::InsertBefore

Insere um novo elemento antes que uma posição determinada.

CObList::IsEmpty

Testa a condição vazia de lista (elementos).

CObList::RemoveAll

Remove todos os elementos de esta lista.

CObList::RemoveAt

Remove um elemento de esta lista, por posição especificada.

CObList::RemoveHead

Remove o elemento do início da lista.

CObList::RemoveTail

Remove o elemento da parte final da lista.

CObList::SetAt

Define o elemento em uma posição determinada.

Comentários

As listas deCObList se comportam como listas vinculadas de.

Uma variável do tipo POSIÇÃO é uma chave para a lista.Você pode usar uma variável de POSIÇÃO como um iterador para atravessar seqüencialmente uma lista e como um indicador para armazenar um local.Uma posição não é a mesma que um índice, mas.

Inserção do elemento é muito rápido no início da lista, na parte final, e em POSIÇÃOconhecido.Uma busca seqüencial é necessária para analisar um elemento por valor ou pelo índice.Esta pesquisa pode ser lento se a lista é longa.

CObList inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos.Se uma lista de ponteiros de CObject é armazenada em um arquivo, com um operador sobrecarregado insert ou com a função de membro de Serialize , cada elemento de CObject é serializado por sua vez.

Se você precisar de um despejo dos elementos individuais de CObject na lista, você deve definir o tamanho do contexto de um despejo a 1 ou maior.

Quando um objeto de CObList é excluído, ou quando seus elementos são removidos, somente os ponteiros de CObject são removidos, não os objetos que referenciam.

Você pode derivar suas próprias classes de CObList.A nova classe de lista, projetada para armazenar ponteiros para objetos derivados de CObject, adicionar novos membros de dados e novas funções de membro.Observe que a lista resultante não é estritamente com segurança de tipos, pois ele permite a inserção de todo o ponteiro de CObject .

ObservaçãoObservação

Você deve usar a macro de IMPLEMENT_SERIAL na implementação da classe derivada se você pretende serializar a lista.

Para obter mais informações sobre como usar CObList, consulte o artigo coleções.

Hierarquia de herança

CObject

CObList

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe de CObject

Gráfico de hierarquia

Classe de CStringList

Classe de CPtrList