Passo a passo: criação do seu primeiro suplemento do VSTO para o Project
Este passo a passo demonstra como criar um suplemento VSTO para o Microsoft Office Project. Esse recurso que você cria nesse tipo de solução estará disponível para o próprio aplicativo, independentemente de quais projetos estiverem abertos. Para obter mais informações, consulte Visão geral do desenvolvimento de soluções do Office (VSTO).
Aplica-se a: as informações neste tópico se aplicam a projetos do suplemento VSTO para o Project. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.
Este passo a passo ilustra as seguintes tarefas:
Criação de um projeto de suplemento VSTO do Project.
Gravação de código que usa o modelo de objeto do Project para adicionar uma tarefa a um novo projeto.
Criar e executar o projeto para testá-lo.
Limpar o projeto concluído para que o suplemento VSTO não seja mais executado automaticamente no computador de desenvolvimento.
Observação
Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.
Pré-requisitos
Você precisará dos seguintes componentes para concluir este passo a passo:
Uma edição do Visual Studio que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.
Project 2013 ou Project 2010.
Criar o projeto
Para criar um novo projeto no Visual Studio
Inicie o Visual Studio.
No menu Arquivo , aponte para Novoe clique em Projeto.
No painel de modelos, expanda Visual C# ou Visual Basic e, em seguida, expanda Office/SharePoint.
No nó Office/SharePoint expandido, selecione o nó Suplementos do Office.
Na lista de modelos de projeto, selecione Suplemento do Project 2010 ou Suplemento do Project 2013.
Na caixa Nome, digite FirstProjectAddIn.
Clique em OK.
O Visual Studio criará o projeto FirstProjectAddIn e abrirá o arquivo de código ThisAddIn no editor.
Gravação de código que adiciona uma nova tarefa a um projeto
Em seguida, adicione código ao arquivo de código ThisAddIn. O novo código usará o modelo de objeto do Project para adicionar uma nova tarefa a um projeto. Por padrão, o arquivo de código ThisAddIn contém o seguinte código gerado:
Uma definição parcial da classe
ThisAddIn
. Essa classe fornece um ponto de entrada para o código e oferece acesso ao modelo de objeto do Project. Para obter mais informações, consulte Suplementos do programa VSTO. O restante da classeThisAddIn
será definido em um arquivo de código oculto que você não deve modificar.Manipuladores de eventos
ThisAddIn_Startup
eThisAddIn_Shutdown
. Esses manipuladores de eventos são chamados quando o Project carrega e descarrega o suplemento VSTO. Use esses manipuladores de eventos para inicializar o suplemento VSTO quando ele for carregado e para limpar os recursos usados pelo suplemento VSTO quando ele for descarregado. Para obter mais informações, consulte Eventos em projetos do Office.
Para adicionar uma tarefa a um novo projeto
No arquivo de código ThisAddIn, adicione o código a seguir para definir a classe
ThisAddIn
. Esse código define um manipulador de eventos para o eventoNewProject
da classeMicrosoft.Office.Interop.MSProject.Application
.Quando o usuário criar um novo projeto, esse manipulador de eventos adicionará uma tarefa ao projeto.
void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj) { MSProject.Task newTask = pj.Tasks.Add ("This text was added by using code", missing); newTask.Start = DateTime.Now; newTask.Duration = "3"; newTask.ResourceNames = "Rob Caron, Kelly Krout"; }
Para modificar o projeto, este exemplo de código usa os seguintes objetos:
O campo
Application
da classeThisAddIn
. O campoApplication
retorna o objetoMicrosoft.Office.Interop.MSProject.Application
que representa a instância atual do Project.O parâmetro
pj
do manipulador de eventos para o evento NewProject. O parâmetropj
é um objetoMicrosoft.Office.Interop.MSProject.Project
, que representa o projeto. Para obter mais informações, consulte Soluções do Project.
Se você estiver usando C#, adicione o código a seguir ao manipulador de eventos
ThisAddIn_Startup
. Esse código conecta o manipulador de eventosApplication_Newproject
ao evento NewProject.this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
Testar o projeto
Ao compilar e executar o projeto, verifique se a nova tarefa aparece no novo projeto resultante.
Para testar o projeto
Pressione F5 para criar e executar o projeto. O Microsoft Project será iniciado e abrirá automaticamente um novo projeto em branco.
Quando você compila o projeto, o código é compilado em um assembly incluído na pasta de saída de compilação para o projeto. O Visual Studio também cria um conjunto de entradas do Registro que permitem que o Project descubra e carregue o suplemento VSTO e define as configurações de segurança no computador de desenvolvimento para permitir que o suplemento VSTO seja executado. Para obter mais informações, consulte Visão geral do processo de criação de soluções do Office.
Verifique se uma nova tarefa foi adicionada ao projeto em branco.
Verifique se o texto a seguir aparece no campo Nome da Tarefa da tarefa.
Este texto foi adicionado usando código.
Fechar o Microsoft Project.
Limpar o projeto
Quando terminar de desenvolver um projeto, remova o assembly do suplemento VSTO, as entradas do Registro e as configurações de segurança do computador de desenvolvimento. Caso contrário, o suplemento VSTO será executado sempre que você abrir o Microsoft Project no computador de desenvolvimento.
Para limpar seu projeto
- No Visual Studio, clique em Build no menu Limpar solução.
Próximas etapas
Agora que você criou um suplemento básico do VSTO para o Project, é possível aprender mais sobre como desenvolver suplementos do VSTO a partir destes tópicos:
Tarefas gerais de programação que é possível executar em Suplementos VSTO para Project: Suplementos VSTO de Programa.
Usando o modelo de objeto do Project: Soluções do Project.
Criando e depurando suplementos VSTO para o Project: Criar soluções do Office.
Implantando suplementos VSTO para o Project: Implantar uma solução do Office.