ATL-verzamelingen en -opsommingen

A collection is een COM-object dat een interface biedt die toegang biedt tot een groep gegevensitems (onbewerkte gegevens of andere objecten). Een interface die voldoet aan de standaarden voor het verlenen van toegang tot een groep objecten wordt een verzamelingsinterface genoemd.

Verzamelingsinterfaces moeten minimaal een Count eigenschap opgeven die het aantal items in de verzameling retourneert, een Item eigenschap die een item uit de verzameling retourneert op basis van een index en een _NewEnum eigenschap die een opsomming voor de verzameling retourneert. Optioneel kunnen verzamelingsinterfaces methoden zoals Add en Remove bieden om toe te staan dat items worden ingevoegd in of verwijderd uit de verzameling, en een Clear methode om alle items te verwijderen.

Een enumerator is een COM-object dat een interface biedt voor het doorlopen van items in een verzameling. Enumerator-interfaces bieden seriële toegang tot de elementen van een verzameling via vier vereiste methoden: Next, Skip, Reseten Clone.

U vindt meer informatie over enumerator-interfaces door referentie-inhoud zoals de IEnumString-interface te lezen.

In deze sectie

ATL-verzamelings- en enumeratorklassen
Kort beschrijving en bevat koppelingen naar de ATL-klassen waarmee u verzamelingen en opsommingen kunt implementeren.

Ontwerpprincipes voor verzamelings- en enumeratorinterfaces
Bespreekt de verschillende ontwerpprincipes achter elk type interface.

Een C++ Standard Library-Based Collection implementeren
Een uitgebreid voorbeeld dat u begeleidt bij de implementatie van een op C++ standaardbibliotheek gebaseerde verzameling.

Gerelateerde Secties

ATL-
Bevat koppelingen naar conceptuele onderwerpen over het programmeren met behulp van de actieve sjabloonbibliotheek.

ATLCollections-voorbeeld
Een voorbeeld dat het gebruik van ICollectionOnSTLImpl en CComEnumOnSTLen de implementatie van aangepaste kopieerbeleidsklassen laat zien.

Zie ook

Concepten