上下文参数
在 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）的布尔值。 |
另请参阅