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

Artigo
02/25/2013

Essa explicação passo a passo demonstra como criar um guia personalizado de fita utilizando o designer de fita.Você pode usar o designer de fita para adicionar e posicionar 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 2013 e Excel 2010; InfoPath 2013 e InfoPath 2010; Outlook 2013 e Outlook 2010; PowerPoint 2013 e PowerPoint 2010; Project 2013 e Project 2010; Visio 2013 e Visio 2010; Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

Criando os painéis de ações.
criando um guia personalizado.
Ocultando e mostrando os painéis de ações usando botões na guia personalizado.

Observação
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Configurações de Visual Studio.

Pré-requisitos

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

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Excel 2010 ou Excel 2013.

link para vídeo Para uma versão de vídeo de este tópico, consulte Como: exibição Criando um guia personalizado utilizando o designer de fita.Para uma demonstração de vídeo relacionada, consulte Como: eu faço Use o designer de fita para personalizar a fita Excel?.

Criando um projeto de pasta de trabalho do Excel

As etapas para usar o designer de fita 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 em Visual Studio.

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

Criando os painéis de ações

Adicione dois painéis de ações personalizadas ao projeto.Você adicionará posteriormente botões que mostram e ocultam os painéis de ações para a guia personalizado.

Para criar os painéis de ações

No menu Project, escolha Add New Item.
Em a caixa de diálogo de Adicionar novo item , ActionsPaneControlselecione, e clique em Adicionar.

O arquivo de ActionsPaneControl1.cs ou de ActionsPaneControl1.vb abre no designer.
De a guia de Controles Comuns de Caixa de Ferramentas, adicione um rótulo para a superfície de designer.
Em a janela de Propriedades , defina a propriedade de Texto de label1 a 1. o painel de ações.
Repita as etapas 1 a 5 para criar segundo painel ações e o rótulo.Defina a propriedade de Texto de segundo rótulo a 2. o painel de ações.

criando um guia personalizado

Uma das diretrizes de design do aplicativo do Office é que os usuários devem sempre ter o controle de aplicativo interface de usuário do Office.Para adicionar esse recurso para os painéis ações, você pode adicionar botões que mostram e ocultam cada painel de ações de um guia personalizado em fita.Para criar um guia personalizado, adicione um item de fita (designer visual) ao projeto.Ajuda de designer que você adiciona os controles de posição, definir propriedades de controle, e eventos de controle identificador.

para criar um guia personalizado

No menu Project, escolha Add New Item.
Em a caixa de diálogo de Adicionar novo item , **fita (designer visual)**selecione.
Altere o nome do novo fita a MyRibbon, e escolha Adicionar.

O arquivo de MyRibbon.cs ou de MyRibbon.vb abre no designer de fita e exibe uma guia e um grupo padrão.
Em o designer de fita, escolha a guia padrão.
Em a janela de Propriedades , expanda a propriedade de ControlId e em seguida, defina a propriedade de ControlIdType a Personalizar.
Defina a propriedade de ControlId meu a guia personalizado.
Em o designer de fita, escolha group1.
Em a janela de Propriedades , defina Rótulo para o gerenciador do painel ações.
De a guia de Controles de fita do Office de Caixa de Ferramentas, arraste um botão em group1.
Selecione botão1.
Em a janela de Propriedades , defina Rótulo para mostrar o painel de ações. 1.
Adicione um segundo botão a group1, e defina a propriedade de Rótulo para mostrar o painel de ações. 2.
De a guia de Controles de fita do Office de Caixa de Ferramentas, arraste um controle de Botão de ativação em group1.
Defina a propriedade de Rótulo para ocultar o painel de ações.

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

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

Para ocultar e mostrar os painéis de ações usando o botão na guia personalizado

Em Gerenciador de Soluções, abra o menu de atalho para MyRibbon.cs ou MyRibbon.vb, e então escolha Exibir Código.

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

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

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

Substituir o método de MyRibbon_Load com o código a seguir.Este código adiciona os objetos do painel ações à coleção de ActionsPane.Controls e oculta objetos de exibição.O código visual C# também anexa representantes para vários eventos de controle fita.

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

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


}

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

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

}

Testando a guia personalizado

Quando você executar o projeto, inicia o excel, e o guia de meu guia personalizado aparecem em fita.Escolha os botões em meu guia personalizado para exibir e ocultar os painéis de ações.

Para testar a guia personalizado

Pressione F5 para executar o seu projeto.
Escolha a guia de meu guia personalizado .
Em o grupo de Gerenciador personalizado do painel ações , escolha 1 Painel de ações de apresentação.

O painel de ações aparece e exibe o painel 1. as ações do rótulo.
Escolha 2 Painel de ações de apresentação.

O painel de ações aparece e exibe o painel 2. as ações do rótulo.
Escolha Painel de ações oculte seções.

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

Próximas etapas

Você pode aprender mais sobre como personalizar o Office interface do usuário de esses tópicos:

Adicione de contexto com base interface de usuário para qualquer personalização da nível.Para obter mais informações, consulte Visão geral do painel de ações.
Estender um formulário do Microsoft Office Outlook de padrão ou personalizada.Para obter mais informações, consulte Passo a passo: Criando uma região de formulário do Outlook.

Consulte também

Compartilhar via