Classe de CComEnumImpl

Artigo
02/25/2013

Essa classe fornece a implementação de uma interface de enumerador COM onde os itens que estão sendo enumerados sejam armazenados em uma matriz.

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

Parâmetros

Base
Uma interface de enumerador COM (IEnumXXXX).
piid
Um ponteiro para o interface identificação da interface de enumeração.
T
O tipo de item exposto pela interface de enumeração.
Copy
copie a classe da diretivahomogêneo.

Membros

Construtores public

Nome	Descrição
CComEnumImpl::CComEnumImpl	o construtor.
CComEnumImpl::~CComEnumImpl	O destrutor.

Métodos públicos

Nome	Descrição
CComEnumImpl::Clone	A implementação de IEnumXXXX::Clone.
CComEnumImpl::Init	Inicializa o enumerador.
CComEnumImpl::Next	A implementação de IEnumXXXX::Next.
CComEnumImpl::Reset	A implementação de IEnumXXXX::Reset.
CComEnumImpl::Skip	A implementação de IEnumXXXX::Skip.

Membros públicos de dados

Nome	Descrição
CComEnumImpl::m_begin	Um ponteiro para o primeiro item na matriz.
CComEnumImpl::m_dwFlags	Sinalizadores de impressão passados com Init.
CComEnumImpl::m_end	Um ponteiro para o local apenas além do último item na matriz.
CComEnumImpl::m_iter	Um ponteiro para o item atual na matriz.
CComEnumImpl::m_spUnk	O ponteiro de IUnknown de objeto que fornece a coleção sendo enumerada.

Comentários

CComEnumImpl fornece a implementação para uma interface de enumerador COM onde os itens que estão sendo enumerados sejam armazenados em uma matriz.Essa classe é análoga a classe de IEnumOnSTLImpl , que fornece uma implementação de uma interface enumerator com base em um recipiente de STL.

Observação
Para obter detalhes sobre as diferenças entre CComEnumImpl adicionais e IEnumOnSTLImpl, consulte CComEnumImpl::Init.

Normalmente, você não precisará criar sua própria classe de enumerador derivando de essa implementação da interface.Se você desejar usar um enumerador ATL- fornecido com base em uma matriz, é mais comum criar uma instância de CComEnum.

Em o entanto, se você precisar fornecer um enumerador personalizado (por exemplo, um que expõe interfaces além da interface de enumerador), você pode derivar da classe.Em esta situação, é provável que você precisará substituir o método de CComEnumImpl::Clone para fornecer sua própria implementação.

Para obter mais informações, consulte coleções e enumeradores de ATL.

Hierarquia de herança

Base

CComEnumImpl

Requisitos

Cabeçalho: atlcom.h

Consulte também

Referência

Classe de IEnumOnSTLImpl

Classe de CComEnum

Outros recursos

Visão geral da classe de ATL

Compartilhar via