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

Artigo
02/25/2013

Essa explicação passo a passo demonstra como criar um painel de tarefa personalizada que os usuários possam ocultar ou exibir clicando em um botão de alternância em fita.Você sempre deve criar um elemento de interface do usuário (UI), como um botão, os usuários podem clicar para exibir ou ocultar o painel de tarefa personalizada, como aplicativos do Microsoft Office não fornecem uma maneira padrão para que os usuários mostram ou ocultem os painéis 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 este passo-a-passo use Excel 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 interface de usuário do painel de tarefa personalizada.
Adicionando um botão de alternância a fita.
Sincronizando o botão de alternância com o painel de tarefa personalizada.

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

Microsoft Excel 2010 ou o Microsoft Excel 2013.

Criando o projeto do suplemento

Em esta etapa, você criará um projeto do suplemento para o excel.

para criar um novo projeto

Crie um projeto do suplemento do excel com o nome SynchronizeTaskPaneAndRibbon, usando o modelo de projeto do suplemento do excel.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 SynchronizeTaskPaneAndRibbon a Gerenciador de Soluções.

Adicionando um botão de alternância a fita

Uma das diretrizes de design do aplicativo do Office é que os usuários devem sempre ter o controle de aplicativo interface de usuário do Office.Para permitir que os usuários para controlar o painel de tarefa personalizada, você pode adicionar um botão de alternância de fita que mostra e oculte o painel de tarefas.Para criar um botão de alternância, adicione um item de fita (designer visual) ao projeto.Ajuda de designer que você adiciona os controles de posição, definir propriedades de controle, e eventos de controle identificador.Para obter mais informações, consulte Designer de faixa de opções.

Para adicionar um botão de alternância a fita

No menu Project, clique em Add New Item.
Em a caixa de diálogo de Adicionar novo item , **fita (designer visual)**selecione.
Altere o nome do novo fita a ManageTaskPaneRibbon, e clique Adicionar.

O arquivo de ManageTaskPaneRibbon.cs ou de ManageTaskPaneRibbon.vb abre no designer de fita e exibe uma guia e um grupo padrão.
Em o designer de fita, clique group1.
Em a janela de Propriedades , defina a propriedade de Rótulo ao gerenciador do painel de tarefas.
De a guia de Controles de fita do Office de Caixa de Ferramentas, arraste Botão de ativação no grupo de Gerenciador do painel de tarefas .
Clique toggleButton1.
Em a janela de Propriedades , defina a propriedade de Rótulo para mostrar o painel de tarefas.

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

No menu Project, clique em Add User Control.
Em a caixa de diálogo de Adicionar novo item , altere o nome do controle de usuário a TaskPaneControl, e clique Adicionar.

O controle de usuário é aberto no designer.
De a guia de Controles Comuns de Caixa de Ferramentas, arraste um controle de Caixa de Texto ao controle de usuário.

Criando o painel de tarefa personalizada

Para criar 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.Por padrão, o painel de tarefa personalizada não será visível.Posteriormente em esta explicação passo a passo, você 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 à fita.

Para criar o painel de tarefa personalizada

Em Gerenciador de Soluções, expanda Excel.
Clique com o botão direito do mouse ThisAddIn.cs ou ThisAddIn.vb e clique Exibir Código.

Adicione o seguinte código à classe ThisAddIn:Esse código declara uma instância de TaskPaneControl como um membro de ThisAddIn.

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

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

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

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 à classe de ThisAddIn .este método trata o evento de VisibleChanged .Quando o usuário fecha o painel de tarefas clicando no botão de Fechar (X), esse método atualiza o estado do botão de alternância em fita.

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 propriedade a seguir para a classe de ThisAddIn .Essa propriedade expõe o objeto particular de myCustomTaskPane1 para outras classes.Posteriormente em esta explicação passo a passo, você adicionará código para a classe de MyRibbon que usa essa 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;
    }
}
```

Ocultando e mostrando o painel de tarefa personalizada usando o botão de alternância

A última etapa é adicionar código que exibe ou oculta o painel de tarefa personalizada quando o usuário clica no botão de alternância em fita.

Para exibir e ocultar o painel de tarefa personalizada usando o botão de alternância

Em o designer de fita, clique duas vezes no botão de alternância de Mostrar Painel de Tarefas .

O Visual Studio gera automaticamente um manipulador de eventos chamado toggleButton1_Click, que manipula o evento de Click de botão de alternância.Visual Studio também abre o arquivo de MyRibbon.cs ou de MyRibbon.vb no editor de códigos.

Substitua o manipulador de eventos de toggleButton1_Click com o código a seguir.Quando o usuário clica no botão de alternância, este código exibe ou oculta o painel de tarefa personalizada, dependendo se 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, abra o excel sem exibir o painel de tarefa personalizada.Clique no botão de alternância em fita para testar o código.

Para testar o suplemento

Pressione F5 para executar o seu projeto.

Confirme que o excel abre, e o guia de Suplementos aparece em fita.
Clique na guia de Suplementos em fita.
Em o grupo de Gerenciador do painel de tarefas , clique no botão de alternância de Mostrar Painel de Tarefas .

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

Verifique se o botão de alternância ele não seja pressionado.

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.
Automatizar um aplicativo de um painel de tarefa personalizada.Para obter mais informações, consulte Passo a passo: Automatizando um aplicativo a partir de um painel de tarefas personalizado.
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.