Coleções e enumeradores ATL

Um 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 os padrões para fornecer acesso a um grupo de objetos é conhecida como uma interface de coleção.

No mínimo, as interfaces de coleção devem fornecer uma propriedade Count que retorna o número de itens na coleção, uma propriedade Item que retorna um item da coleção com base em um índice e uma propriedade _NewEnum que retorna um enumerador para a coleção. Opcionalmente, as interfaces de coleção podem fornecer métodos Add e Remove para permitir que os itens sejam inseridos ou excluídos da coleção e um método Clear para remover todos os itens.

Um enumerator é um objeto COM que fornece uma interface para iteração por meio de itens em uma coleção. As interfaces do enumerador fornecem acesso serial aos elementos de uma coleção por meio de quatro métodos necessários: Next, Skip, Reset e Clone.

Você pode saber mais sobre as interfaces do enumerador lendo o conteúdo de referência, como a interface IEnumString.

Nesta seção

Classes de coleção e enumerador da ATL
Descreve e fornece brevemente links para as classes ATL que ajudarão você a implementar coleções e enumeradores.

Princípios de design para interfaces de coleção e enumerador
Discute os diferentes princípios de design por trás de cada tipo de interface.

Implementando uma coleção baseada na biblioteca padrão C++
Um exemplo estendido que orienta você pela implementação de uma coleção baseada na Biblioteca Padrão do C++.

Seções relacionadas

ATL
Fornece links para tópicos conceituais sobre como programar usando o Active Template Library.

Exemplo de ATLCollections
Um exemplo que demonstra o uso de ICollectionOnSTLImpl e CComEnumOnSTL, e a implementação de classes de política de cópia personalizadas.

Confira também

Conceitos