requires_category
Especifica as categorias de componente necessárias da classe de destino.
Sintaxe
[ requires_category(
requires_category) ]
Parâmetros
requires_category
A ID da categoria necessária.
Comentários
O atributo C++ requires_category especifica as categorias de componente exigidas pela classe de destino. Para obter mais informações, consulte REQUIRED_CATEGORY.
Esse atributo requer que o atributo coclass, progid ou vi_progid (ou outro atributo que implique um desses) também seja aplicado ao mesmo elemento.
Exemplo
O código a seguir requer que o objeto implemente a categoria Controle.
// cpp_attr_ref_requires_category.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"
[module (name="MyLibrary")];
[ coclass, requires_category("CATID_Control"),
uuid("1e1a2436-f3ea-4ff3-80bf-5409370e8144")]
class CMyClass {};
Requisitos
| Contexto do atributo | Valor |
|---|---|
| Aplicável ao | class, struct |
| Repetível | Não |
| Atributos obrigatórios | Um ou mais dos seguintes: coclass, progid ou vi_progid. |
| Atributos inválidos | Nenhum |
Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.