Comment : ajouter un volet Actions à des classeurs Excel

Article
08/10/2011

Pour ajouter un volet Actions à un classeur Microsoft Office Excel, créez d'abord un contrôle utilisateur Windows Forms. Puis, ajoutez le contrôle utilisateur à la propriété Controls du champ ThisWorkbook.ActionsPane dans votre projet.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Excel 2007 et Excel 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez. Pour plus d'informations, consultez Utilisation des paramètres.

lien vers la vidéo Pour une démonstration vidéo connexe, consultez Comment faire pour utiliser des contrôles WPF à l'intérieur d'un Volet Actions Excel ? (page éventuellement en anglais).

Création du contrôle utilisateur

La procédure suivante indique comment créer un contrôle utilisateur dans un projet Excel. Elle ajoute également un bouton au contrôle utilisateur qui écrit le texte dans une cellule de feuille de calcul lorsque l'utilisateur clique dessus.

Pour créer le contrôle utilisateur

Ouvrez votre classeur ou projet de modèle Excel dans Visual Studio.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Contrôle de volet Actions, attribuez-lui le nom HelloControl et cliquez sur Ajouter.

Notes

Vous pouvez ajouter un élément Contrôle utilisateur à votre projet. Les classes générées par les éléments Contrôle de volet Actions et Contrôle utilisateur sont équivalentes d'un point de vue fonctionnel.
À partir de l'onglet Windows Forms de la Boîte à outils, faites glisser un contrôle Button vers le contrôle.

Notes

Si le contrôle n'est pas visible dans le concepteur, double-cliquez sur HelloControl dans l'Explorateur de solutions.

Ajoutez le code suivant au gestionnaire d'événements Click du bouton.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.Sheet1.Range("A1").Value2 = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.Sheet1.Range["A1", System.Type.Missing].Value2 = "Hello World!";
}

En C#, vous devez créer un gestionnaire d'événements pour Button. Vous pouvez placer ce code dans le constructeur HelloControl. Pour plus d'informations sur la création de gestionnaires d'événements, consultez Comment : créer des gestionnaires d'événements dans les projets Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

Ajout du contrôle utilisateur au volet Actions

Pour afficher le volet Actions, ajoutez le contrôle utilisateur à la propriété Controls du champ ThisWorkbook.ActionsPane.

Pour ajouter le contrôle utilisateur au volet Actions

Ajoutez le code suivant à la classe ThisWorkbook comme déclaration au niveau de la classe (n'ajoutez pas ce code à une méthode).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Ajoutez le code suivant au gestionnaire d'événements ThisWorkbook_Startup de la classe ThisWorkbook.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```