Partilhar via


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:

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:

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.

    ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
    ActionsPaneControl2 actionsPane2 = 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.

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

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

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.