Accès au ruban au moment de l'exécutionAccessing the Ribbon at Run Time

Vous pouvez écrire du code pour afficher, masquer et modifier le ruban, et permettre aux utilisateurs d’exécuter ce code à partir de contrôles dans un volet de tâches personnalisé, un volet Actions ou une zone de formulaire Outlook.You can write code 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.

Vous pouvez accéder au ruban à l'aide de la classe Globals.You can access the Ribbon by using the Globals class. Pour les projets Outlook, vous pouvez accéder au ruban qui s'affiche dans une fenêtre de l'explorateur ou de l'inspecteur Outlook spécifique.For Outlook projects, you can access the Ribbons that appear in a specific Outlook Inspector or Outlook Explorer window.

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.

Accès au ruban à l'aide de la classe GlobalsAccessing the Ribbon by Using the Globals Class

Vous pouvez utiliser la classe Globals pour accéder au ruban dans un projet au niveau du document ou un projet de complément VSTO, où que vous soyez dans le projet.You can use the Globals class to access the Ribbon in a document-level project or VSTO Add-in project from anywhere in the project.

Pour plus d’informations sur la Globals de classe, consultez accès Global aux objets dans les projets Office.For more information about the Globals class, see Global Access to Objects in Office Projects.

L'exemple suivant utilise la classe Globals pour accéder à un ruban personnalisé nommé Ribbon1 et définir le texte qui apparaît dans une zone de liste modifiable du ruban sur Hello World.The following example uses the Globals class to access a custom Ribbon named Ribbon1 and set the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Accès à une collection de rubans qui s’affichent dans une fenêtre d’inspecteur Outlook spécifiqueAccessing a Collection of Ribbons That Appear in a Specific Outlook Inspector Window

Vous pouvez accéder à une collection de rubans qui s’affichent dans Outlook inspecteurs.You can access a collection of Ribbons that appear in Outlook Inspectors. Un inspecteur est une fenêtre qui s’ouvre dans Outlook quand les utilisateurs effectuent certaines tâches, telles que la création d’un message électronique.An Inspector is a window that opens in Outlook when users perform certain tasks, such as creating e-mail messages. Pour accéder au ruban d'une fenêtre d'inspecteur, appelez la propriété Ribbons de la classe Globals et passez-lui un objet Microsoft.Office.Interop.Outlook.Inspector qui représente l'inspecteur.To access the Ribbon of an Inspector window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Inspector object that represents the Inspector.

L'exemple suivant obtient la collection de rubans de l'inspecteur actif.The following example gets the Ribbon collection of the Inspector that currently has focus. Cet exemple accède ensuite à un ruban nommé Ribbon1 et définit le texte qui s'affiche dans une zone de liste modifiable du ruban sur Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Accès à une collection de rubans qui s’affichent pour un explorateur Outlook spécifiqueAccessing a Collection of Ribbons That Appear for a Specific Outlook Explorer

Vous pouvez accéder à une collection de rubans qui s’affichent dans Outlook Explorer.You can access a collection of Ribbons that appear in an Outlook Explorer. Un explorateur est l'interface utilisateur principale de l'application pour une instance d'Outlook.An Explorer is the main application user interface (UI) for an instance of Outlook. Pour accéder au ruban d'une fenêtre d'explorateur, appelez la propriété Ribbons de la classe Globals et passez-lui un objet Microsoft.Office.Interop.Outlook.Explorer qui représente l'explorateur.To access the Ribbon of an Explorer window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Explorer object that represents the Explorer.

L'exemple suivant obtient la collection de rubans de l'explorateur actif.The following example gets the Ribbon collection of the Explorer that currently has focus. Cet exemple accède ensuite à un ruban nommé Ribbon1 et définit le texte qui s'affiche dans une zone de liste modifiable du ruban sur Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Voir aussiSee Also

Vue d’ensemble du ruban Ribbon Overview
Concepteur de ruban Ribbon Designer
Élément XML Ribbon Ribbon XML
Présentation du modèle objet de ruban Ribbon Object Model Overview
Procédure pas à pas : Création d’un onglet personnalisé à l’aide du Concepteur de ruban Walkthrough: Creating a Custom Tab by Using the Ribbon Designer
Procédure pas à pas : Mise à jour les contrôles sur un ruban au moment de l’exécution Walkthrough: Updating the Controls on a Ribbon at Run Time
Personnalisation d’un ruban pour Outlook Customizing a Ribbon for Outlook
Accès à une zone de formulaire au moment de l’exécutionAccessing a Form Region at Run Time