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

O item Faixa de Opções (Visual Designer) 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 editar o XML diretamente.

Observação

Nem todos os valores de propriedade aparecem no arquivo XML da Faixa de Opções. Para obter mais informações, consulte Visão geral da faixa de opções.

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.

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

1. Clique com o botão direito do mouse no arquivo de código da Faixa de Opções no Gerenciador de Soluções e clique em Exibir Designer.

2. Clique com o botão direito do mouse no Designer da Faixa de Opções e clique em Exportar Faixa de Opções para XML.

   O Visual Studio adiciona um arquivo XML da 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 com TODO:.

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

   Esse código permite que o aplicativo do Microsoft Office descubra e carregue sua faixa de opções personalizada. Para obter mais informações, consulte XML da faixa de opções.

5. Na classe ThisAddin, ThisWorkbook ou ThisDocument, remova o comentário do bloco de código.

   Depois de descomentar o código, ele deve ser semelhante ao exemplo a seguir. Neste exemplo, a classe Ribbon é chamada MyRibbon.

   C#

   protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
   {
       return new MyRibbon();
   }
   

   VB

   Protected Overrides Function CreateRibbonExtensibilityObject() As  _
   Microsoft.Office.Core.IRibbonExtensibility
       Return New MyRibbon()
   End Function
   

6. Alterne para o arquivo de código XML da Faixa de Opções e localize a Ribbon Callbacks região.

   É aqui que você escreve métodos de retorno de chamada para manipular ações do usuário, como clicar em um botão.

7. Crie um método de retorno de chamada para cada manipulador de eventos que você escreveu no código do Designer da Faixa de Opções.

8. Mova todo o código do manipulador de eventos dos manipuladores de eventos para os 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 informações sobre como escrever métodos de retorno de chamada e usar o modelo de programação RibbonX, consulte XML da Faixa de Opções.

Conteúdo relacionado

• Visão geral da faixa de opções
• Designer da faixa de opções
• XML da faixa de opções
• Demonstra Passo a passo: Criar uma guia personalizada usando o Designer da Faixa de Opções
• Demonstra Passo a passo: Criar uma guia personalizada usando XML da Faixa de Opções