上下文参数

在 Visual Studio 集成开发环境(IDE)中,可以将向导添加到 “新建项目”、“ 添加新项”或 “添加子项目 ”对话框。 添加的向导可在“文件”菜单上或通过右键单击解决方案资源管理器中的项目来使用。 IDE 将上下文参数传递给向导的实现。 上下文参数定义在 IDE 调用向导时项目的状态。

IDE 通过设置 VSADDITEMOPERATION IDE 对项目方法的调用 AddItem 中的标志来启动向导。 设置后,项目必须使用注册的向导名称或 GUID 以及 IDE 传递给它的其他上下文参数来 IVsExtensibility::RunWizardFile 执行该方法。

新项目的上下文参数

参数 说明
WizardType 已注册的向导类型 (vsWizardNewProject) 或指示向导类型的 GUID。 在 Visual Studio SDK 实现中,向导的 GUID 为 {0F90E1D0-4999-11D1-B6D1-00A0C90F2744}。
ProjectName 一个字符串,它是唯一的 Visual Studio 项目名称。
LocalDirectory 工作项目文件的本地位置。
InstallationDirectory Visual Studio 的目录路径正在安装。
FExclusive 指示项目应关闭打开的解决方案的布尔标志。
SolutionName 不带目录部分或 .sln 扩展名的解决方案文件的名称。 .suo 文件名也是使用 SolutionName. 如果此参数不是空字符串,向导在添加项目AddFromTemplate之前使用 Create 。 如果此名称为空字符串,则无需调用Create即可使用AddFromTemplate
Silent 指示向导是否应以静默方式运行(如 单击“完成TRUE)的布尔值。

添加新项的上下文参数

参数 说明
WizardType 已注册的向导类型 (vsWizardAddItem) 或指示向导类型的 GUID。 在 Visual Studio SDK 实现中,向导的 GUID 为 {0F90E1D1-4999-11D1-B6D1-00A0C90F2744}。
ProjectName 一个字符串,它是唯一的 Visual Studio 项目名称。
ProjectItems 包含工作项目文件的本地位置。
ItemName 要添加的项的名称。 此名称是用户从 “添加项 ”对话框中键入的默认文件名或文件名。 该名称基于 .vsdir 文件中设置的标志。 该名称可以是 null 值。
InstallationDirectory Visual Studio 的目录路径正在安装。
Silent 指示向导是否应以静默方式运行(如 单击“完成TRUE)的布尔值。

添加子项目的上下文参数

参数 说明
WizardType 已注册的向导类型 (vsWizardAddSubProject) 或指示向导类型的 GUID。 在 Visual Studio SDK 实现中,向导的 GUID 为 {0F90E1D2-4999-11D1-B6D1-00A0C90F2744}。
ProjectName 一个字符串,它是唯一的 Visual Studio 项目名称。
ProjectItems 指向 ProjectItems 向导在其上运行的集合的指针。 此指针根据项目层次结构选择传递到向导。 用户通常会选择要在其中放置项的文件夹,然后调用项目的 “添加项 ”对话框。
LocalDirectory 工作项目文件的本地位置。
ItemName 要添加的项的名称。 此名称是用户从 “添加项 ”对话框中键入的默认文件名或文件名。 该名称基于 .vsdir 文件中设置的标志。 该名称可以是 null 值。
InstallationDirectory Visual Studio 安装的目录路径。
Silent 指示向导是否应以静默方式运行(如 单击“完成TRUE)的布尔值。

另请参阅