REQUIRED_CATEGORY
Adicione uma macro de REQUIRED_CATEGORY a mapa de categoria do seu componente para especificar que deve ser registrada como a exigência de categoria identificada pelo parâmetro de catID .
REQUIRED_CATEGORY(
catID
)
Parâmetros
- catID
[in] uma constante ou uma variável de CATID que contém o identificador exclusivo (GUID) para a categoria necessário.O endereço de catID será executada e adicionado ao mapa.Consulte a tabela abaixo para uma seleção de categorias pré-definidas.
Comentários
As categorias componentes listadas no mapa serão registrados automaticamente quando o módulo é registrado se a classe tem uma macro associado de OBJECT_ENTRY_AUTO ou de OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO .
Clientes podem usar informações de categoria registrado para que a classe determinar os recursos e requisitos sem ter que criar uma instância de ela.Por exemplo, um controle pode exigir que uma associação de dados de suporte do recipiente.O contêiner pode descobrir se possui recursos necessários hospedar o controle ver o gerenciador de categoria para as categorias exigidas pelo controle.Se o recipiente não oferece suporte a um recurso necessário, não permitir pode hospedar o objeto COM.
Para obter mais informações sobre as categorias componentes, incluindo uma lista de exemplo, consulte Categorias que são componentes e como eles funcionam? em Windows SDK.
Uma seleção de categorias pré-definidas
Descrição |
Símbolo |
O Registro |
|---|---|---|
Com segurança para o script |
CATID_SafeForScripting |
{} 7DD95801-9882-11CF-9FA9-00AA006C42C4 |
Com segurança para inicialização |
CATID_SafeForInitializing |
{} 7DD95802-9882-11CF-9FA9-00AA006C42C4 |
Confinamento simples de site de quadro chave |
CATID_SimpleFrameControl |
{} 157083E0-2368-11cf-87B9-00AA006C8166 |
Associação de dados simples |
CATID_PropertyNotifyControl |
{} 157083E1-2368-11cf-87B9-00AA006C8166 |
Associação avançada de dados |
CATID_VBDataBound |
{} 157083E2-2368-11cf-87B9-00AA006C8166 |
Controles sem o windows |
CATID_WindowlessObject |
{} 1D06B600-3AE3-11cf-87B9-00AA006C8166 |
Objetos internet Cientes |
Consulte objetos cientes de Internet em Windows SDK para obter uma lista de exemplo. |
|
Exemplo
BEGIN_CATEGORY_MAP(CMyWindow)
REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()
Requisitos
Cabeçalho: atlcom.h