Partager via


BEGIN_CATEGORY_MAP

Marque le début du mappage de catégorie.

BEGIN_CATEGORY_MAP( theClass )

Paramètres

  • theClass
    [in] Le nom de la classe contenant le mappage de catégorie.

Notes

Le mappage de catégorie est utilisée pour spécifier les catégories de composants la classe COM implémenteront et que les catégories nécessite de son conteneur.

Ajoutez une entrée d' IMPLEMENTED_CATEGORY au mappage pour chaque catégorie implémentée par la classe COM.Ajoutez une entrée de REQUIRED_CATEGORY au mappage pour chaque catégorie que la classe requiert que ses clients à implémenter.Marquez la fin de la carte avec la macro d' END_CATEGORY_MAP .

Les catégories de composants répertoriés dans le mappage seront enregistrées automatiquement lorsque le package est stocké si la classe a OBJECT_ENTRY_AUTO associé ou OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO.

[!REMARQUE]

ATL utilise le gestionnaire standard de catégories de composants pour stocker des catégories de composants.Si le gestionnaire n'est pas présent sur le système lorsque le package est enregistré, l'inscription réussit, mais les catégories de composants ne sont pas signalées pour cette classe.

Pour plus d'informations sur les catégories de composants, consultez Les sont des catégories de composants et la façon dont ils fonctionnent ? dans Kit de développement logiciel Windows.

Exemple

BEGIN_CATEGORY_MAP(CMyCtrl)
   IMPLEMENTED_CATEGORY(CATID_Insertable)
END_CATEGORY_MAP()

Configuration requise

Header: atlcom.h

Voir aussi

Référence

IMPLEMENTED_CATEGORY

REQUIRED_CATEGORY

END_CATEGORY_MAP

Autres ressources

Macros de catégorie

Macros ATL