ATL – kolekce a výčty

A collection je objekt COM, který poskytuje rozhraní, které umožňuje přístup ke skupině datových položek (nezpracovaná data nebo jiné objekty). Rozhraní, které dodržuje standardy pro poskytování přístupu ke skupině objektů, se označuje jako rozhraní kolekce.

Minimálně rozhraní kolekce musí poskytovat Count vlastnost, která vrací počet položek v kolekci, vlastnost, Item která vrací položku z kolekce na základě indexu, a _NewEnum vlastnost, která vrací enumerátor pro kolekci. Volitelně mohou rozhraní kolekcí poskytovat Add a Remove metody, které umožňují vkládání nebo odstraňování položek z kolekce, a metodu Clear pro odebrání všech položek.

Objekt enumerator COM, který poskytuje rozhraní pro iterování prostřednictvím položek v kolekci. Rozhraní enumerátoru poskytují sériový přístup k prvkům kolekce prostřednictvím čtyř požadovaných metod: Next, Skip, Reseta Clone.

Další informace o rozhraních enumerátoru najdete v referenčním obsahu, jako je IEnumString rozhraní.

V tomto oddílu

ATL – třídy kolekcí a výčtů
Stručně popisuje a poskytuje odkazy na třídy ATL, které vám pomůžou implementovat kolekce a výčty.

Principy návrhu rozhraní kolekce a výčtů
Popisuje různé principy návrhu za každým typem rozhraní.

Implementace kolekce založené na standardní knihovně C++
Rozšířený příklad, který vás provede implementací kolekce založené na standardní knihovně jazyka C++.

Související oddíly

ATL
Obsahuje odkazy na koncepční témata o tom, jak programovat pomocí knihovny aktivní šablony.

Ukázka ATLCollections
Ukázka, která demonstruje použití ICollectionOnSTLImpl a CComEnumOnSTLimplementace vlastních tříd zásad kopírování.

Viz také

Koncepty