次の方法で共有

requires_category

  • [アーティクル]

適用先クラスの必須コンポーネント カテゴリを指定します。

[ requires_category( 
      requires_category
  ) ]

パラメータ

  • requires_category
    必須カテゴリの ID。

解説

C++ 属性 requires_category は、適用先クラスに必要なコンポーネント カテゴリを指定します。詳細については、「REQUIRED_CATEGORY」を参照してください。

この属性を使用する場合は、同じ要素に対して coclass、progid、または vi_progid の各属性 (あるいは、これらの 1 つを表す別の属性) も適用する必要があります。

使用例

オブジェクトが Control カテゴリを実装するように要求するコードを次に示します。

// cpp_attr_ref_requires_category.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"

[module (name="MyLibrary")];

[ coclass, requires_category("CATID_Control"),
  uuid("1e1a2436-f3ea-4ff3-80bf-5409370e8144")]
class CMyClass {};

必要条件

属性コンテキスト

対象

class、struct

複数回の適用

不可

必要な属性

coclass、progid、vi_progid の中から 1 つ以上

無効な属性

なし

属性コンテキストの詳細については、「属性コンテキスト」を参照してください。

参照

概念

COM 属性

implements_category

ATL サンプル