Поделиться через

Интерфейс мастера (IDTWizard)

  • Статья

Интегрированная среда разработки (IDE) использует IDTWizard интерфейс для взаимодействия с мастерами. Мастера должны реализовать этот интерфейс для установки в интегрированной среде разработки.

Этот Execute метод является единственным методом, связанным с интерфейсом IDTWizard . Мастера реализуют этот метод и интегрированная среда разработки вызывает метод в интерфейсе. В следующем примере показана сигнатура метода.

/* 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. Интегрированная среда разработки вызывает Execute метод в мастере, передав ему следующее:

  • Объект DTE

    Объект DTE является корнем модели автоматизации.

  • Дескриптор диалогового окна, как показано в сегменте hwndOwner ([in] long)кода.

    Мастер использует это hwndOwner в качестве родительского элемента для диалогового окна мастера.

  • Параметры контекста, передаваемые интерфейсу в качестве варианта для SAFEARRAY, [in] SAFEARRAY (VARIANT)* ContextParamsкак показано в сегменте кода.

    Параметры контекста содержат массив значений, относящихся к типу запускаемого мастера и текущему состоянию проекта. Интегрированная среда разработки передает параметры контекста мастеру. Дополнительные сведения см. в разделе "Параметры контекста".

  • Пользовательские параметры, передаваемые интерфейсу в качестве варианта для SAFEARRAY, [in] SAFEARRAY (VARIANT)* CustomParamsкак показано в сегменте кода.

    Пользовательские параметры содержат массив пользовательских параметров. VSZ-файл передает пользовательские параметры интегрированной среде разработки. Значения определяются операторами Param= . Дополнительные сведения см. в разделе "Пользовательские параметры".

  • Возвращаемые значения для интерфейса:

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

См. также