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
, Reset
a 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 CComEnumOnSTL
implementace vlastních tříd zásad kopírování.