Přidání příkazů do místních nabídek

Toto téma ukazuje, jak přidat příkazy do místní nabídky v aplikace Office lication pomocí doplňku VSTO.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO. Viz Funkce dostupné podle typu aplikace Office lication a projektu.

Přidání příkazů do místních nabídek v Office

1. Přidání položky XML pásu karet do projektu doplňku dokumentu nebo doplňku VSTO Další informace najdete v tématu Postupy: Začínáme s přizpůsobením pásu karet. V

2. Průzkumník řešení vyberte ThisAddin.cs nebo ThisAddin.vb.

3. Na řádku nabídek zvolte Zobrazit>kód.

   Soubor třídy ThisAddin se otevře v Editoru kódu.

4. Do třídy ThisAddin přidejte následující kód. Tento kód přepíše metodu CreateRibbonExtensibilityObject a vrátí třídu XML pásu karet do aplikace Office lication.

   C#

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

   VB

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

5. V Průzkumník řešení vyberte soubor XML pásu karet. Ve výchozím nastavení má soubor XML pásu karet název Ribbon1.xml.

6. Na řádku nabídek zvolte Zobrazit>kód.

   Soubor XML pásu karet se otevře v Editoru kódu.

7. V Editoru kódu přidejte KÓD, který popisuje místní nabídku a ovládací prvek, který chcete přidat do místní nabídky.

   Následující příklad přidá do místní nabídky wordového dokumentu tlačítko, nabídku a ovládací prvek galerie. ID ovládacího prvku této místní nabídky je ContextMenuText. Úplný seznam ID klávesového ovládacího prvku Office 2010 najdete v souborech nápovědy k Office 2010: Identifikátory ovládacích prvků uživatelského rozhraní fluent pro Office.

   <?xml version="1.0" encoding="UTF-8"?>
   <customUI xmlns="http://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. V Průzkumník řešení zvolte MyRibbon.cs nebo MyRibbon.vb.

9. Přidejte metodu zpětného Ribbon1 volání do třídy pro každý ovládací prvek, který chcete zpracovat.

   Následující metoda zpětného volání zpracovává tlačítko Moje tlačítko . Tento kód přidá řetězec do aktivního dokumentu v aktuálním umístění kurzoru.

   C#

   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.";
   }
   

   VB

   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
   

Související obsah

• Přizpůsobení uživatelského rozhraní Office
• Návod: Vytváření místních nabídek pro záložky
• Volitelné parametry v řešeních Office
• Přizpůsobení kontextových nabídek v Office 2010