Partager via

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

  • Article

Mise à jour : novembre 2007

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et aux versions de Microsoft Office spécifiés.

Type de projet

  • Projets au niveau du document

  • Projets au niveau de l'application

Version de Microsoft Office

  • Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

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.

Remarque :

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.

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 Tools pour Office ajoute un fichier XML du ruban et un fichier de code XML du 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 Ribbon1.

    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

Vue d'ensemble du ruban

Concepteur de ruban

Élément XML Ribbon