Compartilhar via


Demonstra Passo a passo: Criando seu primeiro aplicativo-nível Adicionar - in para o PowerPoint

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • PowerPoint 2007

  • PowerPoint 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo mostra como criar um aplicativo-nível Adicionar - in para Microsoft Office PowerPoint.Os recursos que você criar nesse tipo de solução estão disponíveis para o próprio aplicativo, independentemente do que as apresentações são Abrir.For more information, see Visão geral de desenvolvimento de soluções do Office.

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

  • Criando um PowerPoint Adicionar no projeto para o PowerPoint 2003 ou PowerPoint 2007.

  • Escrever código que usa o modelo de objeto do PowerPoint para adicionar uma caixa de texto a cada novo slide.

  • Criar e Executando o projeto para testá-lo.

  • Limpando o projeto para que o Adicionar-in não executada automaticamente no seu computador de desenvolvimento.

Observação:

Seu computador pode mostrar diferentes nomes ou localizações 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, consulte Configurações do Visual Studio.

Pré-requisitos

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

  • Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

  • PowerPoint 2003 ou PowerPoint 2007.

Por padrão, Ferramentas do Visual Studio para o Office é instalado com as versões listadas do Visual Studio.Para Marcar se ele está instalado no computador, Marcar Instalando o Visual Studio Tools para Office.

Criando o projeto

Para criar um novo projeto

  1. Inicie o Visual Studio

  2. No menu File, aponte para New, e em seguida, clique em Project.

  3. No painel de A Projeto Types, Expandirir Visual C# ou do Visual Basic e em seguida, Expandirir Office.

  4. Selecionar a pasta de 2007 se você estiver desenvolvendo um Adicionar-in para o PowerPoint 2007, ou Selecionar a pasta de 2003 se você estiver desenvolvendo um Adicionar-in para o PowerPoint 2003.

  5. No painel Modelos , Selecionar PowerPoint 2007 Adicionar - em ou PowerPoint 2003 Adicionar -.

  6. Na caixa Nome, tipo FirstPowerPointAddIn.

  7. Clique em OK.

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

Escrever código que adiciona texto a cada novo slide

Avançar, adicione 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 a cada novo slide.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 seu código e fornece Acessar ao modelo de objeto do PowerPoint.For more information, see Item de host addIn.O restante da classe ThisAddIn é definido em um arquivo de código oculto que você não deve modificar.

  • O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de eventos.Esses manipuladores de eventos são chamados quando PowerPoint carrega e descarrega o Adicionar - in.Use esses manipuladores de eventos ao inicializar o Adicionar-in quando ele for carregado e para Apagar recursos utilizados pelo seu suplemento quando ele for descarregado.For more information, see O Visual Studio Tools for Office Projeto eventos.

Para adicionar uma caixa de texto a cada novo slide

  1. No arquivo de código ThisAddIn, adicione o código a seguir à classe ThisAddIn.Esse código define um manipulador de eventos para o evento PresentationNewSlide da classe Microsoft.Office.Interop.PowerPoint.Application.

    Quando o usuário adiciona um novo slide na apresentação Ativo, este manipulador de eventos adiciona uma caixa de texto para a parte superior do novo slide, e adiciona algum texto para a 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.");
    }
    
  2. Se você estiver usando C#, Adicionar o código a seguir ao manipulador de eventos ThisAddIn_Startup.Esse código é necessária para conectar o manipulador de eventos Application_PresentationNewSlide com o evento PresentationNewSlide.

    this.Application.PresentationNewSlide += 
        new PowerPoint.EApplication_PresentationNewSlideEventHandler(
        Application_PresentationNewSlide);
    

Para modificar cada Novo Slide, os exemplos de código anterior usam os seguintes objetos:

  • O campo Application da classe ThisAddIn.O campo Application retorna um objeto Microsoft.Office.Interop.PowerPoint.Application, que representa a instância atual do PowerPoint.

  • O parâmetro Sld do manipulador de eventos para o evento PresentationNewSlide.O parâmetro Sld é um objeto de Microsoft.Office.Interop.PowerPoint.Slide, que representa o novo slide.For more information, see Soluções do PowerPoint.

Testar o projeto.

Quando você Compilação e executar o projeto, verifique se a caixa de texto aparece na novos slides que você adicionar a uma apresentação.

Para testar o projeto

  1. Pressionarionar F5 para Compilação e execute seu projeto.

    Quando você compila o projeto, o código é compilado em um assembly que é colocado na pasta de compilação de saída para o projeto.O Visual Studio também cria um conjunto de entradas do Registro que permitem que o PowerPoint descobrir e carregar o suplemento e ele configura as configurações de segurança no computador de desenvolvimento para habilitar o Adicionar-in executar.For more information, see Office solução Compilação processo Visão geral.

  2. No PowerPoint, Adicionar um novo slide na apresentação Ativo.

  3. Verifique se o seguinte texto é adicionado a uma Novo caixa de texto na parte superior do slide.

    Esse texto foi adicionado por meio de código.

  4. PowerPoint Fechar.

Limpando o projeto

Quando Concluir de desenvolvimento de um projeto, Remover o assembly de Adicionar-in, entradas do Registro e as configurações de segurança do seu computador de desenvolvimento.Caso contrário, o Adicionar - in será executado sempre que você abrir o PowerPoint no computador de desenvolvimento.

Para Apagar o seu projeto

  • No Visual Studio, on the menu ComCompilação, clique em Apagar Solução.

Próximas etapas

Agora que você criou um nível de aplicativo Basic Adicionar - in para o PowerPoint, você pode saber mais sobre como desenvolver Adicionar-ins destes tópicos:

Consulte também

Conceitos

Programação Application-Nível Adicionar-ins

Soluções do PowerPoint

Personalização de IU do Office

O Visual Studio Tools for Office Visão geral de modelos do projeto

Referência

Modelos de projeto Adicionar-in do 2003 do Microsoft Office

Modelos de projeto Adicionar-in do 2007 do Microsoft Office

Outros recursos

Criando e Depurando Office Solutions

Implantar soluções do Office

Date

History

Motivo

De 2008 de julho

Tópico adicionado.

Aprimoramento de informações.