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

Artigo
02/25/2013

Essa explicação passo a passo mostra como criar um suplemento ao nível para Microsoft Office.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de qual os projetos estão abertos.Para obter mais informações, consulte 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 2013 e Project 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Essa explicação passo a passo mostra as seguintes tarefas:

Criando um projeto do suplemento ao projeto.
Escrevendo código que usa o modelo de objeto do projeto para adicionar uma tarefa para um novo projeto.
Compilação e execução do projeto testá-lo.
Limpando o projeto terminado de modo que o suplemento não executa automaticamente no seu 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 de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Project 2013 ou Project 2010.

Criando o projeto

Para criar um novo projeto no Visual Studio

Inicie o Visual Studio
No menu File, aponte para New, e em seguida, clique em Project.
Em o painel de modelos, expanda Visual C# ou Visual Basicem seguida, expanda Office/SharePoint.
Sob o nó expandido de Office/SharePoint , selecione o nó de Suplementos do Office .
Em a lista de modelos de projeto, de Suplemento do Project 2010 selecione ou de Suplemento do Project 2013.
Em a caixa de Nome , digite FirstProjectAddIn.
Clique em OK.

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

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

Em seguida, adicione o código ao arquivo de código de ThisAddIn.O novo código usa o modelo de objeto do projeto para adicionar uma nova tarefa a um projeto.Por padrão, o arquivo de código de ThisAddIn contém o seguinte código gerado:

Uma definição de classe parcial de ThisAddIn .Essa classe fornece uma ponto de entrada para seu código e fornece acesso para o modelo de objeto do projeto.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..O restante da classe de ThisAddIn é definido em um arquivo oculto de código que você não deve alterar.
os manipuladores de eventos de ThisAddIn_Startup e de ThisAddIn_Shutdown .Esses manipuladores de eventos são chamados quando o projeto é carregado e descarrega o suplemento.Use esses manipuladores de eventos para inicializar o suplemento quando ele for carregado, e para limpar os recursos usados pelo suplemento quando é descarregado.Para obter mais informações, consulte Eventos em projetos do Office.

Para adicionar uma tarefa para um novo projeto

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

quando o usuário cria um novo projeto, este manipulador de eventos 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 alterar o projeto, esse uso do código de exemplo os seguintes objetos:

O campo de Application da classe de ThisAddIn .O campo de Application retorna um objeto de Microsoft.Office.Interop.MSProject.Application , que representa a instância atual do projeto.
O parâmetro de pj do manipulador de eventos para o evento de NewProject .O parâmetro de pj é um objeto de Microsoft.Office.Interop.MSProject.Project , que representa o projeto.Para obter mais informações, consulte Soluções de projeto.

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

Testar o projeto.

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

para testar o projeto

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

Quando você criar o projeto, o código é compilado em um assembly que é 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 ao projeto descobrir e carregar o suplemento, e configurar as configurações de segurança no computador de desenvolvimento para ativar o suplemento a execução.Para obter mais informações, consulte Office Solution Build Process Overview.
Verifique que uma nova tarefa é adicionada ao projeto em branco.
Verifique se o seguinte texto apareça no campo de Nome da tarefa de tarefas.

Esse texto foi adicionado usando código.
Feche o Microsoft Project.

limpando o projeto

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

Para limpar o seu projeto

Em o Visual Studio, no menu de Compilar , clique Limpar solução.

Próximas etapas

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

Tarefas básicas de programação que você pode executar de suplementos para o projeto: Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto de projeto: Soluções de projeto.
Suplementos em nível de compilação e de depuração para o projeto: Construindo soluções do Office.
Implantando suplementos do nível para o projeto: Implantando uma solução do Office.