REQUIRED_CATEGORY
更新 : 2007 年 11 月
REQUIRED_CATEGORY マクロをコンポーネントのカテゴリ マップに追加して、そのマップが catID パラメータで識別されるカテゴリを必要とするものとして登録されるように指定します。
REQUIRED_CATEGORY(
catID
)
パラメータ
- catID
[入力] 必要とされるカテゴリのグローバル一意識別子 (GUID: Globally Unique Identifier) を保持する CATID の定数または変数。catID のアドレスが取得され、マップに追加されます。以下の表は、ストック カテゴリの選択肢です。
解説
クラスが OBJECT_ENTRY_AUTO マクロまたは OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO マクロに関連付けられている場合、マップに示されたコンポーネント カテゴリは、モジュールの登録時に自動的に登録されます。
クライアントはクラスに対して登録されたカテゴリ情報を使用して、そのクラスのインスタンスを作成せずに機能や要件を決定できます。たとえば、コントロールの中には、コンテナがデータ連結をサポートすることを要件とするものがあります。コンテナは、コントロールのホストに必要な機能を備えているかどうかについて、コントロールで必要とされるカテゴリをカテゴリ マネージャに問い合わせることにより確認できます。コンテナは、必要な機能をサポートしていない場合、COM オブジェクトのホストを拒否できます。
サンプルの一覧を含め、コンポーネント カテゴリの詳細については、Windows SDK の「What are Component Categories and how do they work?」を参照してください。
ストック カテゴリの選択肢
説明 |
シンボル |
レジストリ GUID |
|---|---|---|
スクリプト対応 |
CATID_SafeForScripting |
{7DD95801-9882-11CF-9FA9-00AA006C42C4} |
初期化対応 |
CATID_SafeForInitializing |
{7DD95802-9882-11CF-9FA9-00AA006C42C4} |
単純なフレーム サイト コンテインメント |
CATID_SimpleFrameControl |
{157083E0-2368-11cf-87B9-00AA006C8166} |
単純なデータ連結 |
CATID_PropertyNotifyControl |
{157083E1-2368-11cf-87B9-00AA006C8166} |
高度なデータ連結 |
CATID_VBDataBound |
{157083E2-2368-11cf-87B9-00AA006C8166} |
ウィンドウなしのコントロール |
CATID_WindowlessObject |
{1D06B600-3AE3-11cf-87B9-00AA006C8166} |
インターネット対応オブジェクト |
サンプルの一覧については、Windows SDK の「Internet Aware Objects」を参照してください。 |
|
使用例
BEGIN_CATEGORY_MAP(CMyWindow)
REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()
スマート デバイス開発者のためのメモ
スマート デバイス プロジェクトではサポートされません。
必要条件
ヘッダー : atlcom.h