Aracılığıyla paylaş


bir araya toplanabilir

Sınıf toplama desteklediğini gösterir.

[ aggregatable( 
   value
) ]

Parametreler

  • değeri (isteğe bağlı)
    Ne zaman com nesnesi toplanan belirtmek için bir parametre:

    • hiçbir zaman com nesnesi olamaz birikir.

    • izin verilen com nesnesine doğrudan oluşturulabilir veya toplanmasını.Varsayılan değer budur.

    • her zaman com nesnesine doğrudan oluşturulamaz ve yalnızca kümelenebilir.Aradığınızda CoCreateInstance bu nesne için aggregating nesnenin belirtmelisiniz IUnknown arabirimi (denetleme IUnknown).

Notlar

Bir araya toplanabilir C++ öznitelik aynı işlevselliğe sahip bir araya toplanabilir MIDL özniteliği.Derleyici geçeceğini yani bir araya toplanabilir üretilen .idl dosya özniteliği aracılığıyla.

Bu öznitelik gerektiren coclass, ProgID, veya vi_progid özniteliği (veya bunlardan anlaşılacağı başka bir öznitelik) de uygulanacağını aynı öğe.Tek bir öznitelik kullanýlmýþsa, diğer ikisi otomatik olarak uygulanır.Örneğin, ProgID uygulanan vi_progid ve coclass de uygulanır.

atl projeleri

Bu öznitelik atl kullanan bir proje içinde kullanılırsa, öznitelik davranışını değiştirir.Yukarıda tanımlanan davranışı yanı sıra özniteliği ayrıca aşağıdaki makroları birini hedef sınıfa ekler:

Parametre değeri

Eklenen makro

Hiçbir zaman

DECLARE_NOT_AGGREGATABLE

İzin verilen

DECLARE_POLY_AGGREGATABLE

Her zaman

DECLARE_ONLY_AGGREGATABLE

Örnek

// 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 {};

Gereksinimler

Öznitelik içerik

Uygulama alanı

sınıf,struct

Yinelenebilir

Hayyr

Gerekli öznitelikleri

Aşağıdakilerden en az biri: coclass, ProgID, veya vi_progid.

Geçersiz öznitelik

None

Öznitelik içerikleri hakkında daha fazla bilgi için bkz: Öznitelik içerikleri.

Ayrıca bkz.

Başvuru

Aggregation

Diğer Kaynaklar

IDL öznitelikleri

Sınıf öznitelikleri

TypeDef, Enum, Birliği ve yapı öznitelikleri

Attributes Samples