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 2007, Excel 2010, InfoPath 2007, InfoPath 2010, Outlook 2007, Outlook 2010, PowerPoint 2007, PowerPoint 2010, Project 2010; Visio 2010, Word 2007 et Word 2010. Pour en savoir plus, 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
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