Vue d’ensemble du ruban

Le ruban est un moyen d’organiser les commandes associées afin qu’elles soient plus faciles à trouver. Les commandes apparaissent sous forme de contrôles sur le ruban. Les contrôles sont organisés en groupes le long d’une bande horizontale au bord supérieur d’une fenêtre d’application. Les groupes connexes sont organisés sur les onglets.

La plupart des fonctionnalités accessibles à l’aide de menus et de barres d’outils dans les versions antérieures du système Microsoft Bureau sont désormais accessibles à l’aide du ruban. Pour plus d’informations, consultez l’article technique Vue d’ensemble de l’interface utilisateur pour le système microsoft Bureau Microsoft 2007.

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.

Personnaliser le ruban Microsoft Bureau

Pour personnaliser le ruban, ajoutez l’un des éléments de ruban suivants à votre projet Bureau :

  • Ruban (Concepteur visuel)

  • Ruban (XML)

    Par exemple, pour personnaliser le ruban Excel, ajoutez un élément Ruban à un projet de complément VSTO Excel.

Élément Ruban (Concepteur visuel)

L’élément Ruban (Concepteur visuel) fournit des outils avancés qui facilitent la conception et le développement d’un ruban personnalisé. Utilisez l’élément Ruban (Concepteur visuel) pour personnaliser le ruban de la manière suivante :

  • Ajoutez des onglets personnalisés ou intégrés à un ruban.

  • Ajouter des groupes personnalisés à un onglet personnalisé ou intégré.

    Remarque

    Un onglet ou un groupe intégré existe déjà sur le ruban d’une application Office lication Microsoft. Par exemple, l’onglet Données est un onglet intégré dans Excel. Le groupe Connecter ions est un groupe intégré sous l’onglet Données.

  • Ajoutez des contrôles personnalisés à un groupe personnalisé.

  • Ajoutez des contrôles personnalisés au mode Backstage.

    Pour plus d’informations sur la personnalisation d’un ruban à l’aide de l’élément Ruban (Concepteur visuel), consultez le Concepteur de ruban.

Élément ruban (XML)

Utilisez l’élément Ruban (XML) si vous souhaitez personnaliser le ruban d’une manière qui n’est pas prise en charge par l’élément Ruban (Concepteur visuel). Utilisez l’élément Ruban (XML) pour personnaliser le ruban de la manière suivante :

  • Ajoutez des groupes intégrés à un onglet personnalisé ou un onglet intégré.

  • Ajoutez des contrôles intégrés à un groupe personnalisé.

  • Ajoutez un code personnalisé pour substituer les gestionnaires d'événements des contrôles intégrés.

  • Personnaliser la barre d'outils Accès rapide

  • Partager une personnalisation de ruban entre le complément VSTO en utilisant un ID qualifié.

    Pour plus d’informations sur la personnalisation du ruban à l’aide de l’élément Ruban (XML), consultez Le code XML du ruban.

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

Si vous créez un ruban à l’aide du Concepteur de ruban, puis décidez que vous souhaitez personnaliser le ruban de manière à ce que l’élément Ruban (Concepteur visuel) ne soit pas pris en charge, vous pouvez exporter le ruban en XML.

Visual Studio crée automatiquement un élément De ruban (XML) et remplit le fichier XML du ruban avec des éléments et des attributs pour chaque contrôle du ruban.

Toutes les propriétés qui se trouvent dans la fenêtre Propriétés du Concepteur de ruban ne sont pas transférées vers le fichier XML du ruban. Par exemple, Visual Studio n’exporte pas la valeur de la propriété Image ou Text . La raison en est que vous devez créer une méthode de rappel dans le fichier de code Ruban du projet exporté pour assigner une image ou définir le texte d'un contrôle. Visual Studio ne génère pas automatiquement les méthodes de rappel dans le cadre du processus d'exportation.

En outre, les valeurs de propriété par défaut inchangées n'apparaissent pas dans le fichier XML du ruban.

Pour plus d’informations sur l’exportation du ruban vers XML, consultez Guide pratique pour exporter un ruban du Concepteur de ruban vers le code XML du ruban.

Mettez à jour le code

Un nouveau fichier de code du ruban est ajouté à Explorateur de solutions. Ce fichier contient la classe Ribbon XML. Vous devez créer des méthodes de rappel dans la région Ribbon Callbacks de cette classe pour gérer les actions de l'utilisateur, telles qu'un clic sur un bouton. Déplacez votre code des gestionnaires d'événements vers les méthodes de rappel et modifiez le code pour qu'il fonctionne avec le modèle de programmation de l'extensibilité du ruban (RibbonX). Pour plus d'informations, consultez Ribbon XML.

Vous devez également ajouter le code à la classe ThisAddIn, ThisWorkbook ou ThisDocument qui remplace la méthode CreateRibbonExtensibilityObject et retourne la classe Ribbon XML à l'application Office.

Pour plus d'informations, consultez Ribbon XML.

Ajouter plusieurs éléments du ruban à un projet

Vous pouvez ajouter plusieurs éléments de ruban à un seul projet. Cela est utile si vous souhaitez effectuer l'une des deux tâches suivantes :

  • Créez des rubans pour les inspecteurs Outlook. Pour plus d’informations, consultez Personnaliser un ruban pour Outlook.

    Remarque

    Un inspecteur est une fenêtre qui s'ouvre lorsque les utilisateurs effectuent certaines tâches, telles que la création d'un message électronique.

  • Sélectionnez le ruban à afficher au moment de l’exécution.

Sélectionner les rubans à afficher au moment de l’exécution

Étant donné qu’un projet peut contenir plusieurs rubans, vous pouvez sélectionner le ruban à afficher au moment de l’exécution.

Pour sélectionner un ruban à afficher au moment de l’exécution, remplacez la méthode dans le ThisAddinou ThisWorkbookThisDocument la CreateRibbonExtensibilityObject classe de votre projet et retournez le ruban que vous souhaitez afficher. L’exemple suivant case activée la valeur d’un champ nommé myCondition et retourne le ruban approprié.

Remarque

La syntaxe utilisée dans cet exemple retourne un ruban créé à l’aide de l’élément Ruban (Concepteur visuel). La syntaxe de renvoi d’un ruban créé à l’aide d’un élément De ruban (XML) est légèrement différente. Pour plus d'informations sur le retour d'un élément Ruban (XML), consultez Ruban XML.

Ajoutez le code suivant :

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }
Intitulé Description
Guide pratique pour commencer à personnaliser le ruban Montre comment personnaliser le ruban d’une application Office lication Microsoft, ajouter un élément Ruban (Concepteur visuel) ou Ruban (XML) à un projet Bureau.
Concepteur de ruban Décrit comment utiliser le Concepteur de ruban pour ajouter des onglets, des groupes et des contrôles personnalisés au ruban d’une application Office lication Microsoft.
Procédure pas à pas : créer un onglet personnalisé à l’aide du Concepteur de ruban Montre comment créer un onglet de ruban personnalisé à l'aide du Concepteur de ruban. Vous pouvez utiliser le Concepteur de ruban pour ajouter et positionner des contrôles sur l'onglet personnalisé.
Vue d’ensemble du modèle objet du ruban Fournit une vue d’ensemble du modèle objet fortement typé que vous pouvez utiliser pour obtenir et définir les propriétés des contrôles du ruban au moment de l’exécution.
Procédure pas à pas : mettre à jour les contrôles sur un ruban au moment de l’exécution Montre comment utiliser le modèle objet de ruban pour mettre à jour les contrôles d’un ruban après le chargement du ruban dans l’application Office.
Personnaliser un ruban pour Outlook Fournit des conseils pour personnaliser le ruban dans Microsoft Bureau Outlook.
Personnaliser un ruban pour InfoPath Fournit des conseils pour personnaliser le ruban dans Microsoft Bureau InfoPath.
Accéder au ruban au moment de l’exécution Montre comment afficher, masquer et modifier le ruban et permettre aux utilisateurs d’exécuter le code à partir de contrôles dans un volet Office personnalisé, un volet Actions ou une zone de formulaire Outlook.
Guide pratique pour modifier la position d’un onglet sur le ruban Montre comment modifier l’ordre des onglets d’un ruban.
Guide pratique pour personnaliser un onglet intégré Montre comment ajouter des groupes et des contrôles à un onglet intégré.
Guide pratique pour ajouter des contrôles à l’affichage Backstage Montre comment ajouter des contrôles au menu qui s’ouvre lorsque vous cliquez sur le fichier.
Guide pratique pour ajouter un lanceur de boîte de dialogue à un groupe de rubans Affiche l’ajout d’un lanceur de boîtes de dialogue à n’importe quel groupe d’un ruban.
Guide pratique pour exporter un ruban à partir du Concepteur de ruban vers le code XML du ruban Montre comment personnaliser le ruban de manière avancée en exportant le ruban du concepteur vers le code XML du ruban.
Ribbon XML Explique comment personnaliser un ruban à l’aide du code XML du ruban.
Procédure pas à pas : créer un onglet personnalisé à l’aide du Concepteur de ruban Montre comment créer un onglet ruban personnalisé à l’aide de l’élément Ruban (XML).