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

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.

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 apparaissent dans des fenêtres spécifiques de l'Inspecteur Outlook.

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 Visual Studio Tools pour 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 de rubans dans 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";
}