Visão geral da faixa de opções

A faixa de opções é uma maneira de organizar comandos relacionados para que eles sejam mais fáceis de encontrar. Os comandos aparecem como controles na faixa de opções. Os controles são organizados em grupos ao longo de uma faixa horizontal na borda superior de uma janela do aplicativo. Os grupos relacionados são organizados em guias.

A maioria dos recursos que eram acessados usando menus e barras de ferramentas em versões anteriores do Microsoft Office System agora podem ser acessados usando a faixa de opções. Para obter mais informações, consulte o artigo técnico Visão geral do desenvolvedor da interface do usuário para o 2007 Microsoft Office System.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para os seguintes aplicativos: Excel; InfoPath 2013 e InfoPath 2010; Perspectiva; PowerPoint; Projeto; Visio; Palavra. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Personalizar a Faixa de Opções do Microsoft Office

Para personalizar a faixa de opções, adicione um dos seguintes itens da Faixa de Opções ao seu projeto do Office:

• Faixa de Opções (Visual Designer)

• Faixa de opções (XML)

  Por exemplo, para personalizar a Faixa de Opções do Excel, adicione um item da Faixa de Opções a um projeto de Suplemento VSTO do Excel.

Item da faixa de opções (Visual Designer)

O item Faixa de Opções (Visual Designer) fornece ferramentas avançadas que facilitam o design e o desenvolvimento de uma faixa de opções personalizada. Use o item Faixa de Opções (Visual Designer) para personalizar a faixa de opções das seguintes maneiras:

• Adicione guias personalizadas ou internas a uma faixa de opções.

• Adicione grupos personalizados a uma guia personalizada ou interna.

  Observação

  Uma guia ou grupo interno é aquele que já existe na faixa de opções de um aplicativo do Microsoft Office. Por exemplo, a guia Dados é uma guia interna no Excel. O grupo Conexões é um grupo interno na guia Dados.

• Adicionar controles personalizados a um grupo personalizado.

• Adicione controles personalizados ao Modo de Exibição Backstage.

  Para obter mais informações sobre como personalizar uma faixa de opções usando o item Faixa de Opções (Visual Designer), consulte Designer da faixa de opções.

Item da faixa de opções (XML)

Use o item Faixa de Opções (XML) se desejar personalizar a faixa de opções de uma maneira que não seja suportada pelo item Faixa de Opções (Visual Designer ). Use o item Faixa de Opções (XML) para personalizar a faixa de opções das seguintes maneiras:

• Adicione grupos internos a uma guia personalizada ou a uma guia interna.

• Adicione controles internos a um grupo personalizado.

• Adicione código personalizado para substituir os manipuladores de eventos de controles internos.

• Personalize a Barra de Ferramentas de Acesso Rápido.

• Compartilhe uma personalização da Faixa de Opções entre o Suplemento VSTO usando uma ID qualificada.

  Para obter mais informações sobre como personalizar a faixa de opções usando o item Faixa de Opções (XML), consulte XML da Faixa de Opções.

Exportar uma faixa de opções do Designer da Faixa de Opções para o XML da Faixa de Opções

Se você criar uma faixa de opções usando o Designer da Faixa de Opções e decidir que deseja personalizar a faixa de opções de maneiras que o item da Faixa de Opções (Visual Designer) não oferece suporte, poderá exportar a faixa de opções para XML.

O Visual Studio cria automaticamente um item da Faixa de Opções (XML) e preenche o arquivo XML da Faixa de Opções com elementos e atributos para cada controle na faixa de opções.

Nem todas as propriedades que estão na janela Propriedades do Designer da Faixa de Opções são transferidas para o arquivo XML da Faixa de Opções. Por exemplo, o Visual Studio não exporta o valor da propriedade Image ou Text . Isso ocorre porque você deve criar um método de retorno de chamada no arquivo de código da faixa de opções do projeto exportado para atribuir uma imagem ou definir o texto de um controle. Visual Studio não gera automaticamente métodos de retorno de chamada como parte do processo de exportação.

Além disso, quaisquer valores de propriedade padrão inalterados não aparecem no arquivo XML da Faixa de Opções resultante.

Para obter mais informações sobre como exportar a Faixa de Opções para XML, consulte Como exportar uma faixa de opções do Designer da Faixa de Opções para o XML da Faixa de Opções.

Atualizar o código

Um novo arquivo de código da Faixa de Opções é adicionado ao Gerenciador de Soluções. Esse arquivo contém a classe XML da Faixa de Opções. Você deve criar métodos de retorno de chamada na região dessa classe para manipular ações do usuário, como clicar em Ribbon Callbacks um botão. Mova seu código dos manipuladores de eventos para esses métodos de retorno de chamada e modifique o código para trabalhar com o modelo de programação de extensibilidade da Faixa de Opções (RibbonX). Para obter mais informações, consulte XML da faixa de opções.

