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

DECLARE_NOT_AGGREGATABLE

Consentito

DECLARE_POLY_AGGREGATABLE

Sempre

DECLARE_ONLY_AGGREGATABLE

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.

Vedere anche

Riferimenti

Aggregation

Altre risorse

Attributi IDL

Attributi di classe

Typedef, Enumerazione, unione e attributi di strutture

Attributes Samples