Поделиться через


Коллекции и перечислители ATL

Объект collection COM, предоставляющий интерфейс, позволяющий получить доступ к группе элементов данных (необработанные данные или другие объекты). Интерфейс, который соответствует стандартам предоставления доступа к группе объектов, называется интерфейсом коллекции.

По крайней мере интерфейсы коллекции должны предоставлять Count свойство, возвращающее количество элементов в коллекции, свойство, Item возвращающее элемент из коллекции на основе индекса, и _NewEnum свойство, возвращающее перечислитель для коллекции. При необходимости интерфейсы коллекции могут предоставлять Add и Remove методы, позволяющие вставлять или удалять элементы из коллекции, а Clear также метод для удаления всех элементов.

Это enumerator COM-объект, предоставляющий интерфейс для итерации элементов в коллекции. Интерфейсы перечислителя обеспечивают последовательный доступ к элементам коллекции с помощью четырех обязательных методов: Next, Skip, Resetи Clone.

Дополнительные сведения об интерфейсах перечислителя можно узнать, прочитав справочные материалы, такие как интерфейс IEnumString .

В этом разделе

Классы коллекций и перечислителей ATL
Кратко описывает и содержит ссылки на классы ATL, которые помогут реализовать коллекции и перечислители.

Принципы разработки интерфейсов для коллекций и перечислителей
Обсуждает различные принципы проектирования каждого типа интерфейса.

Реализация коллекции на основе стандартной библиотеки C++
Расширенный пример, который описывает реализацию коллекции на основе стандартной библиотеки C++ .

ATL
Ссылки на разделы о программировании с использованием библиотеки ATL.

Пример ATLCollections
Пример, демонстрирующий использование ICollectionOnSTLImpl и CComEnumOnSTLреализацию пользовательских классов политик копирования.

См. также

Основные понятия