Visão geral da faixa de opções

O sistema de Microsoft Office de 2007 introduziu um elemento de interface (UI) do usuário que é chamado de faixa de opções. A faixa de opções é uma forma de organizar os comandos relacionados para que fiquem mais fáceis de localizar. Os comandos aparecem como controles da faixa de opções. Controles são organizados em grupos ao longo de uma faixa horizontal na borda superior da janela do aplicativo. Grupos relacionados são organizados em guias.

A maioria dos recursos que foram acessados por meio de menus e barras de ferramentas em versões anteriores do sistema 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 de 2007 Microsoft Office.

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

Personalizando a faixa de opções de Microsoft Office

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

• A faixa de opções (Visual Designer)

• A faixa de opções (XML)

Por exemplo, para personalizar a faixa de opções do Excel, adicione um item de faixa de opções para um projeto de suplemento do Excel.

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

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

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

• Adicione grupos personalizados a uma guia interna ou personalizada.

  Observação
  Um guia interna ou o grupo é um que já exista na faixa de um aplicativo de Microsoft Office. Por exemplo, o dados guia está uma guia interna no Excel. O conexões grupo é um grupo interno sobre o dados guia.

• Adicione controles personalizados para um grupo personalizado.

• Adicione controles personalizados para o menu de Microsoft Office.

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

Item de faixa de opções (XML)

Use o Da faixa de opções (XML) item se você quiser personalizar a faixa de opções de modo que não é suportado pelo a faixa de opções (Visual Designer) item. Use o Da faixa de opções (XML) item para personalizar a faixa de opções das seguintes maneiras:

• Adicionar interno grupos para uma guia interno ou personalizada.

• Adicione controles internos para um grupo personalizado.

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

• Personalize a barra de ferramentas de acesso rápido.

• Compartilhar uma personalização da faixa de opções entre suplementos usando uma identificação de qualificado.

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

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

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

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

Nem todas as propriedades que estão na Propriedades janela do designer de faixa de opções são transferidos para o arquivo XML de faixa de opções. Por exemplo, Visual Studio não exporta o valor de imagem ou texto propriedade. 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 gerar automaticamente métodos de retorno de chamada como parte do processo de exportação.

Além disso, quaisquer valores de propriedade padrão inalterado não aparecem no arquivo XML de 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 de faixa de opções para o XML da faixa de opções.

Atualizando o código

Um novo arquivo de código da faixa de opções é adicionado ao Solution Explorer. Este arquivo contém a classe XML da faixa de opções. Você deve criar métodos de retorno de chamada a Ribbon Callbacks região desta classe para manipular as ações do usuário, como clicar um botão. Mover o seu código de manipuladores de eventos para esses métodos de retorno de chamada e modificar o código para trabalhar com a extensibilidade da faixa de opções (RibbonX) modelo de programação. For more information, see XML da faixa de opções.

Você também deve adicionar código para o ThisAddIn, ThisWorkbook, ou ThisDocument classe substitui o CreateRibbonExtensibilityObject método e retorna o XML da faixa de opções de classe para o aplicativo do Office.

For more information, see XML da faixa de opções.

Adicionando vários itens da faixa de opções em um projeto

Você pode adicionar mais de um item de faixa de opções para um único projeto. Isso é útil se você deseja realizar uma das seguintes tarefas:

• Criar faixas de opções para o Outlook Inspectors. For more information, see Personalização para Outlook.

  Observação
  Um inspetor é uma janela aberta quando os usuários a realizar determinadas tarefas, como, por exemplo, criando uma mensagem de email.

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

Selecionar qual Ribbons para exibição 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 para exibir em tempo de execução.

Para selecionar uma faixa de opções para exibir em tempo de execução, substituir o CreateRibbonExtensibilityObject método na ThisAddin, ThisWorkbook, ou ThisDocument a classe de seu projeto e o retorno da faixa de opções que você deseja exibir. O exemplo a seguir verifica o valor de um campo denominado myCondition e retorna a faixa de opções apropriadas.

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

Para projetos destinados a .NET Framework 4, adicione o seguinte código:

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

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

Para projetos destinados a.NET Framework 3.5, adicione o seguinte código:

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

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon1() });
        }
        else
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon2() });
        }
    }

Related Topics