REQUIRED_CATEGORY
Ajoutez une macro d' REQUIRED_CATEGORY à mappage de catégorie de votre composant pour spécifier qu'il doit être enregistré en tant que spécification de la catégorie reconnue par le paramètre d' catID .
REQUIRED_CATEGORY(
catID
)
Paramètres
- catID
[in] Une constante ou une variable de CATID maintenant l'identificateur global unique (GUID) pour la catégorie obligatoire. L'adresse d' catID est prise et ajoutée à la carte. Consultez le tableau ci-dessous pour une sélection de catégories boursières.
Notes
Les catégories de composants répertoriés dans le mappage seront enregistrées automatiquement lorsque le package est stocké si la classe possède une macro associée d' OBJECT_ENTRY_AUTO ou d' OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO .
Les clients peuvent utiliser les informations de catégorie stockées pour la classe définit ses fonctions et spécifications sans devoir créer une instance. Par exemple, un contrôle peut nécessiter qu'une liaison de données en charge des conteneurs. Le conteneur peut déterminer s'il a des fonctionnalités nécessaires pour héberger le contrôle en interrogeant le gestionnaire de catégorie pour les catégories requises par ce contrôle. Si le conteneur ne prend pas en charge une fonctionnalité requise, il peut refuser d'héberger l'objet COM.
Pour plus d'informations sur les catégories de composants, y compris une liste des exemples, consultez Les sont des catégories de composants et la façon dont ils fonctionnent ? dans Kit de développement logiciel Windows.
Une sélection de catégories stock
Description |
Symbole |
Registre GUID |
|---|---|---|
Sécurisée pour le script |
CATID_SafeForScripting |
{} 7DD95801-9882-11CF-9FA9-00AA006C42C4 |
Sécurisée pour l'initialisation |
CATID_SafeForInitializing |
{} 7DD95802-9882-11CF-9FA9-00AA006C42C4 |
Relation contenant-contenu simple de site de frame |
CATID_SimpleFrameControl |
{} 157083E0-2368-11cf-87B9-00AA006C8166 |
Liaison de données simple |
CATID_PropertyNotifyControl |
{} 157083E1-2368-11cf-87B9-00AA006C8166 |
Liaison de données avancées |
CATID_VBDataBound |
{} 157083E2-2368-11cf-87B9-00AA006C8166 |
Contrôles sans fenêtre |
CATID_WindowlessObject |
{} 1D06B600-3AE3-11cf-87B9-00AA006C8166 |
Objets Outil sur internet Avertis |
Consultez l' Objets avertis Internet dans Kit de développement logiciel Windows pour une liste d'exemple. |
|
Exemple
BEGIN_CATEGORY_MAP(CMyWindow)
REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()
Configuration requise
Header: atlcom.h