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


Контекстные параметры для запуска мастеров

Контекстные параметры предоставляют сведения, необходимые для запуска мастера, такие как тип используемого мастера, имя проекта, папки для элементов мастера и пр.

Имеется три различных типа мастеров:

  • NewProject — добавляет новый проект в решение.

  • AddSubProject — добавляет подпроект в существующий проект.

  • AddItem — добавляет элемент в существующий проект.

Все три типа мастеров вызываются при помощи метода Execute интерфейса IDTWizard. Одним обязательным параметром метода Execute является ContextParams. Каждому типу требуется разный набор значений ContextParams в правильном порядке, как описано в следующей таблице:

Тип мастера

Используемые параметры

NewProject

  • WizardType

  • Имя_проекта

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • Имя_решения

  • Silent

AddSubProject

  • WizardType

  • Имя_проекта

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • Имя_проекта

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

В нижеследующей таблице перечислены все контекстные параметры с описаниями.

Параметр

Описание

WizardType

Константа, обозначающая тип мастера. Всего имеется три типа:

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Имя проекта.

ProjectItems

Указатель на коллекцию ProjectItems, с которой будет работать мастер. Он передается мастеру на основе выбранной иерархии проекта.

LocalDirectory

Расположение локальной системы, в которой хранятся файлы рабочего проекта мастера.

ItemName

Имя добавляемого элемента. ItemName — это имя файла, введенное пользователем (или подставленное по умолчанию) в диалоговом окне Добавить элемент. В зависимости от набора флагов в файле VSDIR этот параметр может быть равен NULL.

InstallationDirectory

Путь к каталогу, из котором установлен Visual Studio.

FExclusive

Логическое значение, указывающее, должен ли проект быть единственным проектом в решении. Это означает, что либо проект добавляется в текущее решение, либо система закрывает текущее решение, открывает новое и добавляет в него проект.

SolutionName

Имя файла решения без указания папки и расширения SLN. (Имя файла SUO также основывается на этом корневом имени.) Если SolutionName содержит значение (т. е. отличное от пустой строки), мастер NewProject вызывает Create перед добавлением проекта с AddFromTemplate. Если SolutionName представляет собой пустую строку, не нужно вызывать Createперед вызовом AddFromTemplate.

Silent

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

См. также

Ссылки

Execute

IDTWizard

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

Добавление мастеров в диалоговые окна "Добавить элемент" и "Создать проект" при помощи файлов VSDIR