通过

用于启动向导的上下文参数

  • 项目

上下文参数提供启动向导所需的信息，例如要使用的向导的类型、项目的名称、向导项的目录等。

有三种不同的向导类型：

  • NewProject — 将新项目添加到解决方案中。

  • AddSubProject — 将子项目添加到现有项目中。

  • AddItem — 将项添加到现有项目中。

所有这三种类型的向导都是通过 IDTWizard 接口的 Execute 方法调用的。 Execute 方法的一个必选参数为 ContextParams。 每种类型都需要不同的一组 ContextParams 值，这些值按下表给出的正确顺序排列：

向导类型

使用的参数

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

下表列出了所有的上下文参数和它们的说明。

设置

说明

WizardType

指示向导类型的常数。 有三种类型：

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

项目的名称。

ProjectItems

指向向导将在其上操作的 ProjectItems 集合的指针。 此指针根据项目层次结构选定内容传递到向导。

LocalDirectory

本地系统上存储向导的工作项目文件的位置。

ItemName

要添加的项的名称。 ItemName 是用户在“添加项”对话框中键入（或默认情况下接受）的文件名。 根据 VSDIR 文件中设置的标志，此设置可能为 NULL。

InstallationDirectory

安装 Visual Studio 的目录路径。

FExclusive

一个布尔值，指示项目是否应该独占自身。 也就是说，要么项目添加到当前解决方案，要么系统关闭当前解决方案，创建一个新的解决方案，然后将项目添加到该解决方案中。

SolutionName

没有目录部分或 .sln 扩展名的解决方案名称。 （.suo 文件名也基于此根目录名称。）如果 SolutionName 包含值（即不是空字符串），则 NewProject 向导在用 AddFromTemplate 添加项目之前应调用 Create。 但是，如果 SolutionName 是空字符串，则在调用 AddFromTemplate 之前不需要调用 Create。

Silent

一个布尔值，指示向导是否应采用无提示运行，即不显示用户界面 (UI)，并接受所有默认值。 Silent 的默认值为 True。

请参见

参考

Execute

IDTWizard

概念

使用 .Vsdir 文件为“添加项”和“新建项目”对话框添加向导