Passo a passo: Automatizando um aplicativo a partir de um painel de tarefas personalizado

Essa explicação passo a passo demonstra como criar um painel de tarefa personalizada que automatiza o Powerpoint.O painel de tarefa personalizada inserir datas em um slide quando o usuário clica em um controle de MonthCalendar que está no painel de tarefa personalizada.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2013 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Embora essa explicação passo a passo usa o Powerpoint especificamente, os conceitos demonstrado pelo passo-a-passo são aplicáveis a todos os aplicativos que são listados acima.

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

• Criando a interface do usuário do painel de tarefa personalizada.

• Automatizar o Powerpoint do painel de tarefa personalizada.

• Exibindo o painel de tarefa personalizada no Powerpoint.

Observação
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição 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.

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

• O PowerPoint 2010 ou PowerPoint 2013.

Criando o projeto do suplemento

A primeira etapa é criar um projeto do suplemento para o Powerpoint.

para criar um novo projeto

• Crie um projeto do suplemento ao Powerpoint com o nome MyAddIn, usando o modelo de projeto do suplemento ao Powerpoint.Para obter mais informações, consulte Como: criar projetos do Office em Visual Studio.

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

Criando a interface do usuário do painel de tarefa personalizada

Não há nenhum designer visual para os painéis de tarefa personalizada, mas você pode criar um controle de usuário com o layout que você deseja.Posteriormente em esta explicação passo a passo, você adicionará o controle de usuário para o painel de tarefa personalizada.

Para criar a interface do usuário do painel de tarefa personalizada

1. No menu Project, clique em Add User Control.

2. Em a caixa de diálogo de Adicionar novo item , altere o nome do controle de usuário a MyUserControl, e clique Adicionar.

   O controle de usuário é aberto no designer.

3. De a guia de Controles Comuns de Caixa de Ferramentas, arraste um controle de MonthCalendar ao controle de usuário.

   Se o controle de MonthCalendar é maior do que a superfície de design do controle de usuário, redimensionar o controle de usuário para ajustar o controle de MonthCalendar .

Automatizar o Powerpoint do painel de tarefa personalizada

O objetivo de suplementos é colocar uma data selecionada no primeiro slide de apresentação ativo.Use o evento de DateChanged do controle para adicionar a data selecionada sempre que ele for alterado.

Para automatizar o Powerpoint do painel de tarefa personalizada

1. Em o designer, clique duas vezes no controle de MonthCalendar .

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

2. Adicione o seguinte código à parte superior do arquivo.Esse código cria um alias para Microsoft.Office.Core e namespaces de Microsoft.Office.Interop.PowerPoint .

   Imports Office = Microsoft.Office.Core
   Imports PowerPoint = Microsoft.Office.Interop.PowerPoint
   

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

3. Adicione o seguinte código à classe MyUserControl:Esse código declara um objeto de Shape como um membro de MyUserControl.Em a próxima etapa, você usará este Shape para adicionar uma caixa de texto a um slide a apresentação ativo.

   Private TextBox As PowerPoint.Shape
   

   private PowerPoint.Shape textbox;
   

4. Substitua o manipulador de eventos de monthCalendar1_DateChanged com o código a seguir.Este código adiciona uma caixa de texto ao primeiro slide a apresentação ativa, e então adiciona a data atualmente selecionada a caixa de texto.Esse código usa o objeto de Globals.ThisAddIn para acessar o modelo de objeto do Powerpoint.

   Private Sub MonthCalendar1_DateChanged( _
       ByVal sender As System.Object, _
       ByVal e As System.Windows.Forms.DateRangeEventArgs) _
       Handles MonthCalendar1.DateChanged
   
       Try
           If TextBox IsNot Nothing Then
               TextBox.Delete()
           End If
   
           Dim Slide As 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 = _
               System.Drawing.Color.DarkViolet.ToArgb()
   
       Catch ex As Exception
           System.Windows.Forms.MessageBox.Show(ex.ToString())
       End Try
   End Sub
   

   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. Em Gerenciador de Soluções, clique com o botão direito do mouse no projeto de MeuSuplemento e clique em Compilar.Verifique se o projeto compila sem erros.

Exibindo o painel de tarefa personalizada

Para exibir o painel de tarefa personalizada quando o suplemento for iniciado, adicione o controle de usuário ao painel de tarefas no manipulador de eventos de Startup do suplemento.

Para exibir o painel de tarefa personalizada

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

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

3. Adicione o seguinte código à classe ThisAddIn:Esse código declara instâncias de MyUserControl e CustomTaskPane como os membros de ThisAddIn classe.

   Private myUserControl1 As MyUserControl
   Private myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane
   

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

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

   Private Sub ThisAddIn_Startup(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles Me.Startup
   
       myUserControl1 = New MyUserControl
       myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "Calendar")
       myCustomTaskPane.Visible = True
   End Sub
   

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

testando o suplemento

Quando você executar o projeto, o Powerpoint abre e o suplemento exibe o painel de tarefa personalizada.Clique no controle de MonthCalendar para testar o código.

Para testar o suplemento

1. Pressione F5 para executar o seu projeto.

2. Confirme que o painel de tarefa personalizada é visível.

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

   A data é inserida no primeiro slide a apresentação ativo.

Próximas etapas

Você pode aprender mais sobre como criar os painéis de tarefa personalizada de esses tópicos:

• Crie um painel de tarefa personalizada em um suplemento para um aplicativo diferente.Para obter mais informações sobre aplicativos que suportam os painéis de tarefa personalizada, consulte Painéis de tarefas personalizados.

• Crie um botão de fita que pode ser usado para ocultar ou exibir um painel de tarefa personalizada.Para obter mais informações, consulte Passo a passo: Sincronizando um painel de tarefas personalizado com o botão da faixa de opções.

• Crie um painel de tarefa personalizada para cada mensagem de email que é aberta no Outlook.Para obter mais informações, consulte Passo a passo: Exibindo os painéis de tarefas personalizados com mensagens de email no Outlook.

Consulte também

Tarefas

Como: adiciona um painel de tarefas personalizado a um aplicativo

Passo a passo: Sincronizando um painel de tarefas personalizado com o botão da faixa de opções

Passo a passo: Exibindo os painéis de tarefas personalizados com mensagens de email no Outlook

Outros recursos

Painéis de tarefas personalizados