向导界面 (IDTWizard)

  • 项目

集成开发环境（IDE）使用 IDTWizard 接口与向导通信。 向导必须实现此接口才能安装在 IDE 中。

该方法 Execute 是唯一与 IDTWizard 接口关联的方法。 向导实现此方法，IDE 在接口上调用该方法。 以下示例显示了方法的签名。

/* IDTWizard Method */
STDMETHOD(Execute)(THIS_
   /* [in] */ IDispatch *Application,
   /* [in] */ long hwndOwner,
   /* [in] */ SAFEARRAY * *ContextParams,
   /* [in] */ SAFEARRAY * *CustomParams,
   /* [out] [in] */ wizardResult *RetVal
   );

“新建项目”和“添加新项”向导的启动机制相似。 若要启动任一操作，请调用 IDTWizard 在 Dteinternal.h 中定义的接口。 唯一的区别是调用接口时传递给接口的上下文和自定义参数集。

以下信息描述了 IDTWizard 向导必须实现的接口才能在 Visual Studio IDE 中工作。 IDE 在向导上调用 Execute 该方法，并传递以下内容：

  • DTE 对象

    DTE 对象是自动化模型的根目录。

  • 窗口对话框的句柄，如代码段 hwndOwner ([in] long)所示。

    向导将此 hwndOwner 用作向导对话框的父级。

  • 作为 SAFEARRAY 变体传递给接口的上下文参数， [in] SAFEARRAY (VARIANT)* ContextParams如代码段所示。

    上下文参数包含特定于正在启动的向导类型以及项目的当前状态的值数组。 IDE 将上下文参数传递给向导。 有关详细信息，请参阅 上下文参数。

  • 作为 SAFEARRAY 变体传递给接口的自定义参数， [in] SAFEARRAY (VARIANT)* CustomParams如代码段所示。

    自定义参数包含用户定义的参数数组。 .vsz 文件将自定义参数传递给 IDE。 这些值由 Param= 语句确定。 有关详细信息，请参阅 自定义参数。

  • 接口的返回值为

    wizardResultSuccess = -1,
wizardResultFailure = 0
wizardResultCancel = 1
wizardResultBackout = 2

另请参阅