Como: adicionar comandos aos Menus de atalho

Este tópico demonstra como adicionar comandos para um menu de atalho em um aplicativo do Office usando um suplemento ao aplicativo.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para adicionar comandos de menu de atalho no Office

1. Adicionar um item de fita XML a um projeto de um documento ou nível de aplicativo.Para obter mais informações, consulte Como: começar a personalizar a faixa de opções..Em

2. Gerenciador de Soluções, ThisAddin.cs selecione ou ThisAddin.vb.

3. Em a barra de menu, escolha Modo de Visualização, Código.

   O arquivo de classe ThisAddin abre na editor de códigos.

4. Adicione o seguinte código à classe de ThisAddin .Esse código substitui o método de CreateRibbonExtensibilityObject e retorna a classe XML de fita para o aplicativo do Office.

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

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

5. Em Gerenciador de Soluções, selecione o arquivo XML e fita.Por padrão, o arquivo XML e fita é chamado Ribbon1.xml.

6. Em a barra de menu, escolha Modo de Visualização, Código.

   O arquivo XML de fita abre na editor de códigos.

7. Em o editor de códigos, adicione XML que descreve o menu de atalho e o controle que você deseja adicionar ao menu de atalho.

   O exemplo a seguir adiciona um botão, um menu, e um controle de galeria o menu de atalho para um documento do word.A identificação de O controle do menu de atalho é ContextMenuText.Para obter uma lista completa de identificação 2010 do controle de atalho do Office, consulte Office 2010 arquivos da ajuda: Identificadores de controle fluentes de interface de usuário do Office.

   <?xml version="1.0" encoding="UTF-8"?>
   <customUI xmlns="https://schemas.microsoft.com/office/2009/07/customui">
     <contextMenus>
       <contextMenu idMso="ContextMenuText">
         <button id="MyButton" label="My Button" insertBeforeMso="HyperlinkInsert" onAction="GetButtonID" />
         <menu id="MySubMenu" label="My Submenu" >
           <button id="MyButton2" label="Button on submenu" />
         </menu>
         <gallery id="galleryOne" label="My Gallery">
           <item id="item1" imageMso="HappyFace" />
           <item id="item2" imageMso="HappyFace" />
           <item id="item3" imageMso="HappyFace" />
           <item id="item4" imageMso="HappyFace" />
         </gallery>
       </contextMenu>
     </contextMenus>
   </customUI>
   

8. Em Gerenciador de Soluções, escolha MyRibbon.cs ou MyRibbon.vb.

9. Adicione um método callback para a classe de Ribbon1 para cada controle que você deseja manipular.

   O seguinte método callback trata o botão de meu botão .Este código adiciona uma cadeia de caracteres ao documento ativo no local atual de curser.

   Public Sub GetButtonID(ByVal control As Office.IRibbonControl)
       Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
       currentRange.Text = "This text was added by the context menu named My Button."
   End Sub
   

   public void GetButtonID(Office.IRibbonControl control)
   {
       Microsoft.Office.Interop.Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
       currentRange.Text = "This text was added by the context menu named My Button.";
   }
   

Consulte também

Tarefas

Passo a passo: Criando Menus de atalho para indicadores

Conceitos

Parâmetros opcionais em soluções do Office

Outros recursos

Personalização de interface do usuário do Office

Personalizando menus de contexto no Office 2010