Vue d'ensemble du ruban

Article
04/28/2010

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.

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.

La version 2007 de Microsoft Office System a introduit un nouvel élément d'interface utilisateur appelé le ruban. Vous pouvez utiliser Visual Studio Tools pour Office pour personnaliser le ruban des applications suivantes :

Microsoft Office Excel 2007
Microsoft Office Outlook 2007
Microsoft Office PowerPoint 2007
Microsoft Office Word 2007

À propos du ruban Microsoft Office System

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).

Personnalisation du ruban Microsoft Office

Pour personnaliser le ruban, ajoutez l'un des éléments Ruban suivants à votre projet Visual Studio Tools pour 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é.

Remarque :
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 Tools pour Office 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 Tools pour Office n'exporte pas la valeur de la propriété Image ou Text. En effet, 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 Tools pour Office 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.

Remarque :

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.

Remarque :
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.

Création de rubans pour les Inspecteurs Outlook

Outlook 2007 n'affiche pas le ruban dans la fenêtre d'application principale, mais dans un Inspecteur. Vous pouvez ajouter un ruban pour chaque Inspecteur à un projet de complément Outlook. Pour plus d'informations, consultez Personnalisation d'un ruban pour Outlook.

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é.

Remarque :
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.

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