Demonstra Passo a passo: Criando o primeiro nível do aplicativo Add-in do projeto

Artigo
08/08/2011

Esta explicação passo a passo mostra como criar um suplemento em nível de aplicativo para o projeto de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis para o aplicativo propriamente dito, independentemente de quais projetos estão abertos. For more information, see Visão geral de desenvolvimento de soluções do Office.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Project 2007 e Project 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

Criando um projeto de suplemento do projeto.
Escrevendo código que usa o modelo de objeto de projeto para adicionar uma tarefa para um novo projeto.
A criação e execução do projeto para testá-lo.
Limpando o projeto concluído para que o suplemento não executa mais automaticamente no computador de desenvolvimento.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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, consulte Configurações do Visual Studio.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

O Project 2007 Microsoft Office ou Project 2010.

Creating the Project

Para criar um novo projeto em Visual Studio

Start Visual Studio.
On the File menu, point to New, and then click Project.
No painel templates, expanda Visual C# ou Visual Basice em seguida, expanda Office.
Em expandida Office nó, selecione o 2007 se você tiver o Project 2007 instalado, ou selecione o 2010 o nó se você tiver Project 2010 instalado.
Na lista de modelos de projeto, selecione suplemento do Project 2007 ou suplemento do Microsoft Project 2010.
No nome , digite FirstProjectAddIn.
Click OK.

Visual Studiocria o FirstProjectAddIn de projeto e abre o ThisAddIn arquivo de código no editor.

Escrever código que adiciona uma nova tarefa a um projeto

Em seguida, adicione o código para o arquivo de código ThisAddIn. O novo código usa o modelo de objeto de projeto 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 ThisAddIn classe. Essa classe fornece um ponto de entrada para o seu código e fornece acesso ao modelo de objeto do projeto. For more information, see Os suplementos de nível de aplicativo de programação.. O restante do ThisAddIn classe é definida em um arquivo de código oculto que você não deve modificar.
O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o projeto carrega e descarrega o suplemento. Use esses manipuladores de evento para inicializar seu suplemento quando ele for carregado e limpar os recursos usados por seu suplemento, quando ela é descarregada. For more information, see Eventos em projetos do Office.

Para adicionar uma tarefa para um novo projeto.

No arquivo de código ThisAddIn, adicione o seguinte código para o ThisAddIn classe. Esse código define um manipulador de eventos para o NewProject o evento da Microsoft.Office.Interop.MSProject.Application classe.

Quando o usuário cria um novo projeto, o manipulador de evento adiciona uma tarefa ao projeto.

Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout"
End Sub

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 use os seguintes objetos:

O Application campo de ThisAddIn classe. O Application campo retorna um Microsoft.Office.Interop.MSProject.Application o objeto, que representa a instância atual do projeto.
O pj parâmetro do manipulador de eventos para o NewProject de evento. O pj parâmetro é um Microsoft.Office.Interop.MSProject.Project o objeto, que representa o projeto. For more information, see Solução de projeto.

Se você estiver usando o C#, adicione o seguinte código para o ThisAddIn_Startup manipulador de eventos. Esse código conecta-se a Application_Newproject o manipulador de eventos com o NewProject evento.
```
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
```

Testing the Project

Quando você compilar e executa o projeto, verifique se que a nova tarefa aparece no novo projeto resultante.

Para testar o projeto.

Pressione F5 para criar e executar seu projeto. Microsoft Project inicia e abre automaticamente um novo projeto em branco.

Quando você constrói o projeto, o código é compilado em um assembly que está incluído na pasta de saída de compilação do projeto. Visual Studio também cria um conjunto de entradas de registro que permitem que o projeto descobrir e carregar o suplemento, e ele define as configurações de segurança no computador de desenvolvimento para ativar o add-in executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
Verifique se uma nova tarefa é adicionada ao projeto em branco.
Verifique se o texto a seguir aparece no Nome da tarefa campo da tarefa.

Este texto foi adicionado por meio de código.
Feche o Microsoft Project.

Limpando o projeto.

Quando terminar de desenvolver um projeto, remova o assembly do suplemento, entradas do registro e as configurações de segurança do seu computador de desenvolvimento. Caso contrário, o suplemento será executado toda vez que abrir o Microsoft Project no computador de desenvolvimento.

Para limpar o seu projeto.

Em Visual Studio, sobre o Build menu, clique em Limpar solução.

Próximas etapas

Agora que você criou um suplemento do nível de aplicativo básico do projeto, você pode aprender mais sobre como desenvolver suplementos com estes tópicos:

Tarefas de programação gerais que pode ser executada em suplementos para o projeto: Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto do projeto: Solução de projeto.
Criação e depuração de suplementos em nível de aplicativo para o projeto: Criação e depuração de soluções do Office.
Implantando os suplementos de nível de aplicativo para o projeto: Implantar soluções do Office.