Demonstra Passo a passo: Sincronizando um painel de tarefas Personalizar com um botão da Faixa de Opções

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e aplicativos do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Aplicativo do Microsoft Office O Excel 2007 Outlook 2007 PowerPoint 2007 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e aplicativos do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Aplicativo do Microsoft Office

O Excel 2007
Outlook 2007
PowerPoint 2007
Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo demonstra como criar um painel de tarefas Personalizar que os usuários podem ocultar ou exibir, clicando em um botão de Alternar na Faixa de Opções.Você sempre deve criar um elemento de interface (UI) do usuário, como um botão, o que os usuários podem Clique para exibir ou ocultar o painel de tarefas Personalizar, porque aplicativos do Microsoft Office não fornecem uma maneira padrão para os usuários mostrar ou ocultar os painéis de tarefas Personalizars.

Embora esta explicação passo a passo usa o Excel especificamente, os conceitos demonstrados pelo explicação passo a passo são aplicáveis a quaisquer aplicativos que estão listados acima.

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

Criando a interface do usuário do painel de tarefas Personalizar.
Adicionando um botão de Alternar a Faixa de Opções.
Sincronizando o botão de Alternar com o painel de tarefas Personalizar.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações 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, consulte Configurações do Visual Studio.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).
Microsoft Office Excel 2007.

Ferramentas do Visual Studio para o Office é instalado por padrão com as versões listadas do Visual Studio.Para Marcar se ele está instalado, Marcar Instalando o Visual Studio Tools para Office.

Criando o Adicionar - projeto

Nesta etapa, você irá criar um Adicionar no projeto para o Excel.

Para criar um novo projeto

Criar um projeto de suplemento do Excel com o nome SynchronizeTaskPaneAndRibbon, usando o Excel Adicionar - in modelo de projeto para o Microsoft Office Sistema de 2007.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

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

Adicionar um botão de Alternar a Faixa de Opções

Uma das diretrizes de design de aplicativo do Office é que os usuários sempre devem ter o Controlarar do aplicativo do Office da interface do usuário.Para permitir que os usuários controlar o painel de tarefas Personalizar, você pode adicionar um botão de Alternar de Faixa de Opções que mostra e oculta o painel de tarefas.Para criar um botão de Alternar, Adicionar um item de da Faixa de Opções (Designer Visual) com o projeto.O designer ajudará a adicionar e Posição 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 Alternar a da Faixa de Opções

No menu Project, clique em Add New Item.
No Adicionar Novo Item caixa de diálogo, Selecionar Da Faixa de Opções (Designer Visual).
Alterar o nome da Novo fita para ManageTaskPaneRibbone clique em Adicionar.

O arquivo de de ManageTaskPaneRibbon.vb de ou ManageTaskPaneRibbon.cs abre no Designer da Faixa de Opções e exibe uma Guiaulação padrão e o AAgruparar.
No Designer de Faixa de Opções, clique em Grupo1.
Na janela Propriedades, defina a propriedade do Rótulo aGerente de painel de tarefas.
Na guia Controles da Faixa de Opções de Officede De caixa de ferramentas, arraste um ToggleButton para o AAgruparar de Gerente do painel de tarefas.
Clique em ToggleButton1.
Na janela Propriedades , defina a propriedade do Rótulo para mostrar o painel de tarefas.

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

É não visual designer para painéis de tarefas Personalizars, mas você pode criar um Controlarar de usuário com o layout desejado.Posteriormente nesta explicação passo a passo, você irá adicionar o Controlarar de usuário para o painel de tarefas Personalizar.

Para Design a interface do usuário do painel de tarefas Personalizar

On the Project menu, click Add User Control.
Na caixa de diálogo Add Novo Item , Alterar o nome do usuário controle TaskPaneControle clique em Adicionar.

O Controlarar de usuário abre no designer.
Na guia Controles ComComumComum de De caixa de ferramentas, arraste Comum Caixa de Texto ao controle de usuário.

