Compartilhar via

Parâmetros de contexto para iniciar assistentes

  • Artigo

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Os parâmetros de contexto fornecem informações necessárias para iniciar um assistente, como o tipo de assistente a ser usado, o nome do projeto, os diretórios para itens do assistente etc.

Há três tipos diferentes de assistentes:

  • NewProject — Adiciona um novo projeto a uma solução.

  • AddSubProject — adiciona um subprojeto a um projeto existente.

  • AddItem — Adicione um item a um projeto existente.

Todos os três tipos de assistentes são chamados com o método Execute da interface de IDTWizard. Um parâmetro obrigatório do método Execute é ContextParams. Cada tipo requer um conjunto diferente de valores de ContextParams na ordem correta de acordo com a tabela a seguir:

Tipo do assistente

Parâmetros usados

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silencioso

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silencioso

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silencioso

A tabela a seguir lista todos os parâmetros de contexto e suas descrições.

Configuração

Descrição

WizardType

Uma constante que indica o tipo de assistente. Há três tipos:

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

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

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

ProjectName

O nome do projeto.

ProjectItems

Um ponteiro para a coleção de ProjectItems em que o assistente operará. Isso é passado ao assistente com base na seleção de hierarquia do projeto.

LocalDirectory

O local no sistema local onde os arquivos de projeto em andamento do assistente são armazenados.

ItemName

O tipo do item a ser adicionado. ItemName é o nome de arquivo que o usuário digita (ou que é aceito por padrão) na caixa de diálogo Adicionar Item. Dependendo dos sinalizadores definidos no arquivo de VSDIR, esta configuração pode ser NULL.

InstallationDirectory

O caminho do diretório onde o Visual Studio está instalado.

FExclusive

Um valor booleano que indica se o projeto deve ser exclusivo em si mesmo. Isto é, ou o projeto é adicionado à solução atual ou o sistema fecha a solução atual, cria uma nova e adiciona o projeto a ela.

SolutionName

O nome para o arquivo de solução sem a parte do diretório ou a extensão .sln. (O nome de arquivo .suo também é baseado nesse nome raiz.) Se SolutionName contém um valor (ou seja, se não é uma cadeia de caracteres vazia), o assistente de NewProject chama Create antes de adicionar o projeto com AddFromTemplate. No entanto, se SolutionName for uma cadeia de caracteres vazia, você não precisará chamar Createantes de chamar AddFromTemplate.

Silent

Um valor booleano que indica se o assistente deve executar silenciosamente, sem exibir uma interface de usuário (UI), levando todos os valores padrão. O valor padrão para Silent é True.

Consulte também

Referência

Execute

IDTWizard

Conceitos

Adicionando assistentes às caixas de diálogo Adicionar Item e Novo Projeto usando arquivos .Vsdir