JScript 文件

更新:2007 年 11 月

自定义向导访问脚本引擎并为每个项目创建一个称为 Default.js 的 JScript 文件。它还包括 Common.js。这些文件包含使您可以访问 Visual Studio 和 Visual C++ 对象模型以自定义向导的 JScript 函数。(有关这些模型的列表,请参见设计向导。) 可将自己的函数添加到向导项目的 Default.js 文件中。若要从 JScript 文件访问向导对象模型或环境模型中的属性和方法,请分别用“wizard.”和“dte.”前置对象模型项。

例如:

function CreateCustomProject(strProjectName, strProjectPath)
{
   try
   {
      var strProjTemplatePath = wizard.FindSymbol('PROJECT_TEMPLATE_PATH');
var strProjTemplate = '';
      strProjTemplate = strProjTemplatePath + '\\default.vcproj';

      var Solution = dte.Solution;
      var strSolutionName = "";
      if (wizard.FindSymbol("CLOSE_SOLUTION"))
...

当在自定义向导中单击“完成”时,向导将在解决方案资源管理器的 Script Files 文件夹中加载 Default.js 文件。此 JScript 文件创建项目并呈现模板,然后在用户单击向导中的“完成”时将它们添加到解决方案中。

默认情况下,项目的 Default.js 文件包含以下函数:

函数名

说明

AddConfig

添加项目的配置。可以提供编译器和链接器设置。

AddFilesToCustomProj

当用户单击“完成”时,将指定的文件添加到项目中。

AddFilters

当用户单击“完成”时,将指定的源筛选器添加到项目中。

CreateCustomProject

当用户单击“完成”时,在指定位置创建项目。

CreateCustomInfFile

创建项目的 Templates.inf 文件

DelFile

删除指定的文件。

GetTargetName

获取指定文件的名称。

OnFinish

当用户单击“完成”时,由向导调用以创建项目、添加文件和筛选器、呈现模板以及设置配置。

PchSettings

设置预编译头设置。有关更多信息,请参见 Common.js 参考中的 SetCommonPchSettings

每个向导均具有唯一的 Default.js 文件,该文件包括的 TODO 注释可帮助您识别必须自定义文件的地方。

Visual C++ 还包括 Common.js,该文件在所有向导中共享并包含在向导项目中。可以使用 Common.js 中的函数。

说明:

Common.js 包含每个函数及其参数的说明。有关更多信息,请参见 Common.js 中的注释。

如果要在向导项目之间共享函数,可将它们添加到 Common.js 中。创建您自己的 Common.js 版本并将其保存在公共路径中,然后在 .vsz 文件中将 SCRIPT_COMMON_PATH 设置为此路径。

说明:

Visual C++ 包含的向导使用 Common.js 中的 JScript 函数。如果更改这些函数,Visual C++ 向导的行为可能异常。

有关 JScript 的更多信息,请参见 编写、编译、调试 JScript 代码

调试脚本

若要在向导 html 文件中调试脚本,必须启用脚本调试。

启用脚本调试

  1. 在 Internet Explorer 中,单击“工具”菜单并选择“Internet 选项”。

  2. 单击“高级”选项卡。

  3. 在“浏览”类别下,清除“禁止脚本调试”复选框。

当您单击向导上的“完成”按钮时,这还将允许 common.js 和 default.js 显示在“运行文档”窗口中。

请参见

任务

创建自定义向导

概念

为向导创建的文件

设计向导

参考

自定义向导