Compartilhar via

Demonstra Passo a passo: Automatizar um aplicativo a partir de um painel de tarefas personalizado

  • Artigo

Este passo a passo demonstra como criar um painel de tarefas personalizado que automatiza o PowerPoint. O painel de tarefas personalizado insere datas em um slide quando o usuário clica em um MonthCalendar controle que está no painel de tarefas personalizado.

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

Embora este passo a passo use o PowerPoint especificamente, os conceitos demonstrados pelo passo a passo são aplicáveis a todos os aplicativos listados acima.

Este passo a passo ilustra as seguintes tarefas:

  • Projetando a interface do usuário do painel de tarefas personalizado.

  • Automatizando o PowerPoint a partir do painel de tarefas personalizado.

  • Exibindo o painel de tarefas personalizado no PowerPoint.

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 do Visual Studio.

Pré-requisitos

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

Criar o projeto de suplemento

A primeira etapa é criar um projeto de suplemento VSTO para o PowerPoint.

Criar um novo projeto

  1. Crie um projeto de suplemento VSTO do PowerPoint com o nome MyAddIn, usando o modelo de projeto de suplemento do PowerPoint. Para obter mais informações, consulte Como: Criar projetos do Office no Visual Studio.

    O Visual Studio abre o arquivo de código ThisAddIn.cs ou ThisAddIn.vb e adiciona o projeto MyAddIn ao Gerenciador de Soluções.

Criar a interface do usuário do painel de tarefas personalizado

Não há um designer visual para painéis de tarefas personalizados, mas você pode criar um controle de usuário com o layout desejado. Mais adiante neste passo a passo, você adicionará o controle de usuário ao painel de tarefas personalizado.

Para projetar a interface do usuário do painel de tarefas personalizado

  1. No menu Project , clique em Adicionar controle de usuário .

  2. Na caixa de diálogo Adicionar Novo Item, altere o nome do controle de usuário para MyUserControl e clique em Adicionar.

    O controle de usuário será aberto no designer.

  3. Na guia Controles comuns da caixa de ferramentas, arraste um controle MonthCalendar para o controle de usuário.

    Se o controle MonthCalendar for maior que a superfície de design do controle de usuário, redimensione o controle de usuário para se ajustar ao controle MonthCalendar.

Automatizar o PowerPoint a partir do painel de tarefas personalizado

O objetivo do suplemento VSTO é colocar uma data selecionada no primeiro slide da apresentação ativa. Use o DateChanged evento do controle para adicionar a data selecionada sempre que ela for alterada.

Para automatizar o PowerPoint a partir do painel de tarefas personalizado

  1. No designer, clique duas vezes no MonthCalendar controle.

    O arquivo MyUserControl.cs ou MyUserControl.vb é aberto e um manipulador de eventos para o DateChanged evento é criado.

  2. Adicione o código a seguir no início do arquivo. Esse código cria aliases para os Microsoft.Office.Core namespaces e PowerPoint .

    using Office = Microsoft.Office.Core;
using PowerPoint = Microsoft.Office.Interop.PowerPoint;

  3. Adicione o código a seguir à classe MyUserControl . Esse código declara um objeto Shape como membro do MyUserControl. Na etapa a seguir, você usará essa Forma para adicionar uma caixa de texto a um slide na apresentação ativa.

    private PowerPoint.Shape textbox;

  4. Substitua o monthCalendar1_DateChanged manipulador de eventos pelo código a seguir. Esse código adiciona uma caixa de texto ao primeiro slide da apresentação ativa e, em seguida, adiciona a data atualmente selecionada à caixa de texto. Esse código usa o objeto para acessar o Globals.ThisAddIn modelo de objeto do PowerPoint.

    private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
{
    try
    {
        if (textbox != null)
        {
            textbox.Delete();
        }

        PowerPoint.Slide slide =
            Globals.ThisAddIn.Application.ActivePresentation.Slides[1];
        textbox = slide.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            50, 100, 600, 50);
        textbox.TextFrame.TextRange.Text = e.Start.ToLongDateString();
        textbox.TextFrame.TextRange.Font.Size = 48;
        textbox.TextFrame.TextRange.Font.Color.RGB =
             Color.DarkViolet.ToArgb();
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.ToString());
    }
}

  5. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto MyAddIn e clique em Compilar. Verifique se o projeto é compilado sem erros.

Exibir o painel de tarefas personalizado

Para exibir o painel de tarefas personalizado quando o Suplemento VSTO for iniciado, adicione o controle de usuário ao painel de tarefas no Startup manipulador de eventos do Suplemento VSTO.

Para exibir o painel de tarefas personalizado

  1. No Gerenciador de Soluções, expanda PowerPoint.

  2. Clique com o botão direito do mouse em ThisAddIn.cs ou ThisAddIn.vb e clique em Exibir código.

  3. Adicione o código a seguir à classe ThisAddIn . Esse código declara instâncias de MyUserControl e CustomTaskPane como membros da ThisAddIn classe.

    private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

  4. Substitua o ThisAddIn_Startup manipulador de eventos pelo código a seguir. Esse código cria um novo CustomTaskPane adicionando o MyUserControl objeto à CustomTaskPanes coleção. O código também exibe o painel de tarefas.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "Calendar");
    myCustomTaskPane.Visible = true;
}

Testar o suplemento

Quando você executa o projeto, o PowerPoint é aberto e o suplemento VSTO exibe o painel de tarefas personalizado. Clique no MonthCalendar controle para testar o código.

Para testar o suplemento VSTO

  1. Pressione F5 para executar o projeto.

  2. Confirme se o painel de tarefas personalizado está visível.

  3. Clique em uma data no controle no MonthCalendar painel de tarefas.

    A data é inserida no primeiro slide da apresentação ativa.

Próximas etapas

Você pode saber mais sobre como criar painéis de tarefas personalizados a partir destes tópicos:

Conteúdo relacionado