通过

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

  • 项目

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

有三种不同的向导类型：

  • 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 文件为“添加项”和“新建项目”对话框添加向导