aggregatable

[アーティクル]
06/09/2015

クラスが集約をサポートすることを示します。

[ aggregatable(  
   value 
) ]

パラメーター

評価します (省略可能)
COM オブジェクトがいつ集約できるかを示すパラメーター :
- は COM オブジェクトは集約することはできません。
- 割り当てられた COM オブジェクトを直接作成できます。また集計できます。これは、既定の設定です。
- 必ず COM オブジェクトを直接作成し集計できます。このオブジェクトの CoCreateInstance を呼び出すと集約オブジェクトの IUnknown インターフェイス (コントロールの IUnknown) を指定する必要があります。

解説

aggregatable C++ 属性に aggregatable の MIDL の属性と同じ機能があります。これはコンパイラで生成された .idl ファイルに aggregatable の属性を渡すことを意味します。

この属性はコクラス ProgIDまたは vi_progid の属性 (そのうちの 1 つを意味する属性を適用することを同じ要素に必要です。の一つの属性が使用されそのほかの 2 つが自動的に適用されます。たとえばProgID が適用されている場合vi_progid と コクラス も適用されます。

ATL プロジェクト

この属性はATL を使用してプロジェクト内で使用する場合は属性の動作が変わります。前に説明した動作だけでなく属性もターゲットクラスに次のマクロに 1 を追加します :

パラメーター値	挿入するマクロ
なし	DECLARE_NOT_AGGREGATABLE
許可	DECLARE_POLY_AGGREGATABLE
常時	DECLARE_ONLY_AGGREGATABLE

使用例

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

必要条件

属性コンテキスト

対象	クラス struct
複数回の適用	Ｘ
必要な属性	次の一つ以上 : コクラス ProgIDまたは vi_progid。
無効な属性	なし