ATL 简单对象向导

此向导将最小的 COM 对象插入到项目中。 使用此向导页指定标识对象及其 COM 功能的 C++ 类和文件的名称。

使用此向导的选项页指定对象的线程模型和聚合支持,以及它是否支持双重接口和自动化。 也可以指定错误信息接口支持、连接点、Internet Explorer 支持和自由线程封送处理。

备注

从 Visual Studio 2008 开始,此向导生成的注册脚本将在 HKEY_CURRENT_USER(而不是 HKEY_LOCAL_MACHINE)下注册其 COM 组件。 若要修改此行为,请设置 ATL 向导的**“为所有用户注册组件”**选项。

名称

指定要添加到项目中的对象、接口和类的名称。 除“简称”外,所有其他框都可以独立于其他框进行编辑。 如果更改“简称”的文本,更改会反映在此页的所有其他框的名称中。 如果更改 COM 部分中的“CoClass”名称,则更改反映在“类型”和“ProgID”框中,但“接口”名称不更改。 此命名行为旨在使所有名称在开发控件时易于识别。

备注

Coclass 仅对非特性化项目可编辑。如果项目已特性化,则无法编辑 Coclass

C++

提供为对象创建的 C++ 类的信息。

  • 简称
    设置对象的缩写名称。 您提供的名称确定 Class 和 Coclass 名称、.cpp 文件.h 文件名称、接口名称、类型名称以及 ProgID,除非单独更改这些字段。

  • .h 文件
    为新对象的类设置头文件的名称。 默认情况下,此名称基于在“简称”中提供的名称。 单击省略号按钮将该文件名保存到所选位置,或将类声明追加到现有文件。 如果选择现有文件,则直到在向导中单击**“完成”**时,向导才将其保存到所选位置。

    向导不覆盖文件。 如果选择现有文件的名称,则单击**“完成”时,向导会提示您指出是否应向该文件的内容中追加类声明。 单击“是”追加该文件;单击“否”**返回到向导并指定另一个文件名。


  • 设置要创建的类的名称。 此名称基于在**“简称”**中提供的名称,名称前有一个“C”,这是典型的类名前缀。

  • .cpp 文件
    为新对象的类设置实现文件的名称。 默认情况下,此名称基于在“简称”中提供的名称。 单击省略号按钮将文件名保存到所选位置。 直到在向导中单击**“完成”**时,该文件才保存到所选位置。

    向导不覆盖文件。 如果选择现有文件的名称,则单击**“完成”时,向导会提示您指出是否应向该文件的内容中追加类实现。 单击“是”追加该文件;单击“否”**返回到向导并指定另一个文件名。

  • 特性化
    指示对象是否使用特性。 如果将某个对象添加到特性化 ATL 项目中,则此选项被选定而且无法更改。 即只能将特性化对象添加到创建的具有特性支持的项目中。

    只可向使用特性的 ATL 项目添加特性化对象。 如果为不具有特性支持的 ATL 项目选择此选项,则向导将提示您指定是否为项目添加特性支持。

    默认情况下,设置此选项后添加的任何对象都被指定为特性化(选中此复选框)。 可清除此框以添加不使用特性的对象。

    有关更多信息,请参见 ATL 项目向导的应用程序设置特性的基本机制

COM

提供有关该对象的 COM 功能的信息。

  • Coclass
    设置组件类的名称,该组件类包含对象支持的接口列表。

    备注

    如果使用特性创建项目,或者在此向导页中指示对象使用特性,则不能更改此选项,因为 ATL 不包括 coclass 特性。

  • Type
    设置将显示在注册表中的对象说明。

  • 接口
    设置为对象创建的接口。 此接口包含自定义方法。

  • ProgID
    设置容器可用来代替对象的 CLSID 的名称。

请参见

任务

添加 ATL 简单对象