requires_category

Article
10/12/2023

Spécifie les catégories de composants requises de la classe cible.

Syntaxe

[ requires_category(
  requires_category) ]

Paramètres

requires_category
ID de la catégorie requise.

Notes

L’attribut requires_category C++ spécifie les catégories de composants requises par la classe cible. Pour plus d’informations, consultez REQUIRED_CATEGORY.

Cet attribut exige que l’attribut coclass, progidou vi_progid (ou un autre attribut qui implique l’un de ceux-ci) soit également appliqué au même élément.

Exemple

Le code suivant nécessite que l’objet implémente la catégorie Control.

// 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 {};

Spécifications

Contexte d’attribut	Valeur
S’applique à	`class`, `struct`
Renouvelable	Non
Attributs requis	Un ou plusieurs des éléments suivants : `coclass`, `progid`ou `vi_progid`.
Attributs non valides	Aucune

Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.

Voir aussi

Attributs COM
implements_category

Partager via