Интерфейс IDTWizard

Оценить
(0 голоса)

Для подключения к движку мастеров Visual Studio ваш класс wizard должен реализовать интерфейс EnvDTF.. IDTWizard. Этот интерфейс определяет единственный метод (Execute), который вызывается средой Visual Studio при каждом запуске мастера. Вот про­тотип для методаIDTWizard.Execute (на языке С#):

void Execute (

Object Application,

i n L hwr.dOwne r,

ret Objocl[] ContextParams,

ref ObjeclU CusLortParams,

out wizardRcsult retval

Передаваемые в метод Execute аргументы используются для связи мастера со средой Visual Studio и для передачи мастеру необходимых данных:

□    Application — экземпляр DTE для интегрированной среды Visual Studio;

□    hwndOwner — дескриптор родительского окна; это окно будет родителем для всех эле­ментов пользовательского интерфейса, созданных мастером;

□    Context Ра rams — для мастеров New Project | Add New Item используется массив объ­ектов для передачи информации о типе мастера (который был запущен), а также раз­личных данных, необходимых для работы мастера (таких как название проекта и ката­лог для инсталляции);

□    CustomParams — массив объектов, используемый для любых параметров, которые вы определили для вашего мастера;

□    wizardResult — значение перечисления wizardResult, которое указывает результат работы мастера.

Содержимое параметра Context Params будет изменяться в зависимости от типа мастера. Например, для мастера New Project Wizard третье значение в массиве ContextParams пред­ставляет собой то местоположение, куда будет сохранен файл проекта (называемое LocalDirectory). Но для мастера Add Item Wizard третье значение массива является указате­лем на коллекцию Projectltems. В табл. 13.6 показано соответствие различных элементов массива трем разным типам мастеров.

Для определения результатов работы мастера вы должны обратиться к значению, помещен­ному в параметр wizardResult. В табл. 13.7 перечислены значения перечисления

wizardResult. Описание: C:\Users\Артём\Desktop\media\image312.png

Содержимое метода Execute зависит от вас. В теле этого метода вам понадобится реализо­вать весь код, необходимый для выполнения работы мастера и отображения пользователь­ского интерфейса для пользователя.

Примечание

Несмотря на то, что мастера кажутся вам последовательностью страниц, перемеще­ние по которым происходит при помощи кнопок Next и Back, мастер для Visual Studio является COM-объектом, который реализует IDTWizard. Фактически мастеру вовсе не нужно отображать пользовательский интерфейс. Он может, например, просто ис­пользовать переданные ему параметры для выполнения некоторой работы.

Файлы с расширениями vsz и vsdir
Создание мастера Add New Item Wizard
Реализация метода Execute
Использование файла шаблона
Выполнение мастера

Добавить комментарий


Защитный код
Обновить

© 2017 www.visualstudios.ru. Все права защищены.