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 |
複数回の適用 |
不要 |
必要な属性 |
以下の順で 1 つ以上の文字が続くコクラス、 progid、または vi_progid。 |
無効な属性 |
[なし] |
属性コンテキストの詳細については、「属性コンテキスト」を参照してください。