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

Artigo
08/08/2011

Esta explicação passo a passo demonstra como criar um painel de tarefas personalizado que os usuários podem ocultar ou exibir clicando em um botão de alternância na faixa de opções. Você sempre deve criar um elemento de interface (UI) do usuário, como, por exemplo, um botão, o que os usuários podem clicar para exibir ou ocultar o painel de tarefas personalizado, porque os aplicativos de Microsoft Office não fornecem uma maneira padrão para usuários mostrar ou ocultar os painéis 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 Excel 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.
Adicionando um botão de alternância para a faixa de opções.
Sincronizando o botão de alternância com o painel de tarefas personalizado.

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 Excel 2007 ou Microsoft Excel 2010.

Criando o projeto de suplemento

Nesta etapa, você criará um projeto de suplemento do Excel.

Para criar um novo projeto.

Crie um projeto de suplemento do Excel com o nome SynchronizeTaskPaneAndRibbon, usando o modelo de projeto de suplemento do Excel. 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 SynchronizeTaskPaneAndRibbon de projeto para Solution Explorer.

Adicionando um botão de alternância para a faixa de opções.

Uma das diretrizes de projeto de aplicativo do Office é que os usuários sempre devem ter o controle da interface do usuário do aplicativo do Office. Para habilitar usuários controlar o painel de tarefas personalizado, você pode adicionar um botão de alternância de faixa de opções que mostra e oculta o painel de tarefas. Para criar um botão de alternância, adicione um a faixa de opções (Visual Designer) item ao projeto. O designer ajuda a adicionar e posicionar controles, definir propriedades de controle e manipular eventos de controle. For more information, see Designer de faixa de opções.

Para adicionar um botão de alternância para a faixa de opções.

On the Project menu, click Add New Item.
No Add New Item caixa de diálogo, selecione a faixa de opções (Visual Designer).
Alterar o nome da nova faixa de opções para ManageTaskPaneRibbone clique em Add.

O ManageTaskPaneRibbon.cs ou ManageTaskPaneRibbon.vb abre no Designer de faixa de opções de arquivo e exibe uma guia de padrão e o grupo.
No Designer de faixa de opções, clique em Grupo1.
No Propriedades janela, defina a rótulo propriedade ao Gerenciador de painel de tarefas.
Da Controles de faixa de opções do Office guia da Toolbox, arraste um ToggleButton até o Gerenciador de tarefas do painel grupo.
Clique em toggleButton1.
No Propriedades janela, defina a rótulo propriedade para mostrar o painel de tarefas.

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 TaskPaneControle clique em Add.

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

Criando um painel de tarefas personalizado

Para criar 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. Por padrão, o painel de tarefas personalizado não será visível. Posteriormente nesta explicação passo a passo, você irá adicionar código que irá exibir ou ocultar o painel de tarefas quando o usuário clica no botão de alternância que você adicionou à Faixa de opções.

Para criar o painel de tarefas personalizado

Em Solution Explorer, expanda Excel.
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 uma instância de TaskPaneControl como um membro do ThisAddIn.

Private taskPaneControl1 As TaskPaneControl
Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane

private TaskPaneControl taskPaneControl1;
private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;

Substituir o ThisAddIn_Startup o manipulador de eventos com o código a seguir. Este código adiciona o TaskPaneControl o objeto para o CustomTaskPanes campo, mas ele não exibe o painel de tarefas personalizado (por padrão, o Visible propriedade da CustomTaskPane classe é false). O código do Visual C# também anexa um manipulador de eventos para o VisibleChanged de evento.

Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    taskPaneControl1 = New TaskPaneControl()
    taskPaneValue = Me.CustomTaskPanes.Add( _
        taskPaneControl1, "MyCustomTaskPane")
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    taskPaneControl1 = new TaskPaneControl();
    taskPaneValue = this.CustomTaskPanes.Add(
        taskPaneControl1, "MyCustomTaskPane");
    taskPaneValue.VisibleChanged +=
        new EventHandler(taskPaneValue_VisibleChanged);
}

Adicione o seguinte método para o ThisAddIn classe. Este método que manipula o VisibleChanged de evento. Quando o usuário fechar o painel de tarefas clicando o Fechar o botão (X), essas atualizações de método, o estado da alternância de botão na faixa de opções.

Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged

    Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
End Sub

private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
{
    Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
        taskPaneValue.Visible;
}

Adicione a seguinte propriedade para o ThisAddIn classe. Essa propriedade expõe particular myCustomTaskPane1 o objeto para outras classes. Posteriormente nesta explicação passo a passo, você irá adicionar código para o MyRibbon classe que usa esta propriedade.
```
Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
    Get
        Return taskPaneValue
    End Get
End Property
```
```
public Microsoft.Office.Tools.CustomTaskPane TaskPane
{
    get
    {
        return taskPaneValue;
    }
}
```

Como ocultar e mostrar o painel de tarefas personalizado usando o botão de alternância

A última etapa é adicionar o código que exibe ou oculta o painel de tarefas personalizado quando o usuário clica no botão de alternância na faixa de opções.

Para exibir e ocultar o painel de tarefas personalizado usando o botão de alternância

No Designer de faixa de opções, clique duas vezes o Mostrar painel de tarefas o botão de alternância.

Visual Studio gera automaticamente um manipulador de evento chamado toggleButton1_Click, as alças de Click eventos do botão de alternância. Também abre uma Visual Studio de MyRibbon.cs ou MyRibbon.vb o arquivo no Editor de código.

Substituir o toggleButton1_Click o manipulador de eventos com o código a seguir. Quando o usuário clica no botão de alternância, esse código exibe ou oculta o painel de tarefas personalizado, de acordo com o botão de alternância é pressionado ou não pressionado.

Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click

    Globals.ThisAddIn.TaskPane.Visible = _
        TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
End Sub

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
}

Testando o suplemento

Quando você executar o projeto, o Excel abre sem exibir o painel de tarefas personalizado. Clique no botão de alternância para testar o código da faixa de opções.

Para testar seu suplemento

Pressione F5 para executar seu projeto.

Confirme que o Excel abre e o Add-Ins guia aparece na faixa de opções.
Clique o Add-Ins guia na faixa.
No Gerenciador de tarefas do painel de grupo, clique no Mostrar painel de tarefas botão de alternância.

Verifique se o painel de tarefas é exibido e oculto quando você clicar no botão de alternância alternadamente.
Quando o painel de tarefas estiver visível, clique no Fechar o botão (X) no canto do painel de tarefas.

Verifique se o botão de alternância aparece para não ser pressionado.

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.
Automatize um aplicativo a partir de um painel de tarefas personalizado. For more information, see Demonstra Passo a passo: A automatização de um aplicativo a partir de um painel de tarefas personalizado.
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