Você também deve adicionar código à ThisAddInclasse , ThisWorkbookou ThisDocument que substitui o método e retorna a classe XML da Faixa de Opções para o CreateRibbonExtensibilityObject aplicativo do Office.

Para obter mais informações, consulte XML da faixa de opções.

Adicionar vários itens da Faixa de Opções a um projeto

Você pode adicionar mais de um item da Faixa de Opções a um único projeto. Isso é útil se você quiser executar uma das duas tarefas a seguir:

• Criar faixas de opções para Inspetores do Outlook. Para obter mais informações, consulte Personalizar uma faixa de opções para o Outlook.

  Observação

  Um Inspetor é uma janela que se abre quando os usuários executam determinadas tarefas, como a criação de uma mensagem de email.

• Selecione a faixa de opções a ser exibida em tempo de execução.

Selecionar as faixas de opções a serem exibidas em tempo de execução

Como um projeto pode conter mais de uma faixa de opções, você pode selecionar a faixa de opções a ser exibida em tempo de execução.

Para selecionar uma faixa de opções a ser exibida em tempo de execução, substitua o CreateRibbonExtensibilityObject método na ThisAddinclasse , ThisWorkbookou ThisDocument do seu projeto e retorne a faixa de opções que você deseja exibir. O exemplo a seguir verifica o valor de um campo chamado myCondition e retorna a faixa de opções apropriada.

Observação

A sintaxe usada neste exemplo retorna uma faixa de opções que foi criada usando o item Faixa de Opções (Visual Designer ). A sintaxe para retornar uma faixa de opções criada usando um item da Faixa de Opções (XML) é ligeiramente diferente. Para obter mais informações sobre como retornar um item da Faixa de Opções (XML), consulte XML da Faixa de Opções.

Adicione os códigos a seguir:

C#

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

VB

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

Tópicos relacionados

Título	Descrição
Como: Começar a personalizar a faixa de opções	Mostra como personalizar a faixa de opções de um aplicativo do Microsoft Office, adicionar um item da Faixa de Opções (Visual Designer) ou da Faixa de Opções (XML) a um projeto do Office.
Designer de faixa de opções	Descreve como você pode usar o Designer da Faixa de Opções para adicionar guias, grupos e controles personalizados à faixa de opções de um aplicativo do Microsoft Office.
Demonstra Passo a passo: Criar uma guia personalizada usando o Designer da Faixa de Opções	Mostra como criar uma guia personalizada da Faixa de Opções usando o Designer da Faixa de Opções. Você pode usar o Designer da Faixa de Opções para adicionar e posicionar controles na guia personalizada.
Visão geral do modelo de objeto da faixa de opções	Fornece uma visão geral do modelo de objeto fortemente tipado que você pode usar para obter e definir as propriedades dos controles da Faixa de Opções em tempo de execução.
Demonstra Passo a passo: atualizar os controles em uma faixa de opções em tempo de execução	Demonstra como usar o modelo de objeto da Faixa de Opções para atualizar os controles em uma faixa de opções depois que a faixa de opções é carregada no aplicativo do Office.
Personalizar uma faixa de opções para o Outlook	Fornece orientação para personalizar a faixa de opções no Microsoft Office Outlook.
Personalizar uma faixa de opções para o InfoPath	Fornece orientação para personalizar a faixa de opções no Microsoft Office InfoPath.
Acessar a faixa de opções em tempo de execução	Mostra como mostrar, ocultar e modificar a faixa de opções e permitir que os usuários executem o código de controles em um painel de tarefas personalizado, painel de ações ou região de formulário do Outlook.
Como alterar a posição de uma guia na faixa de opções	Mostra como alterar a ordem das guias em uma faixa de opções.
Como: Personalizar uma guia interna	Mostra como adicionar grupos e controles a uma guia interna.
Como adicionar controles ao modo de exibição Backstage	Mostra como adicionar controles ao menu que é aberto quando você clica no arquivo.
Como adicionar um iniciador de caixa de diálogo a um grupo da Faixa de Opções	Mostra para adicionar um iniciador de caixa de diálogo a qualquer grupo em uma faixa de opções.
Como exportar uma faixa de opções do Designer da Faixa de Opções para o XML da Faixa de Opções	Mostra como personalizar a faixa de opções de maneiras avançadas exportando a faixa de opções do designer para o XML da Faixa de Opções.
XML da faixa de opções	Explica como você pode personalizar uma faixa de opções usando o XML da Faixa de Opções.
Demonstra Passo a passo: Criar uma guia personalizada usando o Designer da Faixa de Opções	Demonstra como criar uma guia personalizada da Faixa de Opções usando o item Faixa de Opções (XML).