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

Artigo
02/25/2013

Essa explicação passo a passo mostra como criar um suplemento ao nível para o Microsoft Office PowerPoint.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de que mostra estão abertas.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 PowerPoint 2013 e PowerPoint 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 Powerpoint para o Powerpoint.
Escrevendo código que usa o modelo de objeto do Powerpoint para adicionar uma caixa de texto para cada nova slide.
Compilação e execução do projeto testá-lo.
Limpando o projeto para 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.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Como: eu faço Crie um suplemento do PowerPoint?.

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

PowerPoint 2013 ou PowerPoint 2010.

Criando o projeto

para criar um novo projeto

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 PowerPoint 2010 selecione ou de PowerPoint_15_short.
Em a caixa de Nome , digite FirstPowerPointAddIn.
Clique em OK.

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

Escrevendo código que adiciona o texto para cada nova slide

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

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 PresentationNewSlide do objeto de Application .

Quando o usuário adiciona um novo slide a apresentação ativa, este manipulador de eventos adiciona uma caixa de texto à parte superior do novo slide, e adicione texto à 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 C#, adicione o seguinte código ao manipulador de eventos de ThisAddIn_Startup .Esse código é necessário para conectar o manipulador de eventos de Application_PresentationNewSlide com o evento de PresentationNewSlide .
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

Para alterar cada novo slide, os exemplos anteriores de código usa os seguintes objetos:

O campo de Application da classe de ThisAddIn .O campo de Application retorna um objeto de Application , que representa a instância atual do Powerpoint.
O parâmetro de Sld do manipulador de eventos para o evento de PresentationNewSlide .O parâmetro de Sld é um objeto de Slide , que representa o novo slide.Para obter mais informações, consulte Soluções de PowerPoint.

Testar o projeto.

Quando você compilar e executar o projeto, verifique se a caixa de texto apareça em novos slides que você adiciona a uma apresentação.

para testar o projeto

Pressione F5 para compilar e executar o projeto.

Quando você criar o projeto, o código é compilado em um assembly que é colocado 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 o Powerpoint para 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 Construindo soluções do Office.
Em o Powerpoint, adicione um slide novo para a apresentação ativo.
Verifique se o seguinte texto é adicionado a uma nova caixa de texto na parte superior de esmaecer.

Esse texto foi adicionado usando código.
Feche o Powerpoint.

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 o Powerpoint 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 para o Powerpoint, 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 Powerpoint.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto do Powerpoint.Para obter mais informações, consulte Soluções de PowerPoint.
Personalizando interface de usuário do Powerpoint, por exemplo, adicionando um guia personalizado à fita ou criando seu próprio painel de tarefa personalizada.Para obter mais informações, consulte Personalização de interface do usuário do Office.
Suplementos em nível de compilação e de depuração para o Powerpoint.Para obter mais informações, consulte Construindo soluções do Office.
Implantando suplementos do nível para o Powerpoint.Para obter mais informações, consulte Implantando uma solução do Office.