Comment : ajouter un volet Actions à des documents Word

Article
08/10/2011

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

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Word 2007 et Word 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.

Création du contrôle utilisateur

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

Pour créer le contrôle utilisateur

Ouvrez votre document Word ou votre projet de modèle 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 sur 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.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é Controls du champ ThisDocument.ActionsPane.

Pour ajouter le contrôle utilisateur au volet Actions

Ajoutez le code suivant à la classe ThisDocument 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 ThisDocument_Startup de la classe ThisDocument.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```