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

Artigo
08/08/2011

Esta explicação passo a passo mostra como criar um suplemento em nível de aplicativo para o PowerPoint de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis para o aplicativo propriamente dito, independentemente das apresentações são abertas. 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 PowerPoint 2007 e PowerPoint 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 PowerPoint para o PowerPoint.
Escrevendo código que usa o modelo de objeto do PowerPoint para adicionar uma caixa de texto para cada novo slide.
A criação e execução do projeto para testá-lo.
Limpando o projeto 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.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Criar um suplemento do Microsoft PowerPoint?.

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

PowerPoint 2007 ou PowerPoint 2010.

Creating the Project

Para criar um novo projeto.

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 PowerPoint 2007 instalado, ou selecione o 2010 o nó se você tiver PowerPoint 2010 instalado.
Na lista de modelos de projeto, selecione suplemento do PowerPoint 2007 ou Suplemento do Microsoft PowerPoint 2010.
No nome , digite FirstPowerPointAddIn.
Click OK.

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

Escrever código que adiciona texto a cada novo Slide.

Em seguida, adicione o código para o arquivo de código ThisAddIn. O novo código usa o modelo de objeto do PowerPoint para adicionar uma caixa de texto para cada novo slide. 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 PowerPoint. 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 PowerPoint 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 caixa de texto para cada novo slide.

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 PresentationNewSlide o evento da Application objeto.

Quando o usuário adiciona um novo slide na apresentação ativa, o manipulador de evento adiciona uma caixa de texto na parte superior do novo slide, e adiciona algum texto da caixa de texto.

Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
    Handles Application.PresentationNewSlide
    Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
End Sub

void Application_PresentationNewSlide(PowerPoint.Slide Sld)
{
    PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
}

Se você estiver usando o C#, adicione o seguinte código para o ThisAddIn_Startup manipulador de eventos. Esse código é necessária para conectar-se a Application_PresentationNewSlide o manipulador de eventos com o PresentationNewSlide de evento.
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

Para modificar cada slide novo, os exemplos de código anterior usam os seguintes objetos:

O Application campo de ThisAddIn classe. O Application campo retorna um Application o objeto, que representa a instância atual do PowerPoint.
O Sld parâmetro do manipulador de eventos para o PresentationNewSlide de evento. O Sld parâmetro é um Slide o objeto, que representa o novo slide. For more information, see Soluções de PowerPoint.

Testing the Project

Quando você compilar e executa o projeto, verifique se que a caixa de texto aparece em novos slides que você adicionar a uma apresentação.

Para testar o projeto.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que é colocado na pasta de saída de compilação do projeto. Visual Studio também cria um conjunto de entradas de registro que permitem descobrir e carregar o suplemento no PowerPoint, 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.
No PowerPoint, adicione um novo slide na apresentação ativa.
Verifique se o seguinte texto é adicionado a uma nova caixa de texto na parte superior do slide.

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

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 PowerPoint 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 PowerPoint, você pode aprender mais sobre como desenvolver suplementos com estes tópicos:

Tarefas de programação gerais que você pode executar nos suplementos do PowerPoint. For more information, see Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto do PowerPoint. For more information, see Soluções de PowerPoint.
Personalizar a interface do usuário do PowerPoint, por exemplo, adicionando uma guia personalizada à Faixa de opções ou criando seu próprio painel de tarefas personalizado. For more information, see Personalização de interface do usuário do Office.
A criação e depuração de suplementos em nível de aplicativo para o PowerPoint. For more information, see Criação e depuração de soluções do Office.
Implantando os suplementos de nível de aplicativo para o PowerPoint. For more information, see Implantar soluções do Office.