ATL 控件向导
将 ATL 控件插入 ATL 项目(或支持 ATL 的 MFC 项目)。 你可以使用此向导插入以下三种控件之一:
标准控件
复合控件
DHTML 控件
此外,你可以指定一个最小控件,这将从“接口”列表中删除接口(这些接口是默认提供的,用于在大多数容器中打开控件)。 你可以在向导的“接口”页面中设置你希望控件支持的接口。
备注
此向导生成的注册脚本在 HKEY_CURRENT_USER(而不是 HKEY_LOCAL_MACHINE)下注册它的 COM 组件。 若要修改此行为,请设置 ATL 向导的“为所有用户注册组件”选项。
名称
命名要添加到项目中的对象、接口和类。 除了“短名称”外,其他所有框都可以独立更改。 如果你更改“短名称”的文本,更改会反映在此页中其他所有框的名称中。 如果你更改 COM 部分中的 Coclass 名称,更改会反映在“类型”框中,但“接口”名称和“编程 ID”不会改变。 此命名行为旨在方便你在开发控件时可轻松识别所有名称。
注意
“组件类”仅对非特性化控件可编辑。 如果项目已特性化,便无法编辑“组件类”。
C++
提供为了实现对象而创建的 C++ 类的信息。
短名称
设置对象的缩写名称。 你提供的名称确定类和 Coclass 名称、文件(.CPP 和 .H)名称、接口名称和类型名称,除非你单独更改这些字段。
类
设置用于实现对象的类的名称。 此名称以你在“短名称”中提供的名称为依据,跟在典型的类名前缀“C”后面。
.h 文件
为新项目的类的头文件设置名称。 默认情况下,此名称以你在“短名称”中提供的名称为依据。 单击省略号按钮以将该文件名保存至所选择的位置,或追加到某个现有文件的类声明中。 如果你选择现有文件,除非你单击“完成”,否则向导不会将文件保存到选定位置。
向导不会覆盖文件。 如果选择现有文件的名称,当你单击“完成”时,向导会询问你是否要将该类声明追加至文件的内容中。 单击“是”,则追加该文件;单击“否”,则返回至向导并指定另一个文件名。
.cpp 文件
为新项目的类的实现文件设置名称。 默认情况下,此名称以你在“短名称”中提供的名称为依据。 单击省略号按钮以将文件名保存到所选位置。 向导在你单击“完成”之前不会将该文件保存到所选位置。
向导不会覆盖文件。 如果选择现有文件的名称,当你单击“完成”时,向导会询问你是否要将该类实现追加至文件的内容中。 单击“是”,则追加该文件;单击“否”,则返回至向导并指定另一个文件名。
特性化
指明对象是否使用特性。 若要将对象添加到特性化 ATL 项目,在选中此选项后便无法更改。 也就是说,只能将特性化对象添加到创建的支持特性的项目中。
只能将特性化对象添加到使用特性的 ATL 项目中。 如果你对不支持特性的 ATL 项目选中此选项,向导会提示你指定是否要向项目添加特性支持。
默认情况下,在设置此选项后添加的任何对象都被指定为特性化对象(复选框处于选中状态)。 可以取消选中此框来添加不使用特性的对象。
有关详细信息,请参阅 ATL 项目向导的“应用程序设置”和特性的基本机制。
COM
提供对象的 COM 功能的相关信息。
组件类
设置包含对象支持的接口列表的组件类的名称。
注意
如果使用特性创建项目,或在此向导页上指明空间使用特性,便无法更改这一选项,因为 ATL 不包括 coclass 特性。
Interface
设置对象的接口名称。 默认情况下,接口名称前面带有“I”。
类型
设置注册表中显示的对象说明
编程 ID
设置容器可用来代替对象 CLSID 的名称。 此字段不会自动填充。 如果你不手动填充此字段,则该控件可能对其他工具不可用。 例如,如果生成的 ActiveX 控件不含
ProgID
,则在“插入 ActiveX 控件”对话框中不可用。 有关此对话框的更多信息,请参阅 插入 ActiveX 控件。