Colecciones y enumeradores de ATL

collection es un objeto COM que proporciona una interfaz que permite el acceso a un grupo de elementos de datos (datos sin procesar u otros objetos). Una interfaz que sigue los estándares para proporcionar acceso a un grupo de objetos se conoce como interfaz de colección.

Como mínimo, las interfaces de colección deben proporcionar una propiedad Count que devuelva el número de elementos de la colección, una propiedad Item que devuelva un elemento de la colección basada en un índice y una propiedad _NewEnum que devuelva un enumerador para la colección. Opcionalmente, las interfaces de colección pueden proporcionar métodos Add y Remove para permitir que los elementos se inserten en la colección o se eliminen de ella, y un método Clear para quitar todos los elementos.

enumerator es un objeto COM que proporciona una interfaz para efectuar una iteración por los elementos de una colección. Las interfaces de enumerador proporcionan acceso serie a los elementos de una colección a través de cuatro métodos necesarios: Next, Skip, Reset y Clone.

Para obtener más información sobre las interfaces de enumerador, lea contenido de referencia como la interfaz IEnumString.

En esta sección

Recopilación de ATL y clases de enumerador
Describe brevemente y proporciona vínculos a las clases ATL que le ayudarán a implementar colecciones y enumeradores.

Principios de diseño para la recopilación e interfaces de enumerador
Aborda los distintos principios de diseño detrás de cada tipo de interfaz.

Implementar una recopilación basada en la biblioteca estándar de C++
Un ejemplo exhaustivo que le guía por la implementación de una colección basada en la biblioteca estándar de C++.

Secciones relacionadas

ATL
Proporciona vínculos a temas sobre cómo programar utilizando Active Template Library.

Ejemplo de ATLCollections
Un ejemplo en el que se muestra el uso de ICollectionOnSTLImpl y CComEnumOnSTL, así como la implementación de clases de directivas de copia personalizadas.

Consulte también

Conceptos