Partager via

Comment : exporter un ruban à partir du Concepteur de ruban vers l'élément XML Ribbon

  • Article

L'élément Ruban (Concepteur visuel) ne prend pas en charge tous les types possibles de personnalisations du ruban. Pour effectuer une personnalisation avancée du ruban, vous pouvez exporter le ruban du concepteur vers l'élément XML Ribbon et modifier directement le XML.

Notes

Toutes les valeurs de propriété n'apparaissent 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 de niveau document et de niveau application pour les applications suivantes : Excel 2007, Excel 2010, InfoPath 2007, InfoPath 2010, Outlook 2007, Outlook 2010, PowerPoint 2007, PowerPoint 2010, Project 2010; Visio 2010, Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Pour exporter un ruban à partir du Concepteur de ruban vers l'élément XML Ribbon

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code du ruban, 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 de ruban à votre projet.

  3. Dans la classe de code du ruban, recherchez les commentaires commençant par TODO:.

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

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

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

    Une fois que vous avez supprimé les marques de commentaire du code, il doit ressembler à l'exemple suivant. Dans cet exemple, la classe du ruban est appelée MyRibbon.

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

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

  6. Basculez sur le fichier de code XML du ruban et recherchez la région Ribbon Callbacks.

    Elle permet d'écrire des méthodes de rappel pour gérer des actions de l'utilisateur, telles qu'un clic 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 l'ensemble de votre code de gestionnaire d'événements vers les méthodes de rappel et modifiez le code pour utiliser 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 Élément XML Ribbon.

Voir aussi

Tâches

Procédure pas à pas : création d'un onglet personnalisé à l'aide du Concepteur de ruban

Procédure pas à pas : création d'un onglet personnalisé à l'aide d'un élément XML Ribbon

Concepts

Concepteur de ruban

Élément XML Ribbon

Autres ressources

Vue d'ensemble du ruban

Historique des modifications

Date

Historique

Motif

Septembre 2010

Modification du nom de la classe Ribbon mentionné dans le contenu pour correspondre à celui de l'exemple de code.

Résolution des bogues de contenu.