ICollectionOnSTLImpl Sınıfı

Bu sınıf, bir koleksiyon sınıfı tarafından kullanılan yöntemleri sağlar.

Sözdizimi

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

Parametreler

T
COM koleksiyonu arabirimi.

CollType
C++ Standart Kitaplığı kapsayıcı sınıfı.

ItemType
Kapsayıcı arabirimi tarafından kullanıma sunulan öğe türü.

CopyItem
Kopyalama ilkesi sınıfı.

EnumType
CComEnumOnSTL uyumlu bir numaralandırıcı sınıfı.

Üyeler

Genel Yöntemler

Veri Akışı Adı	Açıklama
ICollectionOnSTLImpl::get__NewEnum	Koleksiyon için bir numaralandırıcı nesnesi döndürür.
ICollectionOnSTLImpl::getcount	Koleksiyondaki öğe sayısını döndürür.
ICollectionOnSTLImpl::get_Item	Koleksiyondan istenen öğeyi döndürür.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
ICollectionOnSTLImpl::m_coll	Koleksiyon.

Açıklamalar

Bu sınıf, bir koleksiyon arabiriminin üç yöntemi için uygulamayı sağlar: getcount, get_Item ve get__NewEnum.

Bu sınıfı kullanmak için:

• Uygulamak istediğiniz koleksiyon arabirimini tanımlayın (veya ödünç kullanın).

• Sınıfınızı bu koleksiyon arabirimini temel alan bir uzmanlığından ICollectionOnSTLImpl türetin.

• tarafından işlenmemiş ICollectionOnSTLImplkoleksiyon arabiriminden herhangi bir yöntem uygulamak için türetilmiş sınıfınızı kullanın.

Not

Koleksiyon arabirimi bir çift arabirimse, sınıfınızı IDispatchImpl'den türeterekICollectionOnSTLImpl, ATL'nin yöntemlerin uygulanmasını sağlamasını istiyorsanız ilk şablon parametresi olarak özelleştirmeyi IDispatch geçirin.

• Koleksiyonu doldurmak için m_coll üyesine öğe ekleyin.

Daha fazla bilgi ve örnek için bkz . ATL Koleksiyonları ve Numaralandırıcıları.

Devralma Hiyerarşisi

T

ICollectionOnSTLImpl

Gereksinimler

Üst bilgi: atlcom.h

ICollectionOnSTLImpl::getcount

Bu yöntem koleksiyondaki öğe sayısını döndürür.

STDMETHOD(getcount)(long* pcount);

Parametreler

sayım
[out] Koleksiyondaki öğelerin sayısı.

Dönüş Değeri

Standart bir HRESULT değeri.

ICollectionOnSTLImpl::get_Item

Bu yöntem koleksiyondan belirtilen öğeyi döndürür.

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

Parametreler

Dizin
[in] Koleksiyondaki bir öğenin 1 tabanlı dizini.

pvar
[out] Dizine karşılık gelen öğe.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Öğe, özelleştirmede şablon bağımsız değişkeni olarak geçirilen kopyalama ilkesi sınıfının kopyalama yöntemi kullanılarak m_coll belirtilen konumdaki ICollectionOnSTLImpl veriler kopyalanarak elde edilir.

ICollectionOnSTLImpl::get__NewEnum

Koleksiyon için bir numaralandırıcı nesnesi döndürür.

STDMETHOD(get__NewEnum)(IUnknown** ppUnk);

Parametreler

ppUnk
[out] Yeni oluşturulan bir numaralandırıcı nesnesinin IUnknown işaretçisi.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Yeni oluşturulan numaralandırıcı özgün m_collkoleksiyonda bir yineleyici tutar (bu nedenle kopya oluşturulmaz) ve bekleyen numaralandırıcılar varken koleksiyonun canlı kalmasını sağlamak için koleksiyon nesnesinde bir COM başvurusu tutar.

ICollectionOnSTLImpl::m_coll

Bu üye, koleksiyon tarafından temsil edilen öğeleri tutar.

CollType m_coll;

Ayrıca bkz.

ATLCollections Örneği
Sınıfa Genel Bakış