Kelas ICollectionOnSTLImpl

Kelas ini menyediakan metode yang digunakan oleh kelas koleksi.

Sintaks

template <class T, class CollType, class ItemType, class CopyItem, class EnumType>
class ICollectionOnSTLImpl : public T

Parameter

T
Antarmuka pengumpulan COM.

CollType
Kelas kontainer Pustaka Standar C++.

ItemType
Jenis item yang diekspos oleh antarmuka kontainer.

CopyItem
Kelas kebijakan penyalinan.

EnumType
Kelas enumerator yang kompatibel dengan CComEnumOnSTL.

Anggota

Metode Publik

Nama	Deskripsi
ICollectionOnSTLImpl::get__NewEnum	Mengembalikan objek enumerator untuk koleksi.
ICollectionOnSTLImpl::getcount	Mengembalikan jumlah elemen dalam kumpulan.
ICollectionOnSTLImpl::get_Item	Mengembalikan item yang diminta dari koleksi.

Anggota Data Publik

Nama	Deskripsi
ICollectionOnSTLImpl::m_coll	Koleksinya.

Keterangan

Kelas ini menyediakan implementasi untuk tiga metode antarmuka koleksi: getcount, get_Item, dan get__NewEnum.

Untuk menggunakan kelas ini:

• Tentukan (atau pinjam) antarmuka koleksi yang ingin Anda terapkan.

• Dapatkan kelas Anda dari spesialisasi ICollectionOnSTLImpl berdasarkan antarmuka koleksi ini.

• Gunakan kelas turunan Anda untuk menerapkan metode apa pun dari antarmuka koleksi yang tidak ditangani oleh ICollectionOnSTLImpl.

Catatan

Jika antarmuka koleksi adalah antarmuka ganda, dapatkan kelas Anda dari IDispatchImpl, meneruskan ICollectionOnSTLImpl spesialisasi sebagai parameter templat pertama jika Anda ingin ATL memberikan implementasi IDispatch metode.

• Tambahkan item ke anggota m_coll untuk mengisi koleksi.

Untuk informasi dan contoh selengkapnya, lihat Koleksi dan Enumerator ATL.

Hierarki Warisan

T

ICollectionOnSTLImpl

Persyaratan

Header: atlcom.h

ICollectionOnSTLImpl::getcount

Metode ini mengembalikan jumlah item dalam koleksi.

STDMETHOD(getcount)(long* pcount);

Parameter

pcount
[out] Jumlah elemen dalam koleksi.

Tampilkan Nilai

Nilai HRESULT standar.

ICollectionOnSTLImpl::get_Item

Metode ini mengembalikan item yang ditentukan dari koleksi.

STDMETHOD(get_Item)(long Index, ItemType* pvar);

Parameter

Index
[di] Indeks berbasis 1 item dalam koleksi.

pvar
[out] Item yang sesuai dengan Indeks.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Item diperoleh dengan menyalin data pada posisi yang ditentukan di m_coll menggunakan metode salin kelas kebijakan salin yang diteruskan sebagai argumen templat dalam ICollectionOnSTLImpl spesialisasi.

ICollectionOnSTLImpl::get__NewEnum

Mengembalikan objek enumerator untuk koleksi.

STDMETHOD(get__NewEnum)(IUnknown** ppUnk);

Parameter

ppUnk
[out] Penunjuk IUnknown dari objek enumerator yang baru dibuat.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Enumerator yang baru dibuat mempertahankan iterator pada koleksi asli, m_coll, (sehingga tidak ada salinan yang dibuat) dan menyimpan referensi COM pada objek koleksi untuk memastikan bahwa koleksi tetap hidup sementara ada enumerator yang luar biasa.

ICollectionOnSTLImpl::m_coll

Anggota ini menyimpan item yang diwakili oleh koleksi.

CollType m_coll;

Lihat juga

Sampel ATLCollections
Gambaran Umum Kelas