Compartilhar via


Coleções e enumeradores de ATL

collection é um objeto COM que fornece uma interface que permite o acesso a um grupo de itens de dados (dados brutos ou outros objetos.)Uma interface que segue o padrão para fornecer acesso a um grupo de objetos é conhecida como uma interface de coleção.

Por o menos, as interfaces de coleção devem fornecer uma propriedade de Contagem que retorna o número de itens na coleção, em uma propriedade de Item que retorna um item da coleção baseada em um índice, e uma propriedade de _NewEnum que retorna um enumerador para a coleção.Opcionalmente, as interfaces de coleção podem fornecer Adicionar e métodos de Remover para permitir que os itens são inseridos em ou excluídos da coleção, e um método de Limpar para remover todos os itens.

enumerator é um objeto COM que fornece uma interface para percorrer os itens em uma coleção.As interfaces de enumerador serial fornecem acesso aos elementos de uma coleção via quatro métodos necessários: Next, Ignorar, Redefinir, e Clone.

Você pode aprender mais sobre interfaces de enumerador ler sobre a interface arquétipa (mas totalmente imaginária) IEnumXXXX.

Nesta seção

Seções relacionadas

  • ATL
    Fornece links para tópicos conceituais sobre como programar usando a biblioteca ativa do modelo.

  • exemplo de ATLCollections
    Um exemplo que demonstra o uso de ICollectionOnSTLImpl e de CComEnumOnSTL, e a implementação da diretiva personalizado de impressão classe.

Consulte também

Outros recursos

Conceitos de ATL