ATL 简单对象向导

  • 项目

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

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

备注

自 Visual Studio 2008 起，此向导生成的注册脚本在 HKEY_CURRENT_USER（而不是 HKEY_LOCAL_MACHINE）下注册它的 COM 组件。 若要修改此行为，请设置 ATL 向导的“为所有用户注册组件”选项。

名称

命名要添加到项目中的对象、接口和类。 除了“短名称”外，其他所有框都可以独立于其他框编辑。 如果你更改“短名称”的文本，更改会反映在此页中其他所有框的名称中。 如果你更改 COM 部分中的“组件类”名称，更改会反映在“类型”和“编程 ID”框中，但“接口”名称不会改变。 此命名行为旨在方便你在开发控件时可轻松识别所有名称。

注意

“组件类”仅对非特性化项目可编辑。 如果项目已特性化，便无法编辑“组件类”。

C++

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

  • 短名称

    设置对象的缩写名称。 你提供的名称决定了“Class”和“Coclass”名称、“.cpp文件”和“.h 文件”名称、“接口”名称、“类型”名称和“编程 ID”，除非你单独更改这些字段。

  • .h 文件

    为新项目的类的头文件设置名称。 默认情况下，此名称以你在“短名称”中提供的名称为依据。 单击省略号按钮以将该文件名保存至所选择的位置，或追加到某个现有文件的类声明中。 如果你选择现有文件，除非你单击向导中的“完成”，否则向导不会将文件保存到选定位置。

    向导不会覆盖文件。 如果选择现有文件的名称，当你单击“完成”时，向导会询问你是否要将该类声明追加至文件的内容中。 单击“是”，则追加该文件；单击“否”，则返回至向导并指定另一个文件名。

  • 类

    设置要创建的类的名称。 此名称以你在“短名称”中提供的名称为依据，跟在典型的类名前缀“C”后面。

  • .cpp 文件

    为新项目的类的实现文件设置名称。 默认情况下，此名称以你在“短名称”中提供的名称为依据。 单击省略号按钮以将文件名保存到所选位置。 向导在你单击“完成”之前不会将该文件保存到所选位置。

    向导不会覆盖文件。 如果选择现有文件的名称，当你单击“完成”时，向导会询问你是否要将该类实现追加至文件的内容中。 单击“是”，则追加该文件；单击“否”，则返回至向导并指定另一个文件名。

  • 特性化

    指明对象是否使用特性。 若要将对象添加到特性化 ATL 项目，在选中此选项后便无法更改。 也就是说，只能将特性化对象添加到创建的支持特性的项目中。

    只能将特性化对象添加到使用特性的 ATL 项目中。 如果你对不支持特性的 ATL 项目选中此选项，向导会提示你指定是否要向项目添加特性支持。

    默认情况下，在设置此选项后添加的任何对象都被指定为特性化对象（复选框处于选中状态）。 可以取消选中此框来添加不使用特性的对象。

    有关详细信息，请参阅 ATL 项目向导的“应用程序设置”和特性的基本机制。

COM

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

  • 组件类

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

    注意

    如果使用特性创建项目，或在此向导页上指明对象使用特性，便无法更改此选项，因为 ATL 不包括 coclass 特性。

  • 类型

    设置注册表中显示的对象说明

  • Interface

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

  • 编程 ID

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

另请参阅

ATL 简单对象