Comment : exporter un ruban à partir du Concepteur de ruban vers ruban XMLHow to: Export a ribbon from the Ribbon Designer to Ribbon XML

Le ruban (Concepteur visuel) élément ne prend pas en charge tous les types possibles de personnalisation du ruban.The Ribbon (Visual Designer) item does not support all possible types of Ribbon customization. Pour personnaliser le ruban de façon avancée, vous pouvez exporter le ruban à partir du concepteur vers ruban XML et modifier directement le XML.To customize the ribbon in advanced ways, you can export the ribbon from the designer to Ribbon XML and edit the XML directly.

Note

Toutes les valeurs de propriété apparaissent dans le fichier XML du ruban.Not all property values appear in the Ribbon XML file. Pour plus d’informations, consultez vue d’ensemble du ruban.For more information, see Ribbon overview.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour les applications suivantes : Excel ; InfoPath 2013 et InfoPath 2010 ; Outlook ; PowerPoint ; Projet ; Visio ; Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Pour exporter un ruban à partir du Concepteur de ruban vers ruban XMLTo export a ribbon from the Ribbon Designer to Ribbon XML

  1. Cliquez sur le fichier de code de ruban dans l’Explorateur de solutions, puis cliquez sur Concepteur de vues.Right-click the Ribbon code file in Solution Explorer, and then click View Designer.

  2. Cliquez sur le Concepteur de ruban, puis cliquez sur exporter un ruban au format XML.Right-click the Ribbon Designer, and then click Export Ribbon to XML.

    Visual Studio ajoute un fichier XML du ruban et un fichier de code XML du ruban à votre projet.Visual Studio adds a Ribbon XML file and a Ribbon XML code file to your project.

  3. Dans la classe de code du ruban, recherchez les commentaires qui commencent par TODO:.In the Ribbon code class, locate the comments that start with TODO:.

  4. Copiez le bloc de code de ces commentaires à le ThisAddin, ThisWorkbook, ou ThisDocument classe, selon le type de solution que vous développez.Copy the code block in these comments to the ThisAddin, ThisWorkbook, or ThisDocument class, depending on which type of solution you are developing.

    Ce code permet à l’application Microsoft Office découvrir et charger votre ruban personnalisé.This code enables the Microsoft Office application to discover and load your custom ribbon. Pour plus d'informations, consultez Ribbon XML.For more information, see Ribbon XML.

  5. Dans le ThisAddin, ThisWorkbook, ou ThisDocument class, supprimez le bloc de code.In the ThisAddin, ThisWorkbook, or ThisDocument class, uncomment the code block.

    Une fois que vous les commentaires du code, elle doit ressembler à l’exemple suivant.After you uncomment the code, it should resemble the following example. Dans cet exemple, la classe du ruban est appelée MyRibbon.In this example, the Ribbon class is called MyRibbon.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
        return new MyRibbon();
    }
    
    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
        Return New MyRibbon()
    End Function
    
  6. Basculez vers le fichier de code XML du ruban et trouver le Ribbon Callbacks région.Switch to the Ribbon XML code file and find the Ribbon Callbacks region.

    Voici où vous écrivez des méthodes de rappel pour gérer les actions utilisateur, comme un clic sur un bouton.This is where you write callback methods to handle user actions, such as clicking a button.

  7. Créez une méthode de rappel pour chaque gestionnaire d’événements que vous avez écrite dans le code du Concepteur de ruban.Create a callback method for each event handler that you wrote in the Ribbon Designer code.

  8. Déplacez tout votre code de gestionnaire d’événements à partir des gestionnaires d’événements pour les méthodes de rappel et modifiez le code fonctionne avec l’extensibilité du ruban (RibbonX) modèle de programmation.Move all your event handler code from the event handlers to the callback methods, and modify the code to work with the Ribbon extensibility (RibbonX) programming model.

    Pour plus d’informations sur l’écriture de méthodes de rappel et de l’aide du modèle de programmation RibbonX, consultez ruban XML.For information about writing callback methods and using the RibbonX programming model, see Ribbon XML.

Voir aussiSee also

Vue d’ensemble du ruban Ribbon overview
Concepteur de ruban Ribbon Designer
Élément XML Ribbon Ribbon XML
Procédure pas à pas : Créer un onglet personnalisé à l’aide du Concepteur de ruban Walkthrough: Create a custom tab by using the Ribbon Designer
Procédure pas à pas : Créer un onglet personnalisé à l’aide de XML du rubanWalkthrough: Create a custom tab by using Ribbon XML