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

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.

Cette procédure pas à pas montre comment créer un onglet du ruban personnalisé en utilisant le Concepteur de ruban. Vous pouvez utiliser le Concepteur de ruban pour ajouter et positionner des contrôles sur l'onglet personnalisé.

Cette procédure pas à pas illustre les tâches suivantes :

Création de volets Actions.
Création d'un onglet personnalisé.
Masquage et affichage de volets Actions à l'aide de boutons de l'onglet personnalisé.

Remarque :
Votre ordinateur risque d'afficher des noms ou des emplacements différents pour certains éléments de l'interface utilisateur Visual Studio dans les instructions suivantes. Ces éléments sont déterminés par votre édition de Visual Studio et les paramètres que vous utilisez. Pour plus d'informations, consultez Paramètres Visual Studio.

Composants requis

Vous avez besoin des composants suivants pour exécuter cette procédure pas à pas :

Visual Studio Tools pour Office (composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System)
Microsoft Office Excel 2007.

Visual Studio Tools pour Office est installé par défaut avec les versions répertoriées de Visual Studio. Pour vérifier s'il est installé, consultez Installation de Visual Studio Tools pour Office.

Pour une présentation vidéo, consultez la page Video How to: Creating a Custom Tab by Using the Ribbon Designer (Vidéo : création d'un onglet personnalisé à l'aide du Concepteur de ruban).

Création d'un projet de classeur Excel

Les étapes pour utiliser le Concepteur de ruban sont presque identiques pour toutes les applications Office. Cet exemple utilise un classeur Excel.

Pour créer un projet de classeur Excel

Créez un projet de classeur Excel 2007 et attribuez-lui le nom MonBoutonExcel. Pour plus d'informations, consultez Comment : créer des projets Visual Studio Tools pour Office.

Visual Studio ouvre le nouveau classeur dans le concepteur et ajoute le projet MonBoutonExcel à l'Explorateur de solutions.

Création de volets Actions

Ajoutez deux volets Actions personnalisés au projet. Vous ajouterez ultérieurement des boutons à l'onglet personnalisé pour afficher et masquer ces volets Actions.

Pour créer des volets Actions

Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez ActionsPaneControl, puis cliquez sur Ajouter.

Le fichier ActionsPaneControl1.cs ou ActionsPaneControl1.vb s'ouvre dans le concepteur.
Dans l'onglet Contrôles communs de la Boîte à outils, ajoutez une étiquette à l'aire du Concepteur.
Dans la fenêtre Propriétés, affectez à la propriété Text de label1 la valeur Volet Actions 1.
Répétez les étapes 1 à 5 pour créer un deuxième volet Actions et une deuxième étiquette. Affectez à la propriété Text de la deuxième étiquette la valeur volet Actions 2.

Création d'un onglet personnalisé

L'une des règles de conception d'une application Office stipule que les utilisateurs doivent toujours avoir le contrôle de l'interface utilisateur de l'application Office. Pour ajouter cette fonction pour les volets Actions, vous pouvez ajouter des boutons qui affichent et masquent chaque volet Actions à partir d'un onglet personnalisé sur le ruban. Pour créer un onglet personnalisé, ajoutez un élément Ruban (Concepteur visuel) au projet. Le concepteur vous permet d'ajouter et de position des contrôles, de définir les propriétés des contrôles et de gérer les événements de contrôle.

Pour créer un onglet personnalisé

Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Ruban (Concepteur visuel).
Remplacez le nom du nouveau ruban par MyRibbon, puis cliquez sur Ajouter.

