aggregabile
Indica che la classe supporta aggregato.
[ aggregatable(
value
) ]
Parametri
valore (facoltativo)
un parametro per indicare quando l'oggetto COM può essere aggregatoe:mai l'oggetto COM non può essere aggregatoe.
concedere L'oggetto COM può essere creato direttamente o può essere aggregatoe.Questa è l'impostazione predefinita.
sempre L'oggetto COM non può essere creato direttamente e può essere aggregatoe solo.Quando si chiama CoCreateInstance per questo oggetto, è necessario specificare l'oggetto aggregante IUnknown interfaccia (il controllo IUnknown).
Note
cui aggregatable L'attributo di C++ ha la stessa funzionalità di cui aggregatable Attributo MIDL.Ciò significa che il passaggio cui aggregatable attributo al file generato con estensione .idl.
L'attributo richiede che coclasse, progid, o vi_progid attributo o un altro attributo che implica uno di questi) viene applicato anche allo stesso elemento.Se qualsiasi singolo attributo viene utilizzato, gli altri due vengono applicate automaticamente.Ad esempio, se progid viene applicato, vi_progid e coclasse anche applicati.
Progetti ATL
Se questo attributo viene utilizzato in un progetto che utilizza ATL, il comportamento dell'attributo viene modificato.Oltre al comportamento descritto in precedenza, l'attributo viene aggiunta una delle macro nella classe di destinazione:
Valore del parametro |
Macro di comando |
---|---|
Mai |
|
Consentito |
|
Sempre |
Esempio
// 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 {};
Requisiti
contesto di attributo
Si applica a |
classe, struct |
ripetibile |
No |
attributi obbligatori |
Uno o più dei seguenti elementi: coclasse, progid, o vi_progid. |
attributi non validi |
Nessuno |
per ulteriori informazioni sui contesti di attributo, vedere Associare ai contesti.