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


Интерфейс Wizard (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
   );

Механизм аналогичен для обоих start Создать проект и Добавление нового элемента мастера. Для запуска то вызывается метод 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
    

См. также

Основные понятия

контекстные параметры

пользовательские параметры

Файл мастера (.Vsz)

Другие ресурсы

Мастера