Le fichier MyRibbon.cs ou MyRibbon.vb s'ouvre dans le Concepteur de ruban et affiche un onglet et un groupe par défaut.
Dans le Concepteur de ruban, cliquez sur group1.
Dans la fenêtre Propriétés, affectez à Étiquette la valeur Gestionnaire de volets Actions.
Dans l'onglet Contrôles de ruban Office de la Boîte à outils, faites glisser un bouton sur group1.
Cliquez sur button1 pour le sélectionner.
Dans la fenêtre Propriétés, affectez à Étiquette la valeur Afficher volet Actions 1.
Ajoutez un deuxième bouton à group1 et affectez à la propriété Étiquette la valeur Afficher volet Actions 2.
Dans l'onglet Contrôles de ruban Office de la Boîte à outils, faites glisser un contrôle ToggleButton sur group1.
Affectez à la propriété Étiquette la valeur Masquer volet Actions.

Masquage et affichage de volets Actions à l'aide de boutons sur l'onglet personnalisé

La dernière étape consiste à ajouter le code qui répond à l'utilisateur. Ajoutez les gestionnaires d'événements pour les événements Click des deux boutons et l'événement Click du bouton bascule. Ajoutez le code aux gestionnaires d'événements qui masquent et affichent les volets Actions.

Pour masquer et afficher des volets Actions à l'aide de boutons dans l'onglet personnalisé

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur MyRibbon.cs ou MyRibbon.vb et cliquez sur Afficher le code.

Ajoutez le code suivant en haut de la classe MyRibbon. Ce code crée deux objets du volet Actions.

Dim actionsPane1 As New ActionsPaneControl1()
Dim actionsPane2 As New ActionsPaneControl2()

ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

En C#, vous devez ajouter les gestionnaires d'événements suivants au constructeur. Pour plus d'informations sur la création de gestionnaires d'événements, consultez Comment : créer des gestionnaires d'événements dans Visual Studio Tools pour Office.

this.button1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button1_Click);
this.button2.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button2_Click);
this.toggleButton1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.toggleButton1_Click);
this.Load += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs>
        (this.MyRibbon_Load);

Ajoutez le code suivant à l'événement MyRibbon_Load. Ce code ajoute les objets de volet Actions à la collection de volets Actions Microsoft.Office.Tools.ActionsPane.Controls et masque les objets de la vue.

Private Sub MyRibbon_Load(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) _
        Handles MyBase.Load

    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
    actionsPane1.Hide()
    actionsPane2.Hide()
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
End Sub

private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
}

Ajoutez les trois méthodes de gestionnaire d'événements suivantes à la classe MyRibbon. Ces méthodes gèrent les événements Click des deux boutons et l'événement Click du bouton bascule. Les gestionnaires d'événements pour button1 et button2 affichent d'autres volets Actions. Le gestionnaire d'événements pour toggleButton1 affiche et masque le volet Actions actif.

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button1.Click
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane2.Hide()
    actionsPane1.Show()
End Sub

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button2.Click

    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane1.Hide()
    actionsPane2.Show()

End Sub


Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles ToggleButton1.Click

    If ToggleButton1.Checked Then
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
    Else
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    End If

End Sub

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

Test de l'onglet personnalisé

Lorsque vous exécutez le projet, Excel démarre. L'onglet Compléments apparaît sur le ruban. Cliquez sur les boutons de Compléments pour afficher et masquer les volets Actions.

Pour tester l'onglet personnalisé

Appuyez sur F5 pour exécuter votre projet.
Cliquez sur l'onglet Compléments.
Dans le groupe Custom Actions Pane Manager, cliquez sur Afficher volet Actions 1.

Le volet Actions apparaît et affiche l'étiquette Volet Actions 1.
Cliquez sur Afficher volet Actions 2.

Le volet Actions apparaît et affiche l'étiquette Volet Actions 2.
Cliquez sur Masquer volet Actions.

Les volets Actions ne sont plus visibles.

Étapes suivantes

Pour plus d'informations sur la personnalisation de l'interface utilisateur d'Office, consultez les rubriques suivantes :

Ajouter une interface utilisateur contextuelle à une personnalisation au niveau du document. Pour plus d'informations, consultez Vue d'ensemble du volet Actions.
Étendre un formulaire Microsoft Office standard ou personnalisé. Pour plus d'informations, consultez Procédure pas à pas : conception d'une zone de formulaire Outlook.