Compartilhar via


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:

Criar o projeto

Para criar um novo projeto no Visual Studio

  1. Inicie o Visual Studio.

  2. No menu Arquivo , aponte para Novoe clique em Projeto.

  3. No painel de modelos, expanda Visual C# ou Visual Basic e, em seguida, expanda Office/SharePoint.

  4. No nó Office/SharePoint expandido, selecione o nó Suplementos do Office.

  5. Na lista de modelos de projeto, selecione Suplemento do Project 2010 ou Suplemento do Project 2013.

  6. Na caixa Nome, digite FirstProjectAddIn.

  7. 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 classe ThisAddIn será definido em um arquivo de código oculto que você não deve modificar.

  • Manipuladores de eventos ThisAddIn_Startup e ThisAddIn_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

  1. 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 evento NewProject da classe Microsoft.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 classe ThisAddIn. O campo Application retorna o objeto Microsoft.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âmetro pj é um objeto Microsoft.Office.Interop.MSProject.Project, que representa o projeto. Para obter mais informações, consulte Soluções do Project.

  1. Se você estiver usando C#, adicione o código a seguir ao manipulador de eventos ThisAddIn_Startup. Esse código conecta o manipulador de eventos Application_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

  1. 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.

  2. Verifique se uma nova tarefa foi adicionada ao projeto em branco.

  3. Verifique se o texto a seguir aparece no campo Nome da Tarefa da tarefa.

    Este texto foi adicionado usando código.

  4. 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

  1. 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: