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 sobre ela.

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 Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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. Posteriormente, 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, em seguida, 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 de design.

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

  5. Repita as etapas de 1 a 5 para criar um segundo painel de ações e 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 essa funcionalidade aos painéis de ações, você pode inserir botões para mostrar e ocultar cada painel de ações a partir de uma guia personalizada na faixa de opções. Para criar uma guia personalizada, adicione um item da Faixa de Opções (Designer Visual) 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 (Designer Visual).

  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 Aba Personalizada.

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

  8. Na janela Propriedades, defina Rótulo como Gerenciador de Painéis de Ações.

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

  10. Selecione o botão1.

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

  12. Adicione um segundo botão ao grupo1 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 o grupo1.

  14. Defina a propriedade Label para ocultar o painel Ações.

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

A última etapa é adicionar o código que responde 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 o ocultamento e a exibição dos 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 código a seguir à parte superior da MyRibbon classe. Esse código cria dois objetos de 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 do Visual C# também anexa delegados a vários eventos de controle da barra de ferramentas.

    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 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 aba personalizada

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

Para testar a aba personalizada

  1. Pressione F5 para executar o projeto.

  2. Escolha a aba Minha Aba Personalizada.

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

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

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

    O painel ações é exibido e exibe o rótulo Painel 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:

Conteúdo relacionado

  • Last updated on