Demonstra Passo a passo: Criando um guia Personalizar usando o Designer de Faixa de Opções

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Projetos de nível de aplicativo Versão do Microsoft Office O Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento
Projetos de nível de aplicativo

Versão do Microsoft Office

O Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo demonstra como criar uma guia da Faixa de Opções Personalizar usando o Designer de Faixa de Opções.Você pode usar o designer de Faixa de Opções para adicionar e Posição controles na guia Personalizar.

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

Criando painéis de ações.
Criar uma guia Personalizar.
Ocultando e mostrando painéis de ações por usando botões na guia Personalizar.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações 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, consulte Configurações do Visual Studio.

Pré-requisitos

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

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).
Microsoft Office Excel 2007.

Ferramentas do Visual Studio para o Office é instalado por padrão com as versões listadas do Visual Studio.Para Marcar se ele está instalado, Marcar Instalando o Visual Studio Tools para Office.

Para uma demonstração de vídeo, consulte vídeo como para: Criando um guia Personalizar usando o Designer de Faixa de Opções.

Criando um projeto de pasta de trabalho do Excel

As etapas para usar o designer de Faixa de Opções são quase idênticos para Tudo aplicativos do Office.Este exemplo usa uma pasta de trabalho do Excel.

Para criar um projeto de pasta de trabalho do Excel

Criar um projeto de pasta de trabalho do Excel 2007 com o nome MyExcelRibbon.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

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

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

Adicionar dois painéis de ações Personalizars para o projeto.Posteriormente você irá adicionar botões para a guia Personalizar que mostrar e ocultar esses painéis de ações.

Para criar painéis de ações

No menu Project, clique em Add New Item.
No Adicionar Novo Item caixa de diálogo, Selecionar ActionsPaneControle, em seguida, clique em Adicionar.

O ActionsPaneControl1.cs ou ActionsPaneControl1.vb arquivo é aberta no designer.
Na guia Controles ComComumuns da caixa de ferramentas , Adicionar Comum rótulo à Superfície do Designer.
Na janela Propriedades , defina a propriedade de De texto do rótulo1 para 1 do painel de ações.
Repetir as etapas de 1 a 5 para criar um segundo painel de ações e um rótulo.Defina a propriedade de Textoo do segundo rótulo 2 do painel de ações.

Criar um guia Personalizar

Uma das diretrizes de design de aplicativo do Office é que os usuários sempre devem ter o Controlarar do aplicativo do Office da interface do usuário.Para adicionar esse recurso para os painéis de ações, você pode adicionar botões que mostram e ocultar cada painel de ações em uma guia Personalizar da Faixa de Opções.Para criar uma guia Personalizar, Adicionar um item de da Faixa de Opções (Designer Visual) com o projeto.O designer ajudará a adicionar e Posição controles, definir propriedades de controle e manipular eventos de controle.

Para criar uma guia Personalizar

No menu Project, clique em Add New Item.
No Adicionar Novo Item caixa de diálogo, Selecionar Da Faixa de Opções (Designer Visual).
Alterar o nome da Novo fita para MyRibbone clique em Adicionar.

O arquivo de de MyRibbon.vb de ou MyRibbon.cs abre no Designer da Faixa de Opções e exibe uma Guiaulação padrão e o AAgruparar.
No Designer de Faixa de Opções, clique em Grupo1.
Na janela Propriedades, defina Rótulo aGerente de painel de ações.
Na guia Controles da Faixa de Opções de Officede De caixa de ferramentas, arraste um botão para Grupo1.
Clique em botão1 para Selecionar-lo.
Na janela Propriedades, defina Rótulo para Mostrar 1 do painel de ações.
Adicionar um segundo botão para Grupo1e defina a propriedade do Rótulo como mostrar 2 do painel de ações.
Na guia Controles da Faixa de Opções de Office de De caixa de ferramentas, arraste um ToggleButton controle até Grupo1.
Defina a propriedade do Rótulo para ocultar o painel de ações.

Ocultar e Mostrar os painéis de ações usando botões na guia Personalizar

Último etapa é adicionar código que responde ao usuário.Adicionar manipuladores de eventos para os eventos de Click dos dois botões e o evento de Click do botão de Alternar.Adicionar código para esses manipuladores de eventos que ocultar e mostrar os painéis de ações.

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

Em Gerenciador de Soluções, clique com o botão direito do mouse MyRibbon.cs ou MyRibbon.vb e clique em Exibir Code.

Adicionar o código a seguir para a parte superior da classe MyRibbon.Esse código cria dois objetos de painel de ações.

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

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

Em C#, você deve adicionar os seguintes manipuladores de eventos para o construtor.Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos no Visual Studio Tools for Office.

this.button1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button1_Click);
this.button2.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button2_Click);
this.toggleButton1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.toggleButton1_Click);
this.Load += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs>
        (this.MyRibbon_Load);

Adicione o seguinte código para o evento MyRibbon_Load .Este código adiciona os objetos do painel de ações à coleção de Microsoft.Office.Tools.ActionsPane.Controls do painel de ações e oculta os objetos do Exibir.

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

Adicionar três métodos a seguir evento manipulador para a classe MyRibbon.Esses métodos manipular os eventos de Click dos dois botões e o evento de Click do botão de Alternar.Os manipuladores de eventos para botão1 e button2 mostram painéis de ações alternativas.O manipulador de eventos para toggleButton1 mostra e oculta o painel de ações Ativo.

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

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

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();

}

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

}

Teste a guia Personalizar

Quando você executar o projeto, o Excel inicia, O guia de De Adicionar-ins aparece na faixa de opções.Clique nos botões na Adicionar-ins para mostrar e ocultar os painéis de ações.

Para testar a guia Personalizar

Pressionarionar F5 para executar seu projeto.
Clique na guia de Adicionar-ins.
No AAgruparar de De Gerente de painel de ações Personalizars, 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.
Clique em 2 do painel de ações de Mostrar.

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

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

Próximas etapas

Você pode saber mais sobre como personalizar a INTERFACE do Office destes tópicos:

Adicionar Contextoual interface do usuário para qualquer personalização de nível de documento.For more information, see Visão geral painel Ações.
Estenda um formulário do Microsoft Office Outlook padrão ou Personalizar.For more information, see Demonstra Passo a passo: Criar uma região de formulário do Outlook.