Partager via


Accéder au ruban au moment de l’exécution

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.

Vous pouvez accéder au ruban à l'aide de la classe Globals. 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.

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.

Accéder au ruban à l’aide de la classe Globals

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.

Pour plus d’informations sur la Globals classe, consultez l’accès global aux objets dans Bureau projets.

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.

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

Accéder à une collection de rubans qui s’affichent dans une fenêtre d’inspecteur Outlook spécifique

Vous pouvez accéder à une collection de rubans qui s’affichent dans les inspecteurs Outlook. 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. 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 Inspector qui représente l'inspecteur.

L’exemple suivant obtient la collection de rubans de l’inspecteur actif. 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.

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Accéder à une collection de rubans qui s’affichent pour un Explorateur Outlook spécifique

Vous pouvez accéder à une collection de rubans qui s’affichent dans un Explorateur Outlook. Un explorateur est l'interface utilisateur principale de l'application pour une instance d'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 Explorer qui représente l'explorateur.

L'exemple suivant obtient la collection de rubans de l'explorateur actif. 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.

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}