Demonstra Passo a passo: Criar uma guia personalizada usando o Designer da Faixa de Opções

Usando o Designer da Faixa de Opções, você pode criar uma guia personalizada e, em seguida, adicionar e posicionar controles nela.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

• Criar painéis de ações.

• Crie uma guia personalizada.

• Ocultar e mostrar painéis de ações usando botões na guia personalizada.

Observação

Seu computador pode mostrar diferentes nomes ou locais 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, confira Personalizar o IDE do Visual Studio.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

• Uma edição do Visual Studio que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

• Microsoft Excel

Criar um projeto de pasta de trabalho do Excel

As etapas para usar o Designer da Faixa de Opções são quase idênticas para todos os aplicativos do Office. Este exemplo usa uma pasta de trabalho do Excel.

Para criar um projeto de pasta de trabalho do Excel

• Crie um projeto de pasta de trabalho do Excel com o nome MyExcelRibbon. Para obter mais informações, consulte Como: Criar projetos do Office no Visual Studio.

  O Visual Studio abre a nova pasta de trabalho no designer e adiciona o projeto MyExcelRibbon ao Gerenciador de Soluções.

Criar painéis de ações

Adicione dois painéis de ações personalizadas ao projeto. Mais tarde, você adicionará botões que mostram e ocultam esses painéis de ações à guia personalizada.

Para criar painéis de ações

1. No menu Projeto, escolha Adicionar Novo Item.

2. Na caixa de diálogo Adicionar Novo Item, selecione ActionsPaneControl e escolha Adicionar.

   O arquivo ActionsPaneControl1.cs ou ActionsPaneControl1.vb é aberto no designer.

3. Na guia Controles Comuns da Caixa de Ferramentas, adicione um rótulo à superfície do designer.

4. Na janela Propriedades, defina a propriedade Text de label1 como Painel de Ações 1.

5. Repita as etapas 1 a 5 para criar um segundo painel de ações e um rótulo. Defina a propriedade Text do segundo rótulo como Painel de Ações 2.

Criar uma guia personalizada

Uma das diretrizes de design de aplicativo do Office é que os usuários sempre devem ter controle da interface do usuário do aplicativo do Office. Para adicionar esse recurso aos painéis de ações, você pode adicionar botões que mostram e ocultam cada painel de ações de uma guia personalizada na faixa de opções. Para criar uma guia personalizada, adicione um item da Faixa de Opções (Visual Designer) ao projeto. O designer ajuda você a adicionar e posicionar controles, definir propriedades de controle e manipular eventos de controle.

Para criar uma guia personalizada

1. No menu Projeto, escolha Adicionar Novo Item.

2. Na caixa de diálogo Adicionar Novo Item, selecione Faixa de Opções (Visual Designer).

3. Altere o nome da nova faixa de opções para MyRibbon e escolha Adicionar.

   O arquivo MyRibbon.cs ou MyRibbon.vb é aberto no Designer da Faixa de Opções e exibe uma guia e um grupo padrão.

4. No Designer da Faixa de Opções, escolha a guia padrão.

5. Na janela Propriedades, expanda a propriedade ControlId e defina a propriedade ControlIdType como Custom.

6. Defina a propriedade Label como Minha guia personalizada.

7. No Designer da Faixa de Opções, escolha group1.

8. Na janela Propriedades, defina Rótulo como Gerenciador do Painel de Ações.

9. Na guia Controles da Faixa de Opções do Office da Caixa de Ferramentas, arraste um botão para o group1.

10. Selecione o botão1.

11. Na janela Propriedades, defina Rótulo como Mostrar Painel de Ações 1.

12. Adicione um segundo botão ao group1 e defina a propriedade Label como Mostrar Painel de Ações 2.

13. Na guia Controles da Faixa de Opções do Office da Caixa de Ferramentas, arraste um controle ToggleButton para group1.

14. Defina a propriedade Label como Painel Ocultar Ações.

Ocultar e mostrar painéis de ações usando botões na guia personalizada

A última etapa é adicionar código que responda ao usuário. Adicione manipuladores de eventos para os Click eventos dos dois botões e o Click evento do botão de alternância. Adicione código a esses manipuladores de eventos para habilitar ocultar e mostrar os painéis de ações.

