aggregatable
indique que la classe prend en charge le regroupement.
[ aggregatable(
value
) ]
Paramètres
valeur (facultatif)
un paramètre pour indiquer quand l'objet COM peut être regroupé :jamais l'objet COM ne peut pas être regroupé.
let l'objet COM peut être créé directement ou il peut être regroupé. Il s'agit de la valeur par défaut.
toujours l'objet COM ne pouvez pas créer directement et ne peut être regroupé. Lorsque vous appelez CoCreateInstance pour cet objet, vous devez spécifier l'interface d' IUnknown de l'objet agrégation ( IUnknowncontrôle).
Notes
L'attribut d' aggregatable C++ a les mêmes fonctionnalités que l'attribut d' aggregatable MIDL. Cela signifie que le compilateur passe l'attribut d' aggregatable le fichier généré .idl.
Cet attribut requiert que coclasse, progid, ou un attribut de vi_progid (ou un attribut différent qui implique un d'eux) également être appliqués au même élément. Si attribut unique en est utilisé, les deux autres sont automatiquement appliqués. par exemple, si progid est appliqué, vi_progid et coclasse sont également appliqués.
Projets ATL
si cet attribut est utilisé dans un projet qui utilise ATL, le comportement de l'attribut change. Outre le comportement décrit précédemment, l'attribut ajoute également une des macros suivantes à la classe cible :
Valeur de paramètre |
macro insérée |
|---|---|
Jamais |
|
Autorisé |
|
Toujours |
Exemple
// cpp_attr_ref_aggregatable.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"
[module(name="MyModule")];
[ coclass, aggregatable(allowed),
uuid("1a8369cc-1c91-42c4-befa-5a5d8c9d2529")]
class CMyClass {};
Configuration requise
contexte d'attribut
S'applique à |
classe, struct |
reproductible |
Non |
attributs requis |
Un ou plusieurs des éléments suivants : coclasse, progid, ou vi_progid. |
attributs valides |
Aucun |
Pour plus d'informations sur les contextes d'attribut, consultez contextes d'attribut.