Criar o painel de tarefas Personalizar

Para criar o painel de tarefas Personalizar quando o Adicionar - in for iniciado, Adicionar Controlarar do usuário para o painel de tarefas no manipulador de eventos Startup do Adicionar - in.Por padrão, o painel de tarefas Personalizar não será visível.Posteriormente nesta explicação passo a passo, você irá adicionar código que exibirá ou ocultará o painel de tarefas quando o usuário clica a Alternar botão você Adicionado à Faixa de Opções.

Para criar o painel de tarefas Personalizar

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

Adicione o seguinte código à classe ThisAddIn: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 manipulador de eventos de ThisAddIn_Startup com o código a seguir.Este código adiciona o objeto TaskPaneControl para o campo de CustomTaskPanes , mas ele não Exibir o painel de tarefas Personalizar (por padrão, a propriedade Visible da classe CustomTaskPane é false).O código Visual C# também anexa um manipulador de eventos ao evento 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);
}

Adicionar o seguinte método à classe ThisAddIn.Esse método manipula o evento VisibleChanged.Quando o usuário fechar o painel de tarefas clicando no botão de fechar (X), esse método atualiza o estado do botão de Alternar 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;
}

Adicionar a seguinte propriedade à classe ThisAddIn.Essa propriedade expõe o objeto particular myCustomTaskPane1 Outro classes.Posteriormente nesta explicação passo a passo, você irá adicionar código à classe MyRibbon 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;
    }
}
```

Ocultar e Mostrar o painel de tarefas Personalizars usando o botão de Alternar

Último etapa é adicionar código que exibe ou oculta o painel de tarefas Personalizar quando o usuário clica no botão Alternar na Faixa de Opções.

Para exibir e ocultar o painel de tarefas Personalizar usando o botão de Alternar

No Designer da Faixa de Opções, clique Duplo o botão de Alternar de Do Mostrar painel de tarefas.

Ferramentas do Visual Studio para o Office gera automaticamente um manipulador de eventos denominado toggleButton1_Click, que manipula o evento Click do botão de Alternar.Ferramentas do Visual Studio para o Office também abre o MyRibbon.cs ou MyRibbon.vb arquivo no editor de códigos.

Substituir o manipulador de eventos de toggleButton1_Click com o código a seguir.Quando o usuário clica no botão de Alternar, esse código exibe ou oculta o painel de tarefas Personalizars, dependendo se o botão de Alternar é 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;
}

Teste o Adicionar - no

Quando você executar o projeto, o Excel abre sem exibir o painel de tarefas Personalizar.Clique no botão Alternar na Faixa de Opções para testar o código.

Para testar o Adicionar-in

Pressionarionar F5 para executar seu projeto.

Confirme se o Excel abre, e a guia de Adicionar-ins aparece na faixa de opções.
Clique na guia de Adicionar-ins na Faixa de Opções.
No AAgruparar de De Gerente do painel de tarefas, clique no botão de Alternar de Mostrar painel de tarefas.

Verifique se o painel de tarefas está Alternativamente exibido e oculto quando você Clique o botão de alternância.
Quando o painel de tarefas estiver visível, clique no botão de fechar De (X) no canto do painel de tarefas.

Verifique se o botão de Alternar aparece a não ser pressionada.

Próximas etapas

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

Criar um painel de tarefas Personalizar em um Adicionar-in para um aplicativo diferente na versão 2007 do Microsoft Office.Para obter mais informações sobre os aplicativos que oferecem suporte a painéis de tarefas Personalizars, consulte Visão geral de painéis de tarefas Personalizar.
Automatize um aplicativo de um painel de tarefas Personalizar.For more information, see Demonstra Passo a passo: Automatizar um aplicativo a partir de um painel de tarefas Personalizar.
Criar um painel de tarefas Personalizar para cada mensagem de email que é aberto no Outlook.For more information, see Demonstra Passo a passo: Exibir painéis de tarefas Personalizars com mensagens de email no Outlook.