Partager via


Exporter un ruban du Concepteur de ruban vers le code XML du ruban

L’élément Ruban (Concepteur visuel) ne prend pas en charge tous les types possibles de personnalisation du ruban. Pour personnaliser le ruban de manière avancée, vous pouvez exporter le ruban du concepteur vers le code XML du ruban et modifier directement le code XML.

Remarque

Toutes les valeurs de propriété ne s’affichent pas dans le fichier XML du ruban. Pour plus d’informations, consultez vue d’ensemble du ruban.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO pour les applications suivantes : Excel ; InfoPath 2013 et InfoPath 2010 ; Outlook; Powerpoint; Projet; Visio; Mot. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Pour exporter un ruban du Concepteur de ruban vers le code XML du ruban

  1. Cliquez avec le bouton droit sur le fichier de code du ruban dans Explorateur de solutions, puis cliquez sur Concepteur de vues.

  2. Cliquez avec le bouton droit sur le Concepteur de ruban, puis cliquez sur Exporter le ruban au format XML.

    Visual Studio ajoute un fichier XML de ruban et un fichier de code XML du ruban à votre projet.

  3. Dans la classe de code du ruban, recherchez les commentaires qui commencent par TODO:.

  4. Copiez le bloc de code dans ces commentaires dans la classe ThisAddin, ThisWorkbook ou ThisDocument , selon le type de solution que vous développez.

    Ce code permet à Microsoft application Office lication de découvrir et de charger votre ruban personnalisé. Pour plus d'informations, consultez Ribbon XML.

  5. Dans la classe ThisAddin, ThisWorkbook ou ThisDocument , supprimez les marques de commentaire du bloc de code.

    Après avoir décompressé le code, il doit ressembler à l’exemple suivant. Dans cet exemple, la classe Ribbon est appelée MyRibbon.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
        return new MyRibbon();
    }
    
  6. Basculez vers le fichier de code XML du ruban et recherchez la Ribbon Callbacks région.

    C’est là que vous écrivez des méthodes de rappel pour gérer les actions utilisateur, telles que cliquer sur un bouton.

  7. Créez une méthode de rappel pour chaque gestionnaire d’événements que vous avez écrit dans le code du Concepteur de ruban.

  8. Déplacez tout le code de votre gestionnaire d’événements des gestionnaires d’événements vers les méthodes de rappel, puis modifiez le code pour qu’il fonctionne avec le modèle de programmation d’extensibilité du ruban (RibbonX).

    Pour plus d’informations sur l’écriture de méthodes de rappel et l’utilisation du modèle de programmation RibbonX, consultez le code XML du ruban.