Comment : ajouter des commandes à des menus contextuels

Cette rubrique explique comment ajouter des commandes à un menu contextuel dans une application Office à l'aide d'un complément d'application.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Office 2013 et Office 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Pour ajouter des commandes des menus contextuels dans Office

1. Ajoutez un élément XML Ruban à un au niveau de le document ou à un projet au niveau de l'application.Pour plus d’informations, consultez Comment : démarrer avec la personnalisation du ruban.Dans

2. Explorateur de solutions, ThisAddin.cs activez ou ThisAddin.vb.

3. Dans la barre de menus, sélectionnez Affichage, Code.

   Le fichier de classe ThisAddin s'ouvre dans l'éditeur de code.

4. Ajoutez le code suivant à la classe ThisAddin :Ce code substitue la méthode CreateRibbonExtensibilityObject et retourne la classe Ribbon XML à l'application 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. Dans Explorateur de solutions, sélectionnez le fichier XML du Ruban.Par défaut, le fichier XML du Ruban est nommé Ribbon1.xml.

6. Dans la barre de menus, sélectionnez Affichage, Code.

   Le fichier XML du ruban s'ouvre dans l'éditeur de code.

7. Dans l'éditeur de code, ajoutez du code XML qui décrit le menu contextuel et le contrôle que vous souhaitez ajouter au menu contextuel.

   L'exemple suivant ajoute un bouton, un menu, et un contrôle de la galerie au menu contextuel d'un document word.L'ID du contrôle de ce menu contextuel est ContextMenuText.Pour une liste complète des ID de contrôle contextuel Office 2010, consultez Office 2010 fichiers d'aide suivantes : Identificateurs de contrôle d'interface utilisateur Office Fluent.

   <?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. Dans Explorateur de solutions, choisissez MyRibbon.cs ou MyRibbon.vb.

9. Ajoutez une méthode de rappel à la classe d' Ribbon1 pour chaque contrôle que vous souhaitez gérer.

   La méthode de rappel suivante gère le bouton mon bouton .Ce code ajoute une chaîne au document actif à l'emplacement actuel du 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.";
   }
   

Voir aussi

Tâches

Procédure pas à pas : création de menus contextuels pour les signets

Concepts

Paramètres optionnels dans les solutions Office

Autres ressources

Personnalisation de l'interface utilisateur Office

Personnalisation des menus contextuels dans Office 2010