Comment : ajouter un volet Actions à des documents Word ou à des classeurs Excel

Article
03/04/2013

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

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

[!REMARQUE]

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 Paramètres Visual Studio.

Création du contrôle utilisateur

La procédure suivante indique comment créer le contrôle utilisateur dans un projet Word ou Excel.Elle ajoute également un bouton au contrôle utilisateur qui écrit le texte au document ou au classeur lorsqu'un utilisateur clique dessus.

Pour créer le contrôle utilisateur

Ouvrez votre projet au niveau de le document Word ou 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.

[!REMARQUE]

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 sur le contrôle.

[!REMARQUE]

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

Ajoutez le code au gestionnaire d'événements d' Click du bouton.L'exemple suivant montre le code pour un document Microsoft Office Word.

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

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

En C#, vous devez ajouter un gestionnaire d'événements pour le clic de bouton.Vous pouvez placer ce code dans le constructeur HelloControl, après l'appel à IntializeComponent.

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 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é d' Controls du champ d' ThisDocument.ActionsPane (Word) ou du champ d' ThisWorkbook.ActionsPane (Excel).

Pour ajouter le contrôle utilisateur au volet Actions

Ajoutez le code suivant à la classe d' ThisDocument ou d' 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 d' ThisDocument_Startup de la classe d' ThisDocument ou au gestionnaire d'événements d' ThisWorkbook_Startup de la classe d' ThisWorkbook .
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```