向导 .vsz 文件中的自定义参数

更新:2007 年 11 月

.vsz 文件的头两行标识向导版本和要共同创建的向导的 ProgID 或 CLSID。.vsz 文件还可包括可选的上下文参数和自定义参数,这些参数与 HTML 符号节提供的符号一起添加到符号表中。

Execute 方法显示向导,它将 .vsz 文件中定义的一系列上下文和自定义参数作为它的参数。

.vsz 文件或 .htm 文件中,以下常用符号被指定为自定义参数,它们可用于向导 HTML、脚本或模板文件。

示例

如下面的 .vsz 文件项所示,名为 MyProjWiz 的向导包含用户界面。

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"

向导 .vsz 文件中自定义参数的符号

符号

定义

ABSOLUTE_PATH

向导文件的位置。

HTML_FILTER

在 .vsz 文件中指定。放置在解决方案资源管理器的 HTML Files 文件夹中的文件类型。通常指定为“htm”。

HTML_PATH

在 .vsz 文件中指定。向导的 HTML 文件的位置。默认情况下为 START_PATH\HTML\LANGUAGE(其中 LANGUAGE 是系统注册表指定的区域设置)。

说明:

通过将 <LangID> 设置为 HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage 的十进制值,可以指定其他语言。有关更多信息,请参见将向导本地化为多种语言。有关十进制语言值的列表,请参见其他语言的向导支持

IMAGE_FILTER

在 .vsz 文件中指定。放置在解决方案资源管理器的 Image Files 文件夹中的文件类型。通常指定为“bmp;gif”。

IMAGES_PATH

在 .vsz 文件中指定。html 文件中使用的图像文件的位置。默认情况下为 START_PATH\Images。

MISC_FILTER

在 .vsz 文件中指定。放置在解决方案资源管理器的 Misc 文件夹中的文件类型。通常指定为“vsz;vsdir;ico;vcproj;csproj;css;inf”。

PRODUCT

默认情况下设置为 Visual C++;然而,可将该值设置为 Visual Basic 以创建 Visual Basic 向导,等等。

PRODUCT_INSTALLATION_DIR

在注册表的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ProductDir 处列出的目录。

PROJECT_TEMPLATE_NAME

在 .vsz 文件中指定。向导用于创建项目的项目模板文件。通常指定为“txt”。

PROJECT_TEMPLATE_PATH

包含项目的模板文件的目录。对于 Visual C++,默认情况下为 PRODUCT_INSTALLATION_DIR\VCWizards。

RELATIVE_PATH

如果未找到 ABSOLUTE_PATH,则考虑使用 RELATIVE_PATH。这是相对于 PRODUCT_INSTALLATION_DIR 的路径。对于 Visual C++,RELATIVE_PATH 是 PRODUCT_INSTALLATION_DIR\VCWizards。

SCRIPT_COMMON_PATH

相对于 PRODUCT_INSTALLATION_DIR 的目录名,在此处可找到公共脚本文件。例如,对于 Visual C++,它是 VCWizards。

SCRIPT_FILTER

在 .vsz 文件中指定。放置在解决方案资源管理器的 Script Files 文件夹中的文件类型。通常指定为“js”(JScript) 或“vbs”(VBScript)。

SCRIPT_PATH

向导的 JScript 文件的位置。默认情况下为 START_PATH\Scripts。

START_PATH

在 .vsz 文件中指定。它不是由用户设置,但在内部用于标识 RELATIVE_PATH 或 ABSOLUTE_PATH。将向导名 (WIZARD_NAME) 追加到该值。

TEMPLATE_FILTER

在 .vsz 文件中指定。放置在解决方案资源管理器的 Template Files 文件夹中的文件类型。通常指定为“txt”。

TEMPLATES_PATH

在 .vsz 文件中指定。向导的模板文件的位置。默认情况下为 START_PATH\Templates\<LangID>。

说明:

有关 LangID 的更多信息,请参见 HTML_PATH。

WIZARD_NAME

指定向导名。位于 .vsz 中并由其余的符号使用。

WIZARD_UI

在 .vsz 文件中指定。Boolean 值,指示向导是否包含用户界面。如果包含用户界面,则指定 TRUE;如果不包含用户界面,则指定 FALSE

请参见

任务

创建自定义向导

概念

为向导创建的文件

设计向导

参考

自定义向导

Execute