Partager via


Accès au ruban au moment de l'exécution

Vous pouvez écrire du code pour afficher, masquer et modifier le ruban et permettre aux utilisateurs de l'exécuter à partir des contrôles dans un volet Office 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 aux rubans qui s'affichent 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 de niveau document et de niveau application pour les applications suivantes : Excel 2013 et Excel 2010 ; InfoPath 2013 et InfoPath 2010 ; Outlook 2013 et Outlook 2010 ; PowerPoint 2013 et PowerPoint 2010 ; Project 2013 et Project 2010 ; Visio 2013 et Visio 2010 ; Word 2013 et Word 2010. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Accès au ruban en utilisant la classe Globals

Vous pouvez utiliser la classe Globals pour accéder au ruban d'un projet au niveau du document ou au niveau de l'application à partir de n'importe quel endroit du projet.

Pour plus d'informations sur la classe Globals, consultez Accès global aux objets dans les projets Office.

L'exemple suivant utilise la classe Globals pour accéder à un ruban personnalisé nommé Ribbon1 et définir le texte qui apparaît sur une zone de liste déroulante du ruban sur 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 des rubans s'affichant dans une fenêtre spécifique de l'inspecteur Outlook

Vous pouvez accéder à une collection de rubans qui apparaissent dans les Inspecteurs Outlook.Un Inspecteur est une fenêtre qui s'ouvre dans Outlook lorsque les utilisateurs effectuent certaines tâches, telles que la création d'un message électronique.Pour accéder au ruban d'une fenêtre Inspecteur, appelez la propriété Ribbons de la classe Globals et passez dans un objet Inspector qui représente l'Inspecteur.

L'exemple suivant obtient la collection du ruban de l'Inspecteur qui a actuellement le focus.Cet exemple accède ensuite à un ruban nommé Ribbon1 et définit le texte qui apparaît sur une zone de liste déroulante du ruban sur 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 s'affichant dans une fenêtre spécifique de l'explorateur Outlook

Vous pouvez accéder à une collection des rubans qui s'affichent dans un explorateur Outlook.Un explorateur est l'interface utilisateur d'application principale d'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 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 apparaît sur une zone de liste déroulante du ruban sur 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 aussi

Tâches

Procédure pas à pas : création d'un onglet personnalisé à l'aide du Concepteur de ruban

Procédure pas à pas : mise à niveau des contrôles sur un ruban au moment de l'exécution

Concepts

Concepteur de ruban

Élément XML Ribbon

Vue d'ensemble du modèle objet de ruban

Personnalisation d'un ruban pour Outlook

Accès à une zone de formulaire au moment de l'exécution

Autres ressources

Vue d'ensemble du ruban