CComEnumImpl クラス

[アーティクル]
08/09/2011

このクラスは、COM 列挙子インターフェイスの実装を提供します。このインターフェイスでは、列挙されるアイテムが配列に格納されます。

template <
   class Base,
   const IID* piid,
   class T,
   class Copy
>
class ATL_NO_VTABLE CComEnumImpl : 
   public Base

パラメーター

Base
COM 列挙子 (IEnumXXXX) インターフェイス。
piid
列挙子インターフェイスのインターフェイス ID へのポインター。
T
列挙子インターフェイスによって公開されるアイテムの型。
Copy
同種のコピーポリシークラス。

解説

CComEnumImpl クラスは、COM 列挙子インターフェイスの実装を提供します。このインターフェイスでは、列挙されるアイテムが配列に格納されます。このクラスは、STL コンテナーに基づいた列挙子インターフェイスの実装を提供する IEnumOnSTLImpl クラスに類似しています。

注意

CComEnumImpl と IEnumOnSTLImpl の違いについては、CComEnumImpl::Init の説明を参照してください。

通常は、このインターフェイスの実装から独自の列挙子クラスを派生させて作成する必要はありません。 ATL (Active Template Library) で用意されている、配列に基づいた列挙子を使用する場合、CComEnum クラスのインスタンスを作成する方法がより一般的です。

ただし、カスタム列挙子 (列挙子インターフェイスのほかにもインターフェイスを公開する列挙子など) を用意する必要がある場合は、このクラスから派生クラスを作成できます。その場合は、独自の実装を提供できるように、CComEnumImpl::Clone メソッドをオーバーライドする必要があります。

詳細については、「ATL のコレクションと列挙子」を参照してください。