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

O a faixa de opções (Visual Designer) item não oferece suporte a todos os tipos possíveis de personalização da faixa de opções. Para personalizar a faixa de opções de maneiras avançadas, você pode exportar a faixa de opções do designer para o XML da faixa de opções e edite o XML diretamente.

ObservaçãoObservação

Not all property values appear in the Ribbon XML file. For more information, see Visão geral da faixa de opções.

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.

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

  1. O arquivo de código na faixa de opções com o botão direito Solution Explorere em seguida, clique em View Designer.

  2. Clique com o botão direito no Designer de faixa de opções e clique em Exportar a faixa de opções para XML.

    Visual Studio adiciona um arquivo XML de faixa de opções e um arquivo de código XML da faixa de opções ao seu projeto.

  3. Na classe de código da faixa de opções, localize os comentários que começam comTODO:.

  4. Copie o bloco de código esses comentários para o ThisAddin, ThisWorkbook, ou ThisDocument de classe, dependendo de qual tipo de solução que você está desenvolvendo.

    Esse código permite que o aplicativo de Microsoft Office descobrir e carregar sua faixa de opções personalizada. For more information, see XML da faixa de opções.

  5. No ThisAddin, ThisWorkbook, ou ThisDocument da classe, descomente o bloco de código.

    Após você sem comentar o código, deve se parecer com o exemplo a seguir. Neste exemplo, a classe de faixa de opções é chamada MyRibbon.

    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
        Return New MyRibbon()
    End Function
    
    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
        return new MyRibbon();
    }
    
  6. Alterne para o arquivo XML de faixa de opções de código e encontrar o Ribbon Callbacks região.

    Isso é onde você escrever métodos de retorno de chamada para lidar com ações do usuário, como, por exemplo, clicando em um botão.

  7. Crie um método de retorno de chamada para cada manipulador de eventos que você escreveu o código do Designer de faixa de opções.

  8. Mover todo o código de manipulador de evento de manipuladores de eventos para os 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.

    Para obter informações sobre métodos de retorno de chamada de escrita e usando o modelo de programação do RibbonX, consulte XML da faixa de opções.

Consulte também

Tarefas

Demonstra Passo a passo: Criando uma guia personalizada usando o designer de faixa de opções

Demonstra Passo a passo: A criação de uma guia personalizado usando o XML da faixa de opções

Conceitos

Designer de faixa de opções

XML da faixa de opções

Outros recursos

Visão geral da faixa de opções

Histórico de alterações

Date

History

Motivo

Setembro de 2010

Alterado o nome da classe de faixa de opções mencionado no texto para coincidir com o exemplo de código.

Correção de bug de conteúdo.