Para ocultar e mostrar painéis de ações usando botões na guia personalizada

1. No Gerenciador de Soluções, abra o menu de atalho para MyRibbon.cs ou MyRibbon.vb e escolha Exibir código.

2. Adicione o seguinte código à parte superior da MyRibbon classe. Esse código cria dois objetos do painel de ações.

   C#

   ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
   ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();
   

   VB

   Dim actionsPane1 As New ActionsPaneControl1()
   Dim actionsPane2 As New ActionsPaneControl2()
   

3. Substitua o método MyRibbon_Load pelo seguinte código. Esse código adiciona os objetos do painel de ações à Controls coleção e oculta os objetos da exibição. O código Visual C# também anexa delegados a vários eventos de controle da faixa de opções.

   C#

   private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
   {
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
       actionsPane1.Hide();
       actionsPane2.Hide();
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
   
       this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.button1_Click);
       this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.button2_Click);
       this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.toggleButton1_Click);
   
   
   }
   

   VB

   Private Sub MyRibbon_Load(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) Handles MyBase.Load
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
       actionsPane1.Hide()
       actionsPane2.Hide()
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
   End Sub
   

4. Adicione os três métodos de manipulador de eventos a seguir à MyRibbon classe. Esses métodos manipulam os Click eventos dos dois botões e o Click evento do botão de alternância. Os manipuladores de eventos para button1 e button2 mostram painéis de ações alternativas. O manipulador de eventos para toggleButton1 mostra e oculta o painel de ações ativas.

   C#

   private void button1_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       actionsPane2.Hide();
       actionsPane1.Show();
       toggleButton1.Checked = false;
   }
   
   private void button2_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       actionsPane1.Hide();
       actionsPane2.Show();
       toggleButton1.Checked = false;
   
   }
   
   private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
   {
       if (toggleButton1.Checked == true)
       {
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
       }
       else
       {
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       }
   
   }
   

   VB

   Private Sub Button1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button1.Click
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane2.Hide()
       actionsPane1.Show()
       ToggleButton1.Checked = False
   End Sub
   
   Private Sub Button2_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button2.Click
   
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane1.Hide()
       actionsPane2.Show()
       ToggleButton1.Checked = False
   
   End Sub
   
   
   Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles ToggleButton1.Click
   
       If ToggleButton1.Checked Then
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
       Else
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       End If
   
   End Sub
   

Testar a guia personalizada

Quando você executa o projeto, o Excel é iniciado e a guia Minha guia personalizada aparece na faixa de opções. Escolha os botões em Minha guia personalizada para mostrar e ocultar os painéis de ações.

Para testar a guia personalizada

1. Pressione F5 para executar o projeto.

2. Escolha a guia Minha guia personalizada .

3. No grupo Gerenciador do Painel de Ações Personalizadas, escolha Mostrar Painel de Ações 1.

   O painel de ações é exibido e exibe o rótulo Painel de Ações 1.

4. Escolha Mostrar Painel de Ações 2.

   O painel de ações é exibido e exibe o rótulo Painel de Ações 2.

5. Escolha Ocultar Painel de Ações.

   Os painéis de ações não estão mais visíveis.

Próximas etapas

Você pode saber mais sobre como personalizar a interface do usuário do Office a partir destes tópicos:

• Adicione a interface do usuário baseada em contexto a qualquer personalização em nível de documento. Para obter mais informações, consulte Visão geral do painel Ações.

• Estender um formulário padrão ou personalizado do Microsoft Office Outlook. Para obter mais informações, consulte Demonstra Passo a passo: Criar uma região de formulário do Outlook.

Conteúdo relacionado

• Acessar a faixa de opções em tempo de execução
• Visão geral da faixa de opções
• Designer da faixa de opções
• Personalizar uma faixa de opções para o Outlook
• Como: Começar a personalizar a faixa de opções
• Como alterar a posição de uma guia na faixa de opções
• Como: Personalizar uma guia interna
• Como: Adicionar controles ao modo de exibição backstage
• Visão geral do modelo de objeto da faixa de opções