Koleksi dan Enumerator ATL
adalah collection
objek COM yang menyediakan antarmuka yang memungkinkan akses ke sekelompok item data (data mentah atau objek lainnya). Antarmuka yang mengikuti standar untuk menyediakan akses ke sekelompok objek dikenal sebagai antarmuka koleksi.
Minimal, antarmuka koleksi harus menyediakan Count
properti yang mengembalikan jumlah item dalam koleksi, Item
properti yang mengembalikan item dari koleksi berdasarkan indeks, dan _NewEnum
properti yang mengembalikan enumerator untuk koleksi. Secara opsional, antarmuka pengumpulan dapat menyediakan Add
metode dan Remove
untuk memungkinkan item dimasukkan ke dalam atau dihapus dari koleksi, dan Clear
metode untuk menghapus semua item.
Adalah enumerator
objek COM yang menyediakan antarmuka untuk melakukan iterasi melalui item dalam koleksi. Antarmuka enumerator menyediakan akses serial ke elemen koleksi melalui empat metode yang diperlukan: Next
, , Skip
Reset
, dan Clone
.
Anda dapat mempelajari selengkapnya tentang antarmuka enumerator dengan membaca konten referensi seperti antarmuka IEnumString .
Di Bagian Ini
Kelas Koleksi dan Enumerator ATL
Secara singkat menjelaskan dan menyediakan tautan ke kelas ATL yang akan membantu Anda menerapkan koleksi dan enumerator.
Prinsip Desain untuk Antarmuka Pengumpulan dan Enumerator
Membahas prinsip desain yang berbeda di balik setiap jenis antarmuka.
Menerapkan Koleksi Berbasis Pustaka Standar C++
Contoh diperluas yang memandu Anda melalui implementasi koleksi berbasis Pustaka Standar C++.
Bagian Terkait
ATL
Menyediakan tautan ke topik konseptual tentang cara memprogram menggunakan Pustaka Templat Aktif.
Sampel ATLCollections
Sampel yang menunjukkan penggunaan ICollectionOnSTLImpl
dan CComEnumOnSTL
, dan implementasi kelas kebijakan salinan kustom.