Demonstra Passo a passo: A automatização de um aplicativo a partir de um painel de tarefas personalizado

Artigo
08/08/2011

Esta explicação 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.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2007 e Excel 2010; InfoPath 2007 e InfoPath 2010; Outlook 2007 e Outlook 2010; PowerPoint 2007 e PowerPoint 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Embora este passo a passo usa o PowerPoint especificamente, os conceitos demonstrados pela explicação são aplicáveis a todos os aplicativos que estão listados acima.

This walkthrough illustrates the following tasks:

Projetando a interface do usuário do painel de tarefas personalizado.
Automatizando o PowerPoint do painel de tarefas personalizado.
Exibindo o painel de tarefas personalizado no PowerPoint.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Microsoft Office PowerPoint 2007 ou Microsoft PowerPoint 2010.

Criando o projeto de suplemento

A primeira etapa é criar um projeto de suplemento do PowerPoint.

Para criar um novo projeto.

Crie um projeto de suplemento do PowerPoint com o nome MyAddIn, usando o modelo de projeto de suplemento do PowerPoint. For more information, see Como: Criar projetos do Office em Visual Studio.

Visual StudioAbre a ThisAddIn.cs ou ThisAddIn. vb arquivo de código e adiciona a MyAddIn de projeto para Solution Explorer.

Projetando a Interface de usuário do painel de tarefas personalizado

Não há nenhum designer visual para painéis de tarefas personalizados, mas você pode criar um controle de usuário com o layout desejado. Posteriormente nesta explicação passo a passo, você irá adicionar o controle de usuário para o painel de tarefas personalizado.

Design de interface do usuário do painel de tarefas personalizado

On the Project menu, click Add User Control.
No Add New Item caixa de diálogo, altere o nome do controle de usuário para MyUserControle clique em Add.

O controle de usuário abre no designer.
Do Controles comuns guia da caixa de ferramentas, arraste um MonthCalendar controle para o controle de usuário.

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

Automatizar o PowerPoint a partir do painel de tarefas personalizado

A finalidade do add-in é colocar uma data selecionada no primeiro slide da apresentação ativa. Use o DateChanged evento do controle para adicionar o selecionado Data sempre que ele alterações.

Para automatizar o PowerPoint do painel de tarefas personalizado

No designer, clique duas vezes o MonthCalendar de controle.

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

Adicione o seguinte código na parte superior do arquivo. Esse código cria aliases para o Microsoft.Office.Core e Microsoft.Office.Interop.PowerPoint namespaces.

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

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

Add the following code to the MyUserControl class. Esse código declara uma Shape o objeto como um membro do MyUserControl. Na etapa seguinte, você o usará Shape para adicionar uma caixa de texto a um slide na apresentação ativa.
```
Private TextBox As PowerPoint.Shape
```
```
private PowerPoint.Shape textbox;
```

Substituir o monthCalendar1_DateChanged o manipulador de eventos com o 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 para a caixa de texto. Esse código usa o Globals.ThisAddIn o objeto 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());
    }
}

Em Solution Explorer, com o botão direito do MyAddIn de projeto e, em seguida, clique em Build. Verifique se o projeto é compilado sem erros.

Exibindo o painel de tarefas personalizado

Para exibir o painel de tarefas personalizado quando o add-in for iniciado, adicionar o controle de usuário no painel de tarefas do Startup o manipulador de eventos do add-in.

Para exibir o painel de tarefas personalizado

Em Solution Explorer, expanda PowerPoint.
Com o botão direito ThisAddIn.cs ou ThisAddIn. vb e clique em Exibir código.

Add the following code to the ThisAddIn class. Esse código declara instâncias de MyUserControl e CustomTaskPane como membros do ThisAddIn classe.

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

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

Substituir o ThisAddIn_Startup o manipulador de eventos com o código a seguir. Esse código cria um novo CustomTaskPane , adicionando a MyUserControl o objeto para o CustomTaskPanes coleção. O código também exibirá 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 tarefas personalizado. Clique o MonthCalendar o controle para testar o código.

Para testar seu suplemento

Pressione F5 para executar seu projeto.
Confirme se o painel de tarefas personalizado é visível.
Clique em uma data de MonthCalendar o controle no painel de tarefas.

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

Próximas etapas

Você pode aprender mais sobre como criar painéis de tarefas personalizados com estes tópicos:

Crie um painel de tarefas personalizado em um add-in para um aplicativo diferente. Para obter mais informações sobre os aplicativos que oferecem suporte a painéis de tarefas personalizados, consulte Visão geral sobre painéis de tarefas personalizado.
Crie um botão da faixa de opções que pode ser usado para ocultar ou exibir um painel de tarefas personalizado. For more information, see Demonstra Passo a passo: Sincronizando um painel de tarefas personalizado com um botão da faixa de opções.
Crie um painel de tarefas personalizado para cada mensagem de email é aberto no Outlook. For more information, see Demonstra Passo a passo: Exibindo os painéis de tarefas personalizados com mensagens de email no Outlook.

Consulte também

Compartilhar via