BEGIN_CATEGORY_MAP
Marca o início do mapa de categoria.
BEGIN_CATEGORY_MAP( theClass )
Parâmetros
- theClass
[in] o nome de classe que contém o mapa de categoria.
Comentários
O mapa da categoria é usado para especificar que as categorias componentes a classe COM implementarão e que as categorias ele exigem de seu recipiente.
Adicione uma entrada de IMPLEMENTED_CATEGORY ao mapa para cada categoria implementada por essa classe COM.Adicione uma entrada de REQUIRED_CATEGORY ao mapa para cada categoria que a classe requer seus clientes implementar.Marcar o final do mapa com a macro de END_CATEGORY_MAP .
As categorias componentes listadas no mapa serão registrados automaticamente quando o módulo é registrado se a classe tem OBJECT_ENTRY_AUTO associado ou OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO.
.gif "Observação") Observação |
|---|
ATL usa o gerenciador de categorias do componente padrão para registrar categorias componentes.Se o gerenciador não está presente no sistema quando o módulo é registrado, o registro é bem-sucedido, mas as categorias componentes não serão registrados para a classe. |
Para obter mais informações sobre as categorias componentes, consulte Categorias que são componentes e como eles funcionam? em Windows SDK.
Exemplo
BEGIN_CATEGORY_MAP(CMyCtrl)
IMPLEMENTED_CATEGORY(CATID_Insertable)
END_CATEGORY_MAP()
Requisitos
Cabeçalho: atlcom.h