ATL-Auflistungen und -Enumerationen

  • Artikel

A collection ist ein COM-Objekt, das eine Schnittstelle bereitstellt, die den Zugriff auf eine Gruppe von Datenelementen (Rohdaten oder andere Objekte) ermöglicht. Eine Schnittstelle, die den Standards zum Bereitstellen des Zugriffs auf eine Gruppe von Objekten folgt, wird als Sammlungsschnittstelle bezeichnet.

Mindestens müssen Auflistungsschnittstellen eine Count Eigenschaft bereitstellen, die die Anzahl der Elemente in der Auflistung zurückgibt, eine Item Eigenschaft, die ein Element aus der Auflistung basierend auf einem Index zurückgibt, und eine _NewEnum Eigenschaft, die einen Enumerationerator für die Auflistung zurückgibt. Optional können Sammlungsschnittstellen bereitstellen und Methoden bereitstellen Add , Remove um das Einfügen oder Löschen von Elementen aus der Auflistung und eine Clear Methode zum Entfernen aller Elemente zu ermöglichen.

Ein enumerator COM-Objekt ist ein COM-Objekt, das eine Schnittstelle zum Durchlaufen von Elementen in einer Auflistung bereitstellt. Enumeratorschnittstellen bieten seriellen Zugriff auf die Elemente einer Sammlung über vier erforderliche Methoden: Next, , , SkipResetund Clone.

Weitere Informationen zu Enumerationsschnittstellen finden Sie durch Lesen von Referenzinhalten wie der IEnumString-Schnittstelle .

In diesem Abschnitt

ATL-Auflistungen und -Enumeratorklassen
Beschreibt kurz und stellt Links zu den ATL-Klassen bereit, mit denen Sie Sammlungen und Enumerationen implementieren können.

Designrichtlinien für Auflistungs- und Enumeratorschnittstellen
Erläutert die verschiedenen Entwurfsprinzipien hinter jedem Schnittstellentyp.

Implementieren einer auf der C++-Standardbibliothek basierten Auflistung
Ein erweitertes Beispiel, das Sie durch die Implementierung einer C++-Standardbibliothekssammlung führt.

ATL
Enthält Links zu konzeptionellen Themen über die Programmierung mit der Active Template Library.

ATLCollections-Beispiel
Ein Beispiel, das die Verwendung und ICollectionOnSTLImplCComEnumOnSTLdie Implementierung von benutzerdefinierten Kopierrichtlinienklassen veranschaulicht.

Siehe auch

Konzepte