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.

Adicione os códigos a seguir:

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

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