Visão geral da 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.

O 2007 Microsoft Office Sistema introduziu um elemento de interface do usuário que é chamado a Faixa de Opções.Você pode usar Ferramentas do Visual Studio para o Office para personalizar a Faixa de Opções dos seguintes aplicativos:

Microsoft Office Excel 2007
Microsoft Office Outlook 2007
Microsoft Office o PowerPoint 2007
Microsoft Office Word 2007

Sobre a Faixa de Opções do Microsoft Office Sistema

A Faixa de Opções é uma maneira para organizar comandos relacionados para que eles são mais fáceis de localizar.Comandos Aparecerr como controles da Faixa de Opções.Controles são organizados em grupos ao longo de uma faixa horizontal na borda superior de uma janela de aplicativo.Grupos relacionados são organizados em guias.

Maioria dos recursos que foram acessados usando menus e barras de ferramentas nas versões anteriores do sistema Microsoft Office agora pode ser acessadas usando a faixa de opções.Para obter mais informações, consulte o artigo técnico Developer Overview of a interface de usuário para o 2007 Microsoft Office Sistema.

Personalizando o Microsoft Office Faixa de Opções

Para personalizar a Faixa de Opções, Adicionar uma faixa de opções seguinte itens para o projeto Ferramentas do Visual Studio para o Office:

Faixa de Opções (Visual Designer)
Faixa de Opções (XML)

Por exemplo, para personalizar a Faixa de Opções do Excel, Adicionar um item da Faixa de Opções para um Excel Adicionar no projeto.

Item de Faixa de Opções (Visual Designer)

O item de da Faixa de Opções (Designer Visual) fornece ferramentas Avançados que tornam mais fácil para você a projetar e desenvolver uma Faixa de Opções Personalizar.Use o item de De Faixa de Opções (Designer Visual) de para personalizar a Faixa de Opções das seguintes maneiras:

Adicionar Personalizars ou internas guias para uma faixa de opções.

Adicionar grupos Personalizars a uma guia Personalizar ou interna.

Observação:
Um guia interna ou o AAgruparar é aquele que já existe na faixa de opções de um aplicativo do Microsoft Office.Por exemplo, o Guia de de dados é uma tabulação interna no Excel.O AAgruparar de conexões é um AAgruparar interno na guia Dados.

Adicionar controles Personalizars a um AAgruparar Personalizar.
Adicionar controles Personalizars ao menu do Microsoft Office.

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

Item de Faixa de Opções (XML)

Use o item de De Faixa de Opções (XML) de se desejar personalizar a Faixa de Opções de uma forma que não há suporte para o item de da Faixa de Opções (Visual Designer).Use o item de De Faixa de Opções (XML) de para personalizar a Faixa de Opções das seguintes maneiras:

Adicionar Grupos de internos a uma guia Personalizar ou guia interna.
Adicionar controles internos para um AAgruparar Personalizar.
Adicionar código Personalizar para substituir os manipuladores de eventos de controles internos.
Personalizar a barra de ferramentas de Acessar rápido.
Compartilhar uma personalização da Faixa de opções entre Adicionar-ins, usando uma identificação de qualificado.

Para obter mais informações sobre como personalizar a Faixa de Opções usando o item de da 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 de Faixa de Opções e, em seguida, decidir que deseja personalizar a Faixa de Opções de maneiras que o item de da Faixa de Opções (Designer Visual) não oferece suporte, você pode exportar a Faixa de Opções para XML.

Ferramentas do Visual Studio para o Office automaticamente cria um item de da Faixa de Opções (XML) e preenche o arquivo XML da Faixa de Opções com elementos e atributos para cada Controlarar na Faixa de Opções.

Não Tudo as propriedades que são na janela de propriedades do designer da Faixa de Opções são transferidas para o arquivo XML da Faixa de Opções.Por exemplo, Ferramentas do Visual Studio para o Office não Exportara o valor do 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 Controlarar.Ferramentas do Visual Studio para o Office não gera automaticamente métodos de retorno de chamada como parte do processo de Exportarar.

Além disso, os valores de propriedade padrão inalterada não Aparecerr 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 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 a Gerenciador de Soluções.Este arquivo contém a classe de XML da Faixa de Opções.Você deve criar métodos de retorno de chamada na região Ribbon Callbacks dessa classe para manipular a ações do usuário, tal como clicar em um botão.Mover seu código dos manipuladores de eventos para esses métodos de retorno de chamada e modifique 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, ThisWorkbookou ThisDocument classe substitui o método CreateRibbonExtensibilityObject e retorna a classe de XML da Faixa de Opções para o aplicativo do Office.

For more information, see XML da Faixa de Opções.

Adicionar Múltiplo itens da Faixa de opções a um projeto

Você pode adicionar mais de um item da faixa de opções em um Simples projeto.Isso é útil se você quiser executar as duas tarefas a seguir:

Criar Faixas para Outlook Inspectors.

Observação:

Um Inspector é uma janela aberta quando os usuários executar determinadas tarefas, como a criação de uma mensagem de email.
Selecionar qual Faixa de Opções para exibir em tempo de execução.

Observação:
Um Inspector é uma janela aberta quando os usuários executar determinadas tarefas, como a criação de uma mensagem de email.

Criação de Faixas de Opções para inspetores do Outlook

O Outlook não Exibir a Faixa de Opções na janela principal do aplicativo.Em vez disso, o Outlook exibe a faixa de opções em um Inspector.Você pode adicionar uma faixa de opções para cada Inspector a um projeto de suplemento do Outlook.For more information, see Personalizando uma faixa de opções para Outlook.

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

Para selecionar uma faixa de opções para exibir em tempo de execução, Substituir o método CreateRibbonExtensibilityObject na ThisAddin, ThisWorkbookou ThisDocument classe de seu projeto e retornar 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 nesse exemplo retorna uma faixa de opções que foi criada usando o Faixa de Opções (Designer Visual) item.A sintaxe para retornar uma Faixa de Opções que é criada usando um item de da Faixa de Opções (XML) é um pouco diferente.Para obter mais informações sobre como retornar um item de da Faixa de Opções (XML), consulte XML da Faixa de Opções.

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