Vue d'ensemble du ruban

Article
08/10/2011

La version 2007 de Microsoft Office System a introduit un nouvel élément d'interface utilisateur appelé le ruban. Le ruban est une façon d'organiser les commandes associées afin de les retrouver plus facilement. 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 dans la partie supérieure d'une fenêtre d'application. Les groupes connexes sont organisés sur les onglets.

La plupart des fonctionnalités accessibles via les menus et les barres d'outils dans les versions précédentes de Microsoft Office System sont maintenant accessibles à l'aide du ruban. Pour plus d'informations, consultez l'article technique Vue d'ensemble du point de vue du développeur de l'interface utilisateur pour la version 2007 de Microsoft Office System (en anglais).

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.

Personnalisation du ruban Microsoft Office

Pour personnaliser le ruban, ajoutez l'un des éléments Ruban suivants à votre projet Office :

Ruban (Concepteur visuel)
Ruban (XML)

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

Élément Ruban (Concepteur visuel)

L'élément Ruban (Visual Concepteur) fournit des outils avancés qui vous permettent de concevoir et développer plus facilement un ruban personnalisé. Utilisez l'élément Ruban (Concepteur visuel) pour personnaliser le ruban comme suit :

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

Notes

Un onglet intégré ou un groupe prédéfini doit exister sur le ruban d'une application Microsoft Office. Par exemple, l'onglet Données est un onglet intégré dans Excel. Le groupe Connexions est un groupe prédéfini dans l'ongletDonnées.
Ajoutez des contrôles personnalisés à un groupe personnalisé.
Ajoutez des contrôles personnalisés au menu Microsoft Office.

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

Élément Ruban (XML)

Utilisez l'élément Ruban (XML) si vous souhaitez personnaliser le ruban de sorte que l'élément Ruban (Concepteur visuel) ne le prenne pas en charge. Utilisez l'élément Ruban (XML) pour personnaliser le ruban comme suit :

Ajoutez des groupes prédéfinis à un onglet personnalisé ou un onglet intégré.
Ajoutez des contrôles intégrés à un groupe personnalisé.
Ajoutez le code personnalisé pour substituer les gestionnaires d'événements de contrôles intégrés.
Personnalisez la barre d'outils Accès rapide.
Partagez une personnalisation de ruban entre des compléments en utilisant un ID qualifié.

Pour plus d'informations sur la personnalisation du ruban à l'aide de l'élément Ruban (XML), consultez Élément XML Ribbon.

Exportation d'un ruban du Concepteur de ruban vers l'élément Ruban XML

Si vous créez un ruban en utilisant le Concepteur de ruban, puis décidez de le personnaliser de sorte que l'élément Ruban (Concepteur visuel) ne le prenne pas en charge, vous pouvez exporter le ruban en XML.

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

Toutes les propriétés situées 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. C'est parce que vous devez créer une méthode de rappel dans le fichier de code de 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 de méthodes de rappel dans le cadre du processus d'exportation.

De plus, toutes les valeurs de propriété par défaut inchangées n'apparaissent pas dans le fichier XML de ruban résultant.

Pour plus d'informations sur la façon d'exporter le ruban en XML, consultez Comment : exporter un ruban à partir du Concepteur de ruban vers l'élément XML Ribbon.

Mise à jour du code

Un nouveau fichier de code de ruban est ajouté à l'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 des actions de l'utilisateur, telles qu'un clic sur un bouton. Déplacez votre code des gestionnaires d'événements vers ces méthodes de rappel et modifiez le code pour utiliser le modèle de programmation de l'extensibilité (RibbonX) du ruban. Pour plus d'informations, consultez Élément XML Ribbon.

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

Pour plus d'informations, consultez Élément XML Ribbon.

Ajout de plusieurs éléments Ruban à un projet

Vous pouvez ajouter plusieurs éléments Ruban à un même projet. Cela est utile si vous souhaitez exécuter l'une des deux tâches suivantes :

Créer des rubans pour les Inspecteurs Outlook. Pour plus d'informations, consultez Personnalisation d'un ruban pour Outlook.

Notes

Un Inspecteur est une fenêtre qui s'ouvre lorsque des utilisateurs effectuent certaines tâches, telles que la création d'un message électronique.
Sélectionner le ruban à afficher au moment de l'exécution.

Sélection des 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, substituez la méthode CreateRibbonExtensibilityObject dans la classe ThisAddin, ThisWorkbook ou ThisDocument de votre projet et retournez le ruban que vous souhaitez afficher. L'exemple suivant vérifie la valeur d'un champ nommé myCondition et retourne le ruban approprié.

Notes

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

Pour les projets qui ciblent .NET Framework 4, ajoutez le code suivant :

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        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()})
    End If
End Function

    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() });
        }
    }

Pour les projets qui ciblent .NET Framework 3.5, ajoutez le code suivant :

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                 {New Ribbon1()})
    Else
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon1() });
        }
        else
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon2() });
        }
    }

Rubriques connexes

Titre	Description
Comment : démarrer avec la personnalisation du ruban	Montre comment personnaliser le ruban d'une application Microsoft Office et ajouter un élément Ruban (Concepteur visuel) ou Ruban (XML) à un projet Office.
Concepteur de ruban	Explique comment utiliser le concepteur de ruban pour ajouter des onglets, des groupes et des contrôles personnalisés au ruban d'une application Microsoft Office.
Procédure pas à pas : création d'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 de ruban	Fournit une introduction au modèle objet fortement typé que vous pouvez utiliser pour obtenir et définir les propriétés de contrôles de ruban au moment de l'exécution.
Procédure pas à pas : mise à niveau des 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 sur un ruban après chargement du ruban dans l'application Office.
Personnalisation d'un ruban pour Outlook	Fournit de l'aide pour la personnalisation du ruban dans Microsoft Office Outlook.
Personnalisation d'un ruban pour InfoPath	Fournit de l'aide pour la personnalisation du ruban dans Microsoft Office InfoPath.
Accès au ruban au moment de l'exécution	Montre comment afficher, masquer et modifier le ruban et permettre aux utilisateurs d'exécuter du code à partir des contrôles dans un volet Office personnalisé, un volet Actions ou une zone de formulaire Outlook.
Comment : modifier la position d'un onglet dans le ruban	Indique comment modifier l'ordre des onglets dans un ruban.
Comment : personnaliser un onglet intégré	Indique comment ajouter des groupes et des contrôles à un onglet prédéfini.
Comment : personnaliser le menu Microsoft Office	Indique comment ajouter des contrôles au menu qui s'ouvre lorsque vous cliquez sur l'onglet Fichier (pour Office 2010) ou le bouton Microsoft Office (pour Office 2007).
Comment : ajouter un lanceur de boîte de dialogue à un groupe de ruban	Montre comment ajouter un lanceur de boîte de dialogue à n'importe quel groupe d'un ruban.
Comment : exporter un ruban à partir du Concepteur de ruban vers l'élément XML Ribbon	Indique comment personnaliser le ruban à l'aide d'options avancées en exportant le ruban depuis le concepteur vers l'élément Ribbon XML.
Élément XML Ribbon	Montre comment personnaliser un ruban à l'aide de l'élément Ribbon XML.
Procédure pas à pas : création d'un onglet personnalisé à l'aide du Concepteur de ruban	Montre comment créer un onglet de ruban personnalisé à l'aide de l'élément Ribbon (XML).

Partager via