分类宏

这些宏定义类别映射。

宏	说明
BEGIN_CATEGORY_MAP	标记类别映射的开头。
END_CATEGORY_MAP	标记类别映射的末尾。
IMPLEMENTED_CATEGORY	指示 COM 对象实现的类别。
REQUIRED_CATEGORY	指示 COM 对象所需的容器类别。

要求

标头：atlcom.h

BEGIN_CATEGORY_MAP

标记类别映射的开头。

BEGIN_CATEGORY_MAP(theClass)

参数

theClass
[in] 包含类别映射的类的名称。

注解

类别映射用于指定 COM 类将实现的组件类别及其所需的容器类别。

将 IMPLEMENTED_CATEGORY 条目添加到 COM 类实现的每个类别的映射中。 将 REQUIRED_CATEGORY 条目添加到类要求其客户端实现的每个类别的映射中。 使用 END_CATEGORY_MAP 宏标记映射的末尾。

如果类具有关联的 OBJECT_ENTRY_AUTO 或 OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO，则注册模块时映射中列出的组件类别将自动注册。

注意

ATL 使用标准组件类别管理器来注册组件类别。 如果注册模块时系统中不存在管理器，则注册成功，但组件类别将不会注册该类。

有关组件类别的详细信息，请参阅 Windows SDK 中的组件类别是什么及其作用。

示例

BEGIN_CATEGORY_MAP(CMyCtrl)
   IMPLEMENTED_CATEGORY(CATID_Insertable)
END_CATEGORY_MAP()

END_CATEGORY_MAP

标记类别映射的末尾。

END_CATEGORY_MAP()

示例

请参阅有关 EGIN_CATEGORY_MAP 的示例。

IMPLEMENTED_CATEGORY

将 IMPLEMENTED_CATEGORY 宏添加到组件的类别映射中，以指定应将其注册为实现 catID 参数标识的类别。

IMPLEMENTED_CATEGORY(catID)

参数

catID
[in] 含实现类别的全局唯一标识符 (GUID) 的 CATID 常量或变量。 catID 的地址将获取并添加到映射中。 有关股票类别的选择，请参阅下表。

备注

如果类具有关联的 OBJECT_ENTRY_AUTO 或 OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO 宏，则注册模块时映射中列出的组件类别将自动注册。

客户端可以使用为该类注册的类别信息来确定其功能和要求，而无需创建其实例。

有关组件类别的详细信息，请参阅 Windows SDK 中的组件类别是什么及其作用。

股票类别的选择

说明	符号	注册表 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}
Internet-Aware 对象	有关示例列表，请参阅 Windows SDK 中的 Internet Aware 对象。

示例

BEGIN_CATEGORY_MAP(CMyCtrl)
   IMPLEMENTED_CATEGORY(CATID_Insertable)
END_CATEGORY_MAP()

REQUIRED_CATEGORY

将 REQUIRED_CATEGORY 宏添加到组件的类别映射中，以指定应将其注册为需要 catID 参数标识的类别。

REQUIRED_CATEGORY( catID )

参数

catID
[in] 含所需类别的全局唯一标识符 (GUID) 的 CATID 常量或变量。 catID 的地址将获取并添加到映射中。 有关股票类别的选择，请参阅下表。

备注

如果类具有关联的 OBJECT_ENTRY_AUTO 或 OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO 宏，则注册模块时映射中列出的组件类别将自动注册。

客户端可以使用为该类注册的类别信息来确定其功能和要求，而无需创建其实例。 例如，控件可能需要容器支持数据绑定。 容器可以通过查询类别管理器来查找该控件所需的类别，以确定它是否具有托管控件所需的功能。 如果容器不支持所需功能，则可能会拒绝托管 COM 对象。

有关组件类别（包括示例列表）的详细信息，请参阅 Windows SDK 中的组件类别是什么及其作用。

股票类别的选择

说明	符号	注册表 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}
Internet-Aware 对象	有关示例列表，请参阅 Windows SDK 中的 Internet Aware 对象。

示例

BEGIN_CATEGORY_MAP(CMyWindow)
   REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()

另请参阅

宏