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 foram acessados usando menus e barras de ferramentas em versões anteriores do sistema do Microsoft Office agora pode ser acessada 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 sistema do Microsoft Office 2007.

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; Outlook; PowerPoint; Project; Visio; Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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

• 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 de Ribbon (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 integradas a uma faixa de opções.

• Adicione grupos personalizados a uma aba personalizada ou padrão.

  Observação

  Uma guia ou grupo incorporado é aquele que já está presente 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 .

• Adicione 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 (Designer Visual), consulte o designer da Faixa de Opções.

Item da faixa de opções (XML)

Use o item Ribbon (XML) se quiser personalizar a Ribbon de uma maneira que não tenha suporte no item Ribbon (Designer Visual). Use o item faixa de opções (XML) para personalizar a faixa de opções das seguintes maneiras:

• Adicione grupos pré-definidos a uma guia personalizada ou guia padrão.

• 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 Suplementos VSTO usando um ID qualificado.

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

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 Ribbon (Visual Designer) não dá suporte, você pode exportar a faixa de opções para XML.

O Visual Studio cria automaticamente um item de 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. O 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 o Ribbon para XML, consulte Como exportar um Ribbon do Designer do Ribbon para o XML do Ribbon.

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 Ribbon Callbacks desta classe para lidar com ações do usuário, como clicar em um botão. Mova o código dos manipuladores de eventos para esses métodos de retorno de chamada e modifique o código para funcionar com o modelo de programação RibbonX (extensibilidade da Faixa de Opções). Para obter mais informações, consulte Ribbon XML.

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

Para obter mais informações, consulte Ribbon XML.

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:

• Crie 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 é aberta quando os usuários executam determinadas tarefas, como a criação de uma mensagem de email.

• Selecione qual faixa de opções exibir em tempo de execução.

Selecione quais barras de ferramentas exibir em tempo de execução

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

Para selecionar uma faixa de opções para exibir em tempo de execução, substitua o método CreateRibbonExtensibilityObject na classe ThisAddin, ThisWorkbook ou 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 nomeado myCondition e retorna a faixa de opções apropriada.

Adicione o seguinte código:

    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