Demonstra Passo a passo: Criando uma guia personalizada usando o designer de faixa de opções

Esta explicação passo a passo demonstra como criar uma guia da faixa de opções personalizada usando o Designer de faixa de opções. Você pode usar o Designer de faixa de opções para adicionar e posicionar os controles na guia 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 2010; Outlook 2007 e Outlook 2010; PowerPoint 2007 e PowerPoint 2010; Project 2010; Visio 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

• Criando painéis de ações.

• Criando uma guia personalizada.

• Ocultando e mostrando os painéis de ações usando os botões na guia personalizada.

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 Excel 2010. 

Para obter uma versão de vídeo deste tópico, consulte vídeo How to: Criando uma guia personalizada usando o Designer de faixa de opções. Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar o Designer de faixa de opções para personalizar a faixa de opções no Excel?.

Criando um projeto de pasta de trabalho do Excel

As etapas para usar o Designer de 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. For more information, see Como: Criar projetos do Office em Visual Studio.

  Visual StudioAbre a nova pasta de trabalho no designer e adiciona a MyExcelRibbon de projeto para Solution Explorer.

Criação de painéis de ações

Adicione dois painéis de ações personalizadas para o projeto. Posteriormente, você irá adicionar botões à guia personalizada que mostrar e ocultar esses painéis de ações.

Para criar painéis de ações

1. On the Project menu, click Add New Item.

2. No Add New Item caixa de diálogo, selecione ActionsPaneControle em seguida, clique em Add.

   O ActionsPaneControl1.cs ou ActionsPaneControl1.vb arquivo abre no designer.

3. Do Controles comuns guia da caixa de ferramentas, adicionar um rótulo para a superfície.

4. No Propriedades janela, defina a texto propriedade de label1 1 do painel de ações.

5. Repita as etapas de 1 a 5 para criar um segundo painel de ações e um rótulo. Definir o texto a propriedade da segunda etiqueta 2 do painel de ações.

Criando uma guia personalizada

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 adicionar esse recurso para os painéis de ações, você pode adicionar botões de mostram e ocultar cada painel de ações de uma guia personalizada da faixa de opções. Para criar uma guia personalizada, 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.

Para criar uma guia personalizada

1. On the Project menu, click Add New Item.

2. No Add New Item caixa de diálogo, selecione a faixa de opções (Visual Designer).

3. Alterar o nome da nova faixa de opções para MyRibbone clique em Add.

   O MyRibbon.cs ou MyRibbon.vb abre no Designer de faixa de opções de arquivo e exibe uma guia de padrão e o grupo.

4. No Designer de faixa de opções, clique em Grupo1.

5. No Propriedades janela, defina rótulo para o Gerenciador de painel de ações.

6. Do Controles da faixa de opções do Office guia da caixa de ferramentas, arraste um botão para Grupo1.

7. Clique em button1 para selecioná-lo.

8. No Propriedades janela, defina rótulo para mostrar 1 do painel de ações.

9. Adicionar um segundo botão para Grupo1e defina a rótulo propriedade para mostrar 2 do painel de ações.

10. Do Controles da faixa de opções do Office guia da caixa de ferramentas, arraste um ToggleButton controlar até Grupo1.

11. Definir o rótulo propriedade para ocultar o painel de ações.

Ocultando e exibindo os painéis de ações usando os botões na guia personalizado

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

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

1. Em Solution Explorer, MyRibbon.cs ou MyRibbon.vb de atalho e clique em Exibir código.

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

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

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

3. Substituir o MyRibbon_Load método com o código a seguir. Este código adiciona os objetos do painel de ações para o ActionsPane.Controls a coleta e oculta os objetos de exibição. O código do Visual C# também anexa delegados para vários eventos de controle da faixa de opções.

   Private Sub MyRibbon_Load(ByVal sender As System.Object, ByVal e As 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
   

   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;
   
       // Use the following code in projects that target the .NET Framework 4.
       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);
   
       // For .NET Framework 3.5 projects, use the following code instead.
       // this.button1.Click += new EventHandler<RibbonControlEventArgs>(button1_Click);
       // this.button2.Click += new EventHandler<RibbonControlEventArgs>(button2_Click);
       // this.toggleButton1.Click += new EventHandler<RibbonControlEventArgs>(toggleButton1_Click);
   }
   

   Para obter mais informações sobre as diferenças no Visual C# exemplo de código para projetos destinados a.NET Framework 4 e o.NET Framework 3.5, consulte Atualizando as personalizações da faixa de opções em projetos do Office que você migrar para o.NET Framework 4.

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

   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
   

   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;
       }
   
   }
   

Na guia personalizado de teste.

Quando você executa o projeto, começa do Excel, O Add-Ins guia aparece na faixa de opções. Clique nos botões em Add-Ins para mostrar e ocultar os painéis de ações.

Para testar a tabulação personalizada

1. Pressione F5 para executar seu projeto.

2. Clique o Add-Ins guia.

3. No Gerenciador de painel de ações personalizadas de grupo, clique em Mostrar 1 do painel de ações.

   O painel de ações aparece e exibe o rótulo 1 do painel de ações.

4. Clique em Mostrar o painel de ações 2.

   O painel de ações aparece e exibe o rótulo 2 do painel de ações.

5. Clique em Ocultar painel de ações.

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

Próximas etapas

Você pode aprender mais sobre como personalizar a interface do Office com estes tópicos:

• Adicione a interface do usuário baseada em contexto qualquer personalização de nível de documento. For more information, see Visão geral painel Ações.

• Estenda um formulário de Microsoft Office Outlook de padrão ou personalizado. For more information, see Demonstra Passo a passo: A criação de uma região de formulário do Outlook.

Consulte também

Tarefas

Como: Começar a personalizar a faixa de opções.

Como: Alterar a ordem das guias na faixa de opções

Como: Personalizar a guia interna

Como: Personalizar o Menu Microsoft Office

Conceitos

Acessando a faixa de opções em tempo de execução

Designer de faixa de opções

Personalização para Outlook

Visão geral do modelo de objeto de faixa de opções

Outros recursos

Visão geral da faixa de opções

Histórico de alterações

Date	History	Motivo
Setembro de 2010	Adicionado.NET Framework 3.5 exemplo de código.	Correção de bug de conteúdo.