Vue d’ensemble du rubanRibbon overview

Le ruban est une façon d’organiser les commandes associées afin qu’ils soient plus faciles à trouver.The ribbon is a way to organize related commands so that they are easier to find. Commandes apparaissent sous forme de contrôles sur le ruban.Commands appear as controls on the ribbon. Les contrôles sont organisés en groupes le long d’une bande horizontale sur le bord supérieur d’une fenêtre d’application.Controls are organized into groups along a horizontal strip at the top edge of an application window. Les groupes connexes sont organisés sur les onglets.Related groups are organized on tabs.

La plupart des fonctionnalités qui étaient accessibles à l’aide des menus et barres d’outils dans les versions antérieures de Microsoft Office system sont maintenant accessibles à l’aide du ruban.Most of the features that were accessed by using menus and toolbars in earlier versions of the Microsoft Office system can now be accessed by using the ribbon. Pour plus d’informations, consultez l’article technique vue du développeur de l’interface utilisateur pour Microsoft Office system 2007.For more information, see the technical article Developer overview of the user interface for the 2007 Microsoft Office system.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de compléments VSTO pour les applications suivantes : Excel, InfoPath 2013 et InfoPath 2010, Outlook, PowerPoint, Project, Visio, Word.Applies to: The information in this topic applies to document-level projects and VSTO add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Personnaliser le ruban Microsoft OfficeCustomize the Microsoft Office Ribbon

Pour personnaliser le ruban, ajoutez l’un des éléments suivants du ruban à votre projet Office :To customize the ribbon, add one of the following Ribbon items to your Office project:

  • Ruban (Concepteur visuel)Ribbon (Visual Designer)

  • Ruban (XML)Ribbon (XML)

    Par exemple, pour personnaliser le ruban Excel, ajoutez un élément Ruban à un projet de complément VSTO Excel.For example, to customize the Excel Ribbon, add a Ribbon item to an Excel VSTO Add-in project.

Élément Ruban (Concepteur visuel)Ribbon (Visual Designer) item

Le ruban (Concepteur visuel) élément fournit des outils avancés qui simplifient la conception et le développement d’un ruban personnalisé.The Ribbon (Visual Designer) item provides advanced tools that make it easier for you to design and develop a custom ribbon. Utilisez le ruban (Concepteur visuel) pour personnaliser le ruban comme suit :Use the Ribbon (Visual Designer) item to customize the ribbon in the following ways:

  • Ajouter des onglets personnalisés ou intégrés à un ruban.Add custom or built-in tabs to a ribbon.

  • Ajouter des groupes personnalisés à un onglet personnalisé ou intégré.Add custom groups to a custom or built-in tab.

    Note

    Un onglet intégré ou un groupe est celle qui existe déjà sur le ruban d’une application Microsoft Office.A built-in tab or group is one that already exists on the ribbon of a Microsoft Office application. Par exemple, le données onglet est un onglet intégré dans Excel.For example, the Data tab is a built-in tab in Excel. Le connexions groupe est un groupe intégré sur le données onglet.The Connections group is a built-in group on the Data tab.

  • Ajoutez des contrôles personnalisés à un groupe personnalisé.Add custom controls to a custom group.

  • Ajoutez des contrôles personnalisés au mode Backstage.Add custom controls to the Backstage View.

    Pour plus d’informations sur la façon de personnaliser un ruban à l’aide de la ruban (Concepteur visuel) d’élément, consultez Concepteur de ruban.For more information about how to customize a ribbon by using the Ribbon (Visual Designer) item, see Ribbon designer.

Élément Ruban (XML)Ribbon (XML) item

Utilisez le ruban (XML) élément si vous souhaitez personnaliser le ruban d’une façon qui n’est pas pris en charge par le ruban (Concepteur visuel) élément.Use the Ribbon (XML) item if you want to customize the ribbon in a way that is not supported by the Ribbon (Visual Designer) item. Utilisez le ruban (XML) pour personnaliser le ruban comme suit :Use the Ribbon (XML) item to customize the ribbon in the following ways:

  • Ajouter intégrés groupes à un onglet personnalisé ou un onglet intégré.Add built-in groups to a custom tab or built-in tab.

  • Ajoutez des contrôles intégrés à un groupe personnalisé.Add built-in controls to a custom group.

  • Ajoutez un code personnalisé pour substituer les gestionnaires d'événements des contrôles intégrés.Add custom code to override the event handlers of built-in controls.

  • Personnaliser la barre d'outils Accès rapideCustomize the Quick Access Toolbar.

  • Partager une personnalisation de ruban entre le complément VSTO en utilisant un ID qualifié.Share a Ribbon customization between VSTO Add-in by using a qualified ID.

    Pour plus d’informations sur la façon de personnaliser le ruban à l’aide de la ruban (XML) d’élément, consultez ruban XML.For more information about how to customize the ribbon by using the Ribbon (XML) item, see Ribbon XML.

Exporter un ruban à partir du Concepteur de ruban vers ruban XMLExport a ribbon from the Ribbon Designer to Ribbon XML

Si vous créez un ruban à l’aide du Concepteur de ruban et décidez ensuite que vous souhaitez personnaliser le ruban d’une façon qui le ruban (Concepteur visuel) élément ne prend pas en charge, vous pouvez exporter le ruban en XML.If you create a ribbon by using the Ribbon Designer, and then decide that you want to customize the ribbon in ways that the Ribbon (Visual Designer) item does not support, you can export the ribbon to XML.

Visual Studio crée automatiquement un ruban (XML) et remplit le fichier XML du ruban avec des éléments et attributs pour chaque contrôle sur le ruban.Visual Studio automatically creates a Ribbon (XML) item and populates the Ribbon XML file with elements and attributes for each control on the ribbon.

Pas toutes les propriétés qui se trouvent dans le propriétés fenêtre du Concepteur de ruban sont transférées vers le fichier XML du ruban.Not all of the properties that are in the Properties window of the Ribbon Designer are transferred to the Ribbon XML file. Par exemple, Visual Studio n’exporte pas la valeur de la Image ou texte propriété.For example, Visual Studio does not export the value of the Image or Text property. 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.That is because you must create a callback method in the Ribbon code file of the exported project to assign an image or set the text of a control. Visual Studio ne génère pas automatiquement les méthodes de rappel dans le cadre du processus d'exportation.Visual Studio does not automatically generate callback methods as part of the export process.

En outre, les valeurs de propriété par défaut inchangées n'apparaissent pas dans le fichier XML du ruban.In addition, any unchanged default property values do not appear in the resulting Ribbon XML file.

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 ruban XML.For more information about how to export the Ribbon to XML, see How to: Export a ribbon from the Ribbon Designer to Ribbon XML.

Mettre à jour le codeUpdate the code

Un nouveau fichier de code du ruban est ajouté à l’Explorateur de solutions.A new Ribbon code file is added to Solution Explorer. Ce fichier contient la classe Ribbon XML.This file contains the Ribbon XML class. 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.You must create callback methods in the Ribbon Callbacks region of this class to handle user actions, such as clicking a button. 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).Move your code from the event handlers to these callback methods and modify the code to work with the Ribbon extensibility (RibbonX) programming model. Pour plus d'informations, consultez Ribbon XML.For more information, see 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.You must also add code to the ThisAddIn, ThisWorkbook, or ThisDocument class that overrides the CreateRibbonExtensibilityObject method and returns the Ribbon XML class to the Office application.

Pour plus d'informations, consultez Ribbon XML.For more information, see Ribbon XML.

Ajouter plusieurs éléments de ruban à un projetAdd multiple Ribbon items to a project

Vous pouvez ajouter plusieurs éléments de ruban à un seul projet.You can add more than one Ribbon item to a single project. Cela est utile si vous souhaitez effectuer l’une des deux tâches suivantes :This is useful if you want to perform either of the following two tasks:

  • Créer des rubans pour Outlook inspecteurs.Create ribbons for Outlook Inspectors. Pour plus d’informations, consultez personnaliser un ruban pour Outlook.For more information, see Customize a ribbon for Outlook.

    Note

    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.An Inspector is a window that opens when users perform certain tasks, such as creating an e-mail message.

  • Sélectionnez le ruban à afficher lors de l’exécution.Select which ribbon to display at runtime.

Sélectionnez les rubans à afficher au moment de l’exécutionSelect which ribbons to display at runtime

Un projet peut contenir plusieurs rubans, vous pouvez sélectionner le ruban à afficher lors de l’exécution.Because a project can contain more than one ribbon, you can select which ribbon to display at runtime.

Pour sélectionner un ruban à afficher au moment de l’exécution, substituez le CreateRibbonExtensibilityObject méthode dans le ThisAddin, ThisWorkbook, ou ThisDocument classe de votre projet et retournez le ruban que vous souhaitez afficher.To select a ribbon to display at runtime, override the CreateRibbonExtensibilityObject method in the ThisAddin, ThisWorkbook, or ThisDocument class of your project and return the ribbon that you want to display. L’exemple suivant vérifie la valeur d’un champ nommé myCondition et retourne le ruban approprié.The following example checks the value of a field named myCondition and returns the appropriate ribbon.

Note

La syntaxe utilisée dans cet exemple retourne un ruban qui a été créé à l’aide de la ruban (Concepteur visuel) élément.The syntax used in this example returns a ribbon that was created by using the Ribbon (Visual Designer) item. La syntaxe de retour d’un ruban qui est créé en utilisant un ruban (XML) élément est légèrement différent.The syntax for returning a ribbon that is created by using a Ribbon (XML) item is slightly different. Pour plus d'informations sur le retour d'un élément Ruban (XML), consultez Ruban XML.For more information about returning a Ribbon (XML) item, see Ribbon XML.

Ajoutez le code suivant :Add the following code:

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() });
        }
    }
TitreTitle DescriptionDescription
Comment : démarrer avec la personnalisation du rubanHow to: Get started customizing the ribbon Montre comment personnaliser le ruban d’une application Microsoft Office, ajoutez un ruban (Concepteur visuel) ou ruban (XML) élément à un projet Office.Shows you how to customize the ribbon of a Microsoft Office application, add a Ribbon (Visual Designer) or Ribbon (XML) item to an Office project.
Concepteur de rubanRibbon designer Décrit comment vous pouvez utiliser le Concepteur de ruban pour ajouter des onglets personnalisés, des groupes et des contrôles au ruban d’une application Microsoft Office.Describes how you can use the Ribbon Designer to add custom tabs, groups, and controls to the ribbon of a Microsoft Office application.
Procédure pas à pas : Création d’un onglet personnalisé à l’aide du Concepteur de rubanWalkthrough: Create a custom tab by using the Ribbon Designer Montre comment créer un onglet de ruban personnalisé à l'aide du Concepteur de ruban.Shows you how to create a custom Ribbon tab by using the Ribbon Designer. Vous pouvez utiliser le Concepteur de ruban pour ajouter et positionner des contrôles sur l'onglet personnalisé.You can use the Ribbon Designer to add and position controls on the custom tab.
Présentation du modèle objet de rubanRibbon object model overview 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 de ruban au moment de l’exécution.Provides an overview of the strongly typed object model that you can use to get and set the properties of Ribbon controls at runtime.
Procédure pas à pas : Mise à jour les contrôles sur un ruban au moment de l’exécutionWalkthrough: Update the controls on a ribbon at runtime 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.Demonstrates how to use the Ribbon object model to update the controls on a ribbon after the ribbon is loaded into the Office application.
Personnaliser un ruban pour OutlookCustomize a ribbon for Outlook Fournit des conseils pour la personnalisation du ruban dans Microsoft Office Outlook.Provides guidance for customizing the ribbon in Microsoft Office Outlook.
Personnaliser un ruban pour InfoPathCustomize a ribbon for InfoPath Fournit des conseils pour la personnalisation du ruban dans Microsoft Office InfoPath.Provides guidance for customizing the ribbon in Microsoft Office InfoPath.
Accéder au ruban au moment de l’exécutionAccess the ribbon at runtime Montre comment afficher, masquer et modifier le ruban et permettre aux utilisateurs d’exécuter le code à partir de contrôles dans un volet de tâches personnalisé, un volet actions ou une zone de formulaire Outlook.Shows how to show, hide, and modify the ribbon, and enable users to run the code from controls in a custom task pane, actions pane, or Outlook form region.
Comment : modifier la position d’un onglet du rubanHow to: Change the position of a tab on the ribbon Montre comment modifier l’ordre des onglets sur un ruban.Shows how to change the order of tabs on a ribbon.
Comment : personnaliser un onglet intégréHow to: Customize a built-in tab Montre comment ajouter des groupes et des contrôles à un onglet intégré.Shows how to add groups and controls to a built-in tab.
Comment : ajouter des contrôles au mode BackstageHow to: Add controls to the Backstage View Montre comment ajouter des contrôles au menu qui s’ouvre lorsque vous cliquez sur le fichier.Shows how to add controls to the menu that opens when you click the File.
Comment : ajouter un lanceur de boîte de dialogue à un groupe de rubanHow to: Add a dialog box launcher to a Ribbon group Montre comment pour ajouter un lanceur de boîte de dialogue à un groupe sur un ruban.Shows to add a dialog box launcher to any group on a ribbon.
Comment : exporter un ruban à partir du Concepteur de ruban vers ruban XMLHow to: Export a ribbon from the Ribbon Designer to Ribbon XML Montre comment personnaliser le ruban de façon avancée en exportant le ruban à partir du concepteur vers ruban XML.Shows how to customize the ribbon in advanced ways by exporting the ribbon from the designer to Ribbon XML.
Élément XML RibbonRibbon XML Explique comment vous pouvez personnaliser un ruban à l’aide de XML du ruban.Explains how you can customize a ribbon by using Ribbon XML.
Procédure pas à pas : Création d’un onglet personnalisé à l’aide du Concepteur de rubanWalkthrough: Create a custom tab by using the Ribbon Designer Montre comment créer un onglet de ruban personnalisé à l’aide de la ruban (XML) élément.Demonstrates how to create a custom Ribbon tab by using the Ribbon (XML) item.