Share via

Demonstra Passo a passo: Criar seu primeiro suplemento VSTO para PowerPoint

  • Artigo

Este passo a passo mostra como criar um suplemento VSTO para o Microsoft Office PowerPoint. Os recursos criados nesse tipo de solução estão disponíveis para o próprio aplicativo, independentemente de quais apresentações estão abertas. Para obter mais informações, consulte Visão geral do desenvolvimento de soluções do Office (VSTO).

Aplica-se a: As informações neste tópico se aplicam a projetos de suplemento VSTO para PowerPoint. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

  • Criando um projeto de suplemento VSTO do PowerPoint para PowerPoint.

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

  • Construindo e executando o projeto para testá-lo.

  • Limpando o projeto para que o suplemento VSTO não seja mais executado automaticamente no computador de desenvolvimento.

    Observação

    Seu computador pode mostrar diferentes nomes ou locais 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, confira Personalizar o IDE.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

Criar o projeto

Criar um novo projeto

  1. Inicie o Visual Studio.

  2. No menu Arquivo , aponte para Novoe clique em Projeto.

  3. No painel de modelos, expanda Visual C# ou Visual Basic e, em seguida, expanda Office/SharePoint.

  4. No nó Office/SharePoint expandido, selecione o nó Suplementos do Office.

  5. Na lista de modelos de projeto, selecione um projeto de suplemento VSTO do PowerPoint.

  6. Na caixa Nome, digite FirstPowerPointAddIn.

  7. Clique em OK.

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

Escrever código que adiciona texto a cada novo slide

Em seguida, adicione código ao 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 ThisAddIn classe. Essa classe fornece um ponto de entrada para seu código e fornece acesso ao modelo de objeto do PowerPoint. Para obter mais informações, consulte Suplementos do programa VSTO. O restante da classe é definido em um arquivo de ThisAddIn código oculto que você não deve modificar.

  • Os ThisAddIn_Startup manipuladores de eventos e ThisAddIn_Shutdown . Esses manipuladores de eventos são chamados quando o PowerPoint carrega e descarrega o suplemento VSTO. Use esses manipuladores de eventos para inicializar o suplemento VSTO quando ele for carregado e para limpar os recursos usados pelo suplemento VSTO quando ele for descarregado. Para obter mais informações, consulte Eventos em projetos do Office.

Para adicionar uma caixa de texto a cada novo slide

  1. No arquivo de código ThisAddIn, adicione o seguinte código à ThisAddIn classe. Esse código define um manipulador de eventos para o evento Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide do objeto Application .

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

    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#, adicione o seguinte código ao manipulador de ThisAddIn_Startup eventos. Esse código é necessário para conectar o manipulador de eventos com o Application_PresentationNewSlideevento Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

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

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

Testar o projeto

Ao criar e executar o projeto, verifique se a caixa de texto aparece em novos slides adicionados a uma apresentação.

Para testar o projeto

  1. Pressione F5 para compilar e executar seu projeto.

    Quando você compila 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 que o PowerPoint descubra e carregue o Suplemento VSTO e define as configurações de segurança no computador de desenvolvimento para permitir que o Suplemento VSTO seja executado. Para obter mais informações, consulte Criar soluções do Office.

  2. No PowerPoint, adicione um novo slide à apresentação ativa.

  3. Verifique se o texto a seguir foi adicionado a uma nova caixa de texto na parte superior do slide.

    Este texto foi adicionado usando código.

  4. Feche o PowerPoint.

Limpar o projeto

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

Para limpar seu projeto

  1. No Visual Studio, no menu Compilar , clique em Limpar Solução.

Próximas etapas

Agora que você criou um suplemento básico do VSTO para o PowerPoint, você pode aprender mais sobre como desenvolver suplementos do VSTO a partir destes tópicos:

  • Tarefas gerais de programação que você pode executar em Suplementos VSTO para PowerPoint. Para obter mais informações, consulte Suplementos do programa VSTO.

  • Usando o modelo de objeto do PowerPoint. Para obter mais informações, consulte Soluções do 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. Para obter mais informações, consulte Personalização da interface do usuário do Office.

  • Criando e depurando suplementos VSTO para PowerPoint. Para obter mais informações, consulte Criar soluções do Office.

  • Implantando suplementos VSTO para PowerPoint. Para obter mais informações, consulte Implantar uma solução do Office.

Conteúdo